summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/beamerswitch
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-08-23 16:45:43 +0000
committerKarl Berry <karl@freefriends.org>2016-08-23 16:45:43 +0000
commitdbaf5dc8b5ab0af4d93ec0d70ca70f72ab0d76ca (patch)
tree3edef261e1fc5fb284f0bfb5d56b2f7998c19861 /Master/texmf-dist/doc/latex/beamerswitch
parentd73710f127ca9ba9ae3e6cea23dd8a616c053bea (diff)
beamerswitch
git-svn-id: svn://tug.org/texlive/trunk@41914 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/beamerswitch')
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/Makefile50
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/README.md82
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-article.pdfbin0 -> 19460 bytes
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-handout.pdfbin0 -> 21672 bytes
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-trans.pdfbin0 -> 22284 bytes
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.pdfbin0 -> 35774 bytes
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.tex82
-rw-r--r--Master/texmf-dist/doc/latex/beamerswitch/beamerswitch.pdfbin0 -> 146131 bytes
8 files changed, 214 insertions, 0 deletions
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-article.pdf
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-handout.pdf
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example-trans.pdf
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch-example.pdf
Binary files 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<article>{
+ \usepackage[hmargin=3cm,vmargin=2.5cm]{geometry}
+}
+\mode<presentation>{
+ \usefonttheme{professionalfonts}
+}
+\mode<handout>{
+ \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 <a.j.ball@bath.ac.uk>
+%%
+%% 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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/beamerswitch/beamerswitch.pdf
Binary files differ