From dbaf5dc8b5ab0af4d93ec0d70ca70f72ab0d76ca Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 23 Aug 2016 16:45:43 +0000 Subject: beamerswitch git-svn-id: svn://tug.org/texlive/trunk@41914 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/beamerswitch/Makefile | 50 +++++++++++++ Master/texmf-dist/doc/latex/beamerswitch/README.md | 82 +++++++++++++++++++++ .../beamerswitch/beamerswitch-example-article.pdf | Bin 0 -> 19460 bytes .../beamerswitch/beamerswitch-example-handout.pdf | Bin 0 -> 21672 bytes .../beamerswitch/beamerswitch-example-trans.pdf | Bin 0 -> 22284 bytes .../latex/beamerswitch/beamerswitch-example.pdf | Bin 0 -> 35774 bytes .../latex/beamerswitch/beamerswitch-example.tex | 82 +++++++++++++++++++++ .../doc/latex/beamerswitch/beamerswitch.pdf | Bin 0 -> 146131 bytes 8 files changed, 214 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/Makefile create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/README.md create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-article.pdf create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-handout.pdf create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-trans.pdf create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.pdf create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.tex create mode 100644 Master/texmf-dist/doc/latex/beamerswitch/beamerswitch.pdf (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/beamerswitch/Makefile b/Master/texmf-dist/doc/latex/beamerswitch/Makefile new file mode 100644 index 00000000000..533b127c14f --- /dev/null +++ b/Master/texmf-dist/doc/latex/beamerswitch/Makefile @@ -0,0 +1,50 @@ +NAME = beamerswitch +SHELL = bash +PWD = $(shell pwd) +TEMP := $(shell mktemp -d -t tmp.XXXXXXXXXX) +TDIR = $(TEMP)/$(NAME) +VERS = $(shell ltxfileinfo -v $(NAME).dtx) +LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL) +UTREE = $(shell kpsewhich --var-value TEXMFHOME) + +.PHONY: clean distclean inst install uninst uninstall zip ctan + +all: $(NAME).pdf $(NAME)-example.pdf clean + @exit 0 +$(NAME).cls $(NAME)-example.tex: $(NAME).dtx + lualatex -synctex=1 -shell-escape -interaction=batchmode $(NAME).dtx >/dev/null +$(NAME).pdf: $(NAME).dtx + latexmk -silent -lualatex -synctex=1 -shell-escape -interaction=batchmode $(NAME).dtx >/dev/null +$(NAME)-example.pdf $(NAME)-example-trans.pdf $(NAME)-example-handout.pdf $(NAME)-example-article.pdf: $(NAME).cls $(NAME)-example.tex + latexmk -silent -lualatex -synctex=1 -shell-escape -interaction=batchmode $(NAME)-example.tex >/dev/null +clean: + rm -f $(NAME){,-example,-example-article,-example-handout,-example-trans}.{aux,bbl,bcf,blg,doc,fdb_latexmk,fls,glo,gls,hd,idx,ilg,ind,listing,log,nav,out,run.xml,snm,synctex.gz,tcbtemp,toc,vrb} + rm -rf _minted-$(NAME) +distclean: clean + rm -f $(NAME).{pdf,ins,cls} $(NAME)-example.{tex,pdf} $(NAME)-example-{article,handout,trans}.pdf +inst: all + mkdir -p $(UTREE)/{tex,source,doc}/latex/$(NAME) + cp $(NAME).dtx $(NAME).ins $(UTREE)/source/latex/$(NAME) + cp $(NAME).cls $(UTREE)/tex/latex/$(NAME) + cp $(NAME).pdf $(NAME)-example.{tex,pdf} $(NAME)-example-trans.pdf $(NAME)-example-handout.pdf $(NAME)-example-article.pdf README.md $(UTREE)/doc/latex/$(NAME) + mktexlsr +uninst: + rm -r $(UTREE)/{tex,source,doc}/latex/$(NAME) + mktexlsr +install: all + sudo mkdir -p $(LOCAL)/{tex,source,doc}/latex/$(NAME) + sudo cp $(NAME).dtx $(NAME).ins $(LOCAL)/source/latex/$(NAME) + sudo cp $(NAME).cls $(LOCAL)/tex/latex/$(NAME) + sudo cp $(NAME).pdf $(NAME)-example.pdf $(NAME)-example-trans.pdf $(NAME)-example-handout.pdf $(NAME)-example-article.pdf README.md $(LOCAL)/doc/latex/$(NAME) + mktexlsr +uninstall: + sudo rm -r $(LOCAL)/{tex,source,doc}/latex/$(NAME) + mktexlsr +zip: all + mkdir $(TDIR) + cp $(NAME).{pdf,dtx} $(NAME)-example.{tex,pdf} $(NAME)-example-trans.pdf $(NAME)-example-handout.pdf $(NAME)-example-article.pdf $(NAME).cls README.md Makefile $(TDIR) + cd $(TEMP); zip -Drq $(PWD)/$(NAME)-$(VERS).zip $(NAME) +ctan: all + mkdir $(TDIR) + cp $(NAME).{pdf,dtx} $(NAME)-example.pdf $(NAME)-example-trans.pdf $(NAME)-example-handout.pdf $(NAME)-example-article.pdf README.md Makefile $(TDIR) + cd $(TEMP); zip -Drq $(PWD)/$(NAME)-$(VERS).zip $(NAME) diff --git a/Master/texmf-dist/doc/latex/beamerswitch/README.md b/Master/texmf-dist/doc/latex/beamerswitch/README.md new file mode 100644 index 00000000000..b39c964a8e7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/beamerswitch/README.md @@ -0,0 +1,82 @@ +# beamerswitch: Convenient mode selection in Beamer documents + +This class is a wrapper around the `beamer` class to make it easier to use the +same document to generate the different forms of the presentation: the slides +themselves, an abbreviated slide set for transparencies or online reference, +an n-up handout version, and a transcript or set of notes using the `article` +class. + +## Installation + +### Dependencies + +To compile the documentation you will need to have the `minted` package working, +which in turn relies on Python 2.6+ and Pygments. See the documentation of that +package for details. + +There is an example file that demonstrates the features of the class. +The class itself depends only on packages easily available through TeX +distributions and CTAN. One feature relies on `latexmk` though you can work +around that if you have the patience. + +Note that the zip file on the [Releases] page on GitHub contains all the files +you need, pre-compiled. + +[Releases]: https://github.com/alex-ball/beamerswitch/releases + +### Automated way + +A makefile is provided which you can use with the Make utility: + + * Running `make` generates the class file and documentation. + * Running `make inst` installs the files to your home TeX tree. + * Running `make install` installs the files to the local TeX tree. + * Running `make uninst` uninstalls the files to your home TeX tree. + * Running `make uninstall` uninstalls the files to the local TeX tree. + +### Manual way + +To install the class from scratch, follow these instructions. If you have +downloaded the zip file from the [Releases] page on GitHub, you can skip the +first two steps. + + 1. Process `beamerswitch.dtx` with your favourite version of LaTeX with shell + escape enabled (as required by `minted` for typesetting the listings). You + will also need to run it through `makeindex`. This will generate the class + file and the main documentation (DVI or PDF), plus an example file + `beamerswitch-example.tex`. + + 2. Process `beamerswitch-example.tex` with your favourite version of LaTeX. If + you enable shell escape and have `latexmk` installed you will end up with + another four documents (DVI or PDF). Otherwise you will get one. + + 3. To install the files, create the following folders in your chosen TeX tree + and copy the files across as shown (read `.pdf` as `.dvi` if that is what + you generated): + + * `source/latex/beamerswitch`: + `beamerswitch.dtx`, + (`beamerswitch.ins`) + * `tex/latex/beamerswitch`: + `beamerswitch.cls` + * `doc/latex/beamerswitch`: + `beamerswitch.pdf`, + `beamerswitch-example.tex`, + `beamerswitch-example.pdf`, + `beamerswitch-example-article.pdf`, + `beamerswitch-example-handout.pdf`, + `beamerswitch-example-trans.pdf` + +## Licence + +Copyright 2016 Alex Ball. + +This work consists of the file beamerswitch.dtx and a Makefile. + +This work may be distributed and/or modified under the conditions of the +[LaTeX Project Public License (LPPL)](http://www.latex-project.org/lppl.txt), +either version 1.3c of this license or (at your option) any later version. + +This work is "maintained" (as per LPPL maintenance status) by +[Alex Ball](http://alexball.me.uk/). + diff --git a/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-article.pdf b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-article.pdf new file mode 100644 index 00000000000..f71c227da88 Binary files /dev/null and b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-article.pdf differ diff --git a/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-handout.pdf b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-handout.pdf new file mode 100644 index 00000000000..88a721e7f2c Binary files /dev/null and b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-handout.pdf differ diff --git a/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-trans.pdf b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-trans.pdf new file mode 100644 index 00000000000..8c44105c572 Binary files /dev/null and b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-trans.pdf differ diff --git a/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.pdf b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.pdf new file mode 100644 index 00000000000..59c3fb2621c Binary files /dev/null and b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.pdf differ diff --git a/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.tex b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.tex new file mode 100644 index 00000000000..f1dfc37a9c0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.tex @@ -0,0 +1,82 @@ +%% +%% This is file `beamerswitch-example.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% beamerswitch.dtx (with options: `example') +%% ---------------------------------------------------------------- +%% beamerswitch --- Convenient mode selection in Beamer documents +%% Author: Alex Ball +%% E-mail: a.j.ball@bath.ac.uk +%% License: Released under the LaTeX Project Public License v1.3c or later +%% See: http://www.latex-project.org/lppl.txt +%% ---------------------------------------------------------------- +%% +\PassOptionsToClass{a4paper,12pt}{article} +\PassOptionsToClass{14pt}{beamer} +\documentclass[also={trans,handout,article}]{beamerswitch} +\handoutlayout{nup=3plus,border=1pt} +\articlelayout{maketitle,frametitles=none} +\usepackage[british]{babel} +\mode
{ + \usepackage[hmargin=3cm,vmargin=2.5cm]{geometry} +} +\mode{ + \usefonttheme{professionalfonts} +} +\mode{ + \usecolortheme{dove} +} +\usepackage{libertine} + +\title{A demonstration of the \textsf{beamerswitch} class} +\subtitle{Testing features} +\author{Alex Ball} +\institute{University of Life} +\date{1 September 2016} +\subject{A LaTeX class} +\keywords{CTAN, literate programming} + +\begin{document} + \begin{frame} + \maketitle + \end{frame} + + This very brief demonstration shows how to use the \textsf{beamerswitch} class. + It allows easy switching between four \textsf{beamer} modes: + + \begin{frame}{Beamer modes} + \begin{itemize}[<+->] + \item \textbf{beamer:} regular slides + \item \textbf{trans:} slides suitable for printing on transparencies + \item \textbf{handout:} slides suitable for printing on paper + \item \textbf{article:} transcript, paper, notes or other article-style + document based on the slides + \end{itemize} + \end{frame} + + Notice how the text outside frames is only shown in article mode. Also, + + \begin{frame}{Features shown in this example} + \begin{itemize}[<+->] + \item Different class options are passed to the \textsf{beamer} and + \textsf{article} classes. + \item The `trans' and `handout' versions do not have the intermediate + slides used by the `beamer' version for uncovering content. + \item The handout has three slides to a page with room for handwritten + notes at the side, and is in black and white. + \end{itemize} + + \uncover<+->{See the source code of this example to see how it was done.} + \end{frame} + + This PDF also has title and author information saved in the metadata (look + at the properties in your PDF viewer). + + Happy {\LaTeX}ing! +\end{document} +%% +%% Copyright (C) 2016 by Alex Ball +%% +%% End of file `beamerswitch-example.tex'. diff --git a/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch.pdf b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch.pdf new file mode 100644 index 00000000000..418ad7bf717 Binary files /dev/null and b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch.pdf differ -- cgit v1.2.3