summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/beamer/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-01-22 03:01:16 +0000
committerNorbert Preining <norbert@preining.info>2022-01-22 03:01:16 +0000
commit26bfc07f2b7829213356de43cf5b81c3ba99e338 (patch)
treeefb3037df2c42c45c904ad131334e8fc626cea19 /macros/latex/contrib/beamer/doc
parent5d5f239204f5c0d1f7573c9ebc64b5ad1ae75b49 (diff)
CTAN sync 202201220301
Diffstat (limited to 'macros/latex/contrib/beamer/doc')
-rw-r--r--macros/latex/contrib/beamer/doc/beamerexample-conference-talk.pdfbin343839 -> 343905 bytes
-rw-r--r--macros/latex/contrib/beamer/doc/beamerexample-lecture-beamer-version.pdfbin547580 -> 547601 bytes
-rw-r--r--macros/latex/contrib/beamer/doc/beamerexample-lecture-print-version.pdfbin441722 -> 441708 bytes
-rw-r--r--macros/latex/contrib/beamer/doc/beamerug-frames.tex111
-rw-r--r--macros/latex/contrib/beamer/doc/beamerug-localstructure.tex4
-rw-r--r--macros/latex/contrib/beamer/doc/beamerug-nonpresentation.tex43
-rw-r--r--macros/latex/contrib/beamer/doc/beamerug-notes.tex2
-rw-r--r--macros/latex/contrib/beamer/doc/beamerug-overlays.tex7
-rw-r--r--macros/latex/contrib/beamer/doc/beameruserguide.pdfbin2251200 -> 2251777 bytes
-rw-r--r--macros/latex/contrib/beamer/doc/beameruserguide.tex4
10 files changed, 137 insertions, 34 deletions
diff --git a/macros/latex/contrib/beamer/doc/beamerexample-conference-talk.pdf b/macros/latex/contrib/beamer/doc/beamerexample-conference-talk.pdf
index 09da4c74c6..18854724fb 100644
--- a/macros/latex/contrib/beamer/doc/beamerexample-conference-talk.pdf
+++ b/macros/latex/contrib/beamer/doc/beamerexample-conference-talk.pdf
Binary files differ
diff --git a/macros/latex/contrib/beamer/doc/beamerexample-lecture-beamer-version.pdf b/macros/latex/contrib/beamer/doc/beamerexample-lecture-beamer-version.pdf
index 95425d5d64..944799cbdd 100644
--- a/macros/latex/contrib/beamer/doc/beamerexample-lecture-beamer-version.pdf
+++ b/macros/latex/contrib/beamer/doc/beamerexample-lecture-beamer-version.pdf
Binary files differ
diff --git a/macros/latex/contrib/beamer/doc/beamerexample-lecture-print-version.pdf b/macros/latex/contrib/beamer/doc/beamerexample-lecture-print-version.pdf
index caadeb41cc..49ed6ecdff 100644
--- a/macros/latex/contrib/beamer/doc/beamerexample-lecture-print-version.pdf
+++ b/macros/latex/contrib/beamer/doc/beamerexample-lecture-print-version.pdf
Binary files differ
diff --git a/macros/latex/contrib/beamer/doc/beamerug-frames.tex b/macros/latex/contrib/beamer/doc/beamerug-frames.tex
index de4449ad7d..6084846432 100644
--- a/macros/latex/contrib/beamer/doc/beamerug-frames.tex
+++ b/macros/latex/contrib/beamer/doc/beamerug-frames.tex
@@ -146,6 +146,8 @@ A presentation consists of a series of frames. Each frame consists of a series o
\item
\declare{|b|}, \declare{|c|}, \declare{|t|} will cause the frame to be vertically aligned at the bottom/center/top. This overrides the global placement policy, which is governed by the class options |t| and |c|.
\item
+ \declare{|s|} will cause the content of the frame to be distributed vertically across the whole frame. For a reasonable usage of the option, the user has to add ``stretchable'' material to the frame content, e.g. |\vfill| or similar macros.
+ \item
\declare{|noframenumbering|} tells \beamer\ not to step the |framenumber| counter for this frame.
\item
\declare{|fragile|\opt{|=singleslide|}} tells \beamer\ that the frame contents is ``fragile.'' This means that the frame contains text that is not ``interpreted as usual.'' For example, this applies to verbatim text, which is, obviously, interpreted somewhat differently from normal text.
@@ -293,7 +295,99 @@ Each frame consists of several components:
\item some frame contents.
\end{enumerate}
-A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using.
+A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using.
+Figure \ref{fig:framelayers} shows an overview of the order in which the different components are drawn.
+
+\begin{figure}[htbp]
+% the following code is based on https://gist.githubusercontent.com/loopspace/c37dd788b217f2e963587278c3532f73/raw/f6e4708f36f661193ea7aed3cba7d389226658cc/beamerframe.tex
+\begin{tikzpicture}[z={(0.97,0)},x={(.55,.4)}]
+
+% colour palette generated by mycolor.space to match beamer's beamer@blendedblue
+\definecolor{fc_col1}{HTML}{3333b3}
+\definecolor{fc_col2}{HTML}{b1a3d9}
+\definecolor{fc_col3}{HTML}{fffade}
+\definecolor{fc_col4}{HTML}{68baa5}
+\definecolor{fc_col5}{HTML}{ae0000}
+
+\colorlet{base}{fc_col3}
+\colorlet{background canvas}{base}
+\colorlet{logo bg}{fc_col1}
+\colorlet{sidebar left}{fc_col4}
+\colorlet{sidebar right}{fc_col4}
+\colorlet{section in sidebar}{fc_col5}
+\colorlet{logo fg}{white}
+\colorlet{footline}{fc_col2}
+\colorlet{navigation symbols}{fc_col1}
+
+\pgfmathsetmacro{\bepgw}{12.8}
+\pgfmathsetmacro{\bepgh}{9.6}
+\newcommand{\component}[3][1]{%
+\path (#2) [draw,<-,thick] -- (#2 |- 0,-\bepgh-#1,0) node[below,text width=2cm,align=center] (#3) {#3};
+\stepcounter{zlayer}}
+\newcounter{zlayer}
+\setcounter{zlayer}{0}
+\def\zlayer{\the\value{zlayer}}
+
+\foreach \z in {0,...,10} {
+ \draw[gray,ultra thick] (0,-\bepgh,\z) -- (\bepgw,-\bepgh,\z) -- (\bepgw,0,\z);
+}
+
+% background canvas
+\fill[background canvas] (0,0,\zlayer) -- ++(\bepgw,0,0) -- ++(0,-\bepgh,0) -- ++(-\bepgw,0,0) -- cycle;
+\component[1]{1,-\bepgh,\zlayer}{background canvas}
+
+% background
+\draw[gray] \foreach \x in {0,...,\bepgw} \foreach \y in {0,...,\bepgh} {(\x,0,\zlayer) -- (\x,-\bepgh,\zlayer) (0,-\y,\zlayer) -- (\bepgw,-\y,\zlayer)};
+\component[2]{1,-\bepgh,\zlayer}{background}
+
+% left sidebar
+\fill[sidebar left] (0,0,\zlayer) -- ++(2,0,0) -- ++(0,-\bepgh,0) -- ++(-2,0,0) -- cycle;
+\component[3]{1,-\bepgh,\zlayer}{sidebar canvas left}
+
+% section in sidebar
+\node[yslant=.7,right,align=left,text=section in sidebar,font=\sffamily] at (0,-.45*\bepgh,\zlayer) (a section in sidebar) {First slide \\ Second slide \\ Third slide};
+\component[1]{1,-\bepgh,\zlayer}{section in sidebar}
+
+% right sidebar
+\fill[sidebar right] (\bepgw,0,\zlayer) -- ++(-2,0,0) -- ++(0,-\bepgh,0) -- ++(2,0,0) -- cycle;
+\component[2]{1,-\bepgh,\zlayer}{sidebar canvas right}
+
+% section in right sidebar
+\node[yslant=.7,left,align=right,text=section in sidebar,font=\sffamily] at (\bepgw,-.45*\bepgh,\zlayer) (a section in right sidebar) {First slide \\ Second slide \\ Third slide};
+\component[3]{1,-\bepgh,\zlayer}{section in right sidebar}
+
+%navigation
+\node[yslant=.7,above left,align=right,text=navigation symbols,font=\sffamily] at (\bepgw,-\bepgh,\zlayer) (navigation) {Navigation symbols};
+\component[1]{1,-\bepgh,\zlayer}{navigation symbols}
+
+% logo
+\fill[logo bg] (0,0,\zlayer) -- ++(2,0,0) -- ++(0,-2,0) -- ++(-2,0,0) -- cycle;
+\node[yslant=.7,text=logo fg,align=right,font=\sffamily] at (1,-1,\zlayer) {your\\ logo\\ here};
+\component[2]{1,-\bepgh,\zlayer}{logo}
+
+% headline
+\fill[footline] (0,0,\zlayer) -- ++(\bepgw,0,0) -- ++(0,-1,0) -- ++(-\bepgw,0,0) -- cycle;
+\node[yslant=.7,text=logo fg,align=left,font=\sffamily] at (1.5,-0.5,\zlayer) {Headline};
+\component[3]{1,-\bepgh,\zlayer}{headline}
+
+% content
+\node[yslant=.7,left,align=left,text=black,font=\sffamily] at (3,-.45*\bepgh,\zlayer) (a section in right sidebar) {Content};
+\component[1]{1,-\bepgh,\zlayer}{frame content}
+
+% footline
+\fill[footline] (0,-\bepgh,\zlayer) -- ++(\bepgw,0,0) -- ++(0,.5,0) -- ++(-\bepgw,0,0) -- cycle;
+\component[2]{1,-\bepgh,\zlayer}{footline}
+
+\addtocounter{zlayer}{-1}
+
+\foreach \z in {0,...,\zlayer} {
+ \draw[gray,ultra thick] (0,-\bepgh,\z) -- (0,0,\z) -- (\bepgw,0,\z);
+}
+
+\end{tikzpicture}
+\caption{Diagram of the order in which the different frame components are drawn (Image originally created by \href{https://tex.stackexchange.com/a/27302}{Andrew Stacey})}
+\label{fig:framelayers}
+\end{figure}
\subsubsection{The Headline and Footline}
@@ -530,6 +624,8 @@ Adding a sidebar of a certain size, say 1\,cm, will make the main text 1\,cm nar
Internally, the sidebars are typeset by showing them as part of the headline. The \beamer\ class keeps track of six dimensions, three for each side: the variables |\beamer@leftsidebar| and |\beamer@rightsidebar| store the (horizontal) sizes of the side bars, the variables |\beamer@leftmargin| and |\beamer@rightmargin| store the distance between sidebar and text, and the macros |\Gm@lmargin| and |\Gm@rmargin| store the distance from the edge of the paper to the edge of the text. Thus the sum |\beamer@leftsidebar| and |\beamer@leftmargin| is exactly |\Gm@lmargin|. Thus, if you wish to put some text right next to the left sidebar, you might write |\hskip-\beamer@leftmargin| to get there.
+For convenience, the width of the sidebar and the height of its headline are accessible through the macros |\beamersidebarwidth| and |\beamerheadheight|, respectively.
+
\begin{element}{sidebar left}\yes\yes\yes
\colorfontparents{sidebar}
The template is used to typeset the left sidebar. As mentioned above, the size of the left sidebar is set using the command
@@ -1152,6 +1248,17 @@ To change ``paper size'' and aspect ratio, you can use the following class optio
Sets aspect ratio to 3:2, and frame size to 135\,mm by 90\,mm.
\end{classoption}
+\begin{classoption}{aspectratio=xxxx}
+ Allows the user to set their own aspect ratio. For the height of the resulting frame, the default value of 96\,mm is used and the width will be calculated accordingly to match the desired aspect ratio.
+
+ The custom aspect ratio allows for two to four digits and will be interpreted as shown in the following examples:
+ \begin{itemize}
+ \item two digits: |aspectratio=42| as 4:2
+ \item three digits: |aspectratio=137| as 13:7 (e.g. always in landscape format)
+ \item four digits: |aspectratio=1024| as 10:24
+ \end{itemize}
+\end{classoption}
+
Aside from using these options, you should refrain from changing the ``paper size.'' However, you \emph{can} change the size of the left and right margins, which default to 1\,cm. To change them, you should use the following command:
\begin{command}{\setbeamersize\marg{options}}
@@ -1197,3 +1304,5 @@ You can also specify the number of slides in the frame ``by hand.'' To do so, yo
This command will create a frame containing four slides. The first will contain the text ``This is slide number~1,'' the second ``This is slide number~2,'' the third ``This is slide number~4,'' and the fourth ``This is slide number~5.''
A useful specification is just |<0>|, which causes the frame to have no slides at all. For example, |\begin{frame}<handout:0>| causes the frame to be suppressed in the handout version, but to be shown normally in all other versions. Another useful specification is |<beamer>|, which causes the frame to be shown normally in |beamer| mode, but to be suppressed in all other versions.
+
+Frames which are hidden with |<0>| behave like the |noframenumbering| option and will not be counted for the number of frames (this only applies if no mode is specified, e.g. not for |<all:0>|).
diff --git a/macros/latex/contrib/beamer/doc/beamerug-localstructure.tex b/macros/latex/contrib/beamer/doc/beamerug-localstructure.tex
index 845ecda4da..1f58012eac 100644
--- a/macros/latex/contrib/beamer/doc/beamerug-localstructure.tex
+++ b/macros/latex/contrib/beamer/doc/beamerug-localstructure.tex
@@ -948,7 +948,9 @@ The main environment for creating columns is called |columns|. Inside this envir
\item
\declare{|c|} will cause the columns to be centered vertically relative to each other. Default, unless the global option |t| is used.
\item
- \declare{|onlytextwidth|} is the same as |totalwidth=\textwidth|.
+ \declare{|onlytextwidth|} is the same as |totalwidth=\textwidth|. This option can also be set for the whole document with the |onlytextwidth| class option:
+ \begin{classoption}{onlytextwidth}
+ \end{classoption}
\item
\declare{|t|} will cause the first lines of the columns to be aligned. Default if global option |t| is used.
\item
diff --git a/macros/latex/contrib/beamer/doc/beamerug-nonpresentation.tex b/macros/latex/contrib/beamer/doc/beamerug-nonpresentation.tex
index 728741b317..eb9a23170d 100644
--- a/macros/latex/contrib/beamer/doc/beamerug-nonpresentation.tex
+++ b/macros/latex/contrib/beamer/doc/beamerug-nonpresentation.tex
@@ -271,35 +271,20 @@ In addition to these modes, \beamer\ recognizes the following names for modes se
\end{itemize}
\begin{center}
- \begin{pgfpicture}
- \pgftransformshift{\pgfpoint{0cm}{0cm}}
- \pgfnode{rectangle}{center}{|all|}{allnode}{}
- \pgftransformshift{\pgfpoint{-2cm}{-1.25cm}}
- \pgfnode{rectangle}{center}{|presentation|}{presentationnode}{}
- \pgftransformshift{\pgfpoint{4cm}{0cm}}
- \pgfnode{rectangle}{center}{|article|}{articlenode}{}
- \pgftransformshift{\pgfpoint{-7cm}{-1.5cm}}
- \pgfnode{rectangle}{center}{|beamer|}{beamernode}{}
- \pgftransformshift{\pgfpoint{2cm}{0cm}}
- \pgfnode{rectangle}{center}{|second|}{secondnode}{}
- \pgftransformshift{\pgfpoint{2cm}{0cm}}
- \pgfnode{rectangle}{center}{|handout|}{handoutnode}{}
- \pgftransformshift{\pgfpoint{2cm}{0cm}}
- \pgfnode{rectangle}{center}{|trans|}{transnode}{}
- \pgfpathmoveto{\pgfpointanchor{allnode}{south west}}
- \pgfpathlineto{\pgfpointanchor{presentationnode}{north}}
- \pgfpathmoveto{\pgfpointanchor{allnode}{south east}}
- \pgfpathlineto{\pgfpointanchor{articlenode}{north}}
- \pgfpathmoveto{\pgfpointanchor{presentationnode}{south west}}
- \pgfpathlineto{\pgfpointanchor{beamernode}{north}}
- \pgfpathmoveto{\pgfpointadd{\pgfpointanchor{presentationnode}{south}}{\pgfpoint{-0.3cm}{0cm}}}
- \pgfpathlineto{\pgfpointanchor{secondnode}{north}}
- \pgfpathmoveto{\pgfpointadd{\pgfpointanchor{presentationnode}{south}}{\pgfpoint{0.3cm}{0cm}}}
- \pgfpathlineto{\pgfpointanchor{handoutnode}{north}}
- \pgfpathmoveto{\pgfpointanchor{presentationnode}{south east}}
- \pgfpathlineto{\pgfpointanchor{transnode}{north}}
- \pgfusepath{stroke}
- \end{pgfpicture}
+ \begin{tikzpicture}[
+ every node/.style={draw,anchor=base,font=\ttfamily\strut},
+ level 1/.style={sibling distance=50mm},
+ level 2/.style={sibling distance=20mm}
+ ]
+ \node {all}
+ child {node {presentation}
+ child {node {beamer}}
+ child {node {second}}
+ child {node {handout}}
+ child {node {trans}}
+ }
+ child {node {article}};
+ \end{tikzpicture}
\end{center}
Depending on the current mode, you may wish to have certain text inserted only in that mode. For example, you might wish a certain frame or a certain table to be left out of your article version. In some situations, you can use the |\only| command for this purpose. However, the command |\mode|, which is described in the following, is much more powerful than |\only|.
diff --git a/macros/latex/contrib/beamer/doc/beamerug-notes.tex b/macros/latex/contrib/beamer/doc/beamerug-notes.tex
index a54dc4ecff..2fef37f1bf 100644
--- a/macros/latex/contrib/beamer/doc/beamerug-notes.tex
+++ b/macros/latex/contrib/beamer/doc/beamerug-notes.tex
@@ -101,7 +101,7 @@ The following element dictates how the note pages are rendered:
\itemoption{plain}{}
Just inserts the note text, no fancy hints.
\itemoption{lined}{\oarg{number}}
- Instead of printing the note text, this option fills the note page with lines on which the audience can write their own notes on. \meta{number} specifies how many lines will be shown, the default is 6 lines.
+ Instead of printing the note text, this option fills the note page with lines on which the audience can write their own notes on. \meta{number} specifies how many lines will be shown, the default is 6 lines. For a more sophisticated interface, the \href{https://www.ctan.org/pkg/handoutwithnotes}{|handoutwithnotes|} package can be used.
\end{templateoptions}
The following two inserts are useful for note pages:
\begin{itemize}
diff --git a/macros/latex/contrib/beamer/doc/beamerug-overlays.tex b/macros/latex/contrib/beamer/doc/beamerug-overlays.tex
index 57a8546f9b..c3d770701c 100644
--- a/macros/latex/contrib/beamer/doc/beamerug-overlays.tex
+++ b/macros/latex/contrib/beamer/doc/beamerug-overlays.tex
@@ -545,6 +545,13 @@ This section explains how to define new commands that are overlay specification-
\end{verbatim}
\end{command}
+In a similar way |\NewDocumentCommand|, |\NewDocumentEnvironment| etc. can be used to define overlay aware commands and environments. The overlay argument can be specified via |d<>| (without default value) or |D<>{}| (with default value) type arguments.
+
+\example
+\begin{verbatim}
+\NewDocumentCommand{\makeblue}{D<>{.-} m}{{\color<#1>{blue}#2}}
+\end{verbatim}
+
The following two commands can be used to ensure that a certain counter is automatically reset on subsequent slides of a frame. This is necessary for example for the equation count. You might want this count to be increased from frame to frame, but certainly not from overlay slide to overlay slide. For equation counters and footnote counters (you should not use footnotes), these commands have already been invoked.
\begin{command}{\resetcounteronoverlays\marg{counter name}}
diff --git a/macros/latex/contrib/beamer/doc/beameruserguide.pdf b/macros/latex/contrib/beamer/doc/beameruserguide.pdf
index 4a307329c0..6ef87a6ab6 100644
--- a/macros/latex/contrib/beamer/doc/beameruserguide.pdf
+++ b/macros/latex/contrib/beamer/doc/beameruserguide.pdf
Binary files differ
diff --git a/macros/latex/contrib/beamer/doc/beameruserguide.tex b/macros/latex/contrib/beamer/doc/beameruserguide.tex
index 3ddbee05e1..46002a15df 100644
--- a/macros/latex/contrib/beamer/doc/beameruserguide.tex
+++ b/macros/latex/contrib/beamer/doc/beameruserguide.tex
@@ -13,7 +13,7 @@
\documentclass{ltxdoc}
-\def\beamerugversion{3.64}
+\def\beamerugversion{3.65}
\def\beamerugpgfversion{3.1.7}
\def\beamerugxcolorversion{2.00}
@@ -28,7 +28,7 @@
\usepackage[pdfborder={0 0 0},bookmarksnumbered]{hyperref}
\usepackage[left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
\usepackage{translator}
-
+\usepackage{tikz}
\input{beamerug-macros}