Skip to content

Commit

Permalink
doc: various issues (close #909)
Browse files Browse the repository at this point in the history
  • Loading branch information
samcarter committed Aug 24, 2024
1 parent d38d578 commit 6601e7f
Show file tree
Hide file tree
Showing 7 changed files with 17 additions and 14 deletions.
4 changes: 2 additions & 2 deletions doc/beamerug-fonts.tex
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ \subsection{Font Themes}
causes mathematical text still to be typeset using sans serif. This option only makes sense if you also use the |stillsansseriftext| option since sans serif math inside serif text looks silly.
\item
\declare{|stillsansserifsmall|}
will cause ``small'' text to be still typeset using sans serif. This refers to the text in the headline, footline, and sidebars. Using this options is often advisable since small text is often easier to read in sans serif.
will cause ``small'' text to be still typeset using sans serif. This refers to the text in the headline, footline, and sidebars. Using this option is often advisable since small text is often easier to read in sans serif.
\item
\declare{|stillsansseriflarge|}
will cause ``large'' text like the presentation title or the frame title to be still typeset using sans serif. Sans serif titles with serif text are a popular combination in typography.
Expand Down Expand Up @@ -175,7 +175,7 @@ \subsection{Changing the Fonts Used for Different Elements of a Presentation}

\subsubsection{Overview of Beamer's Font Management}

\beamer's font mechanism is somewhat similar to \beamer's color mechanism, but not quite the same. As for colors, every \beamer\ element, like the frame titles, the document title, the footnotes, and so on has a certain \beamer-font. As for colors, on the one hand you can specify the font of each element individually; on the other hand fonts also use inheritance, thereby making it easy to globally change the fonts used for, say, ``titlelike things'' or for ``itemizelike things.''
\beamer's font mechanism is somewhat similar to \beamer's color mechanism, but not quite the same. Similar to colors, every \beamer\ element, like the frame titles, the document title, the footnotes, and so on has a certain \beamer-font. Similar to colors, on the one hand you can specify the font of each element individually; on the other hand fonts also use inheritance, thereby making it easy to globally change the fonts used for, say, ``titlelike things'' or for ``itemizelike things.''

While a \beamer-color has a certain foreground and a certain background, either of which may be empty, a \beamer-font has a size, a shape, a series, and a family, each of which may be empty. The inheritance relation among \beamer-fonts is not necessarily the same as between \beamer-colors, though we have tried to match them whenever possible.

Expand Down
4 changes: 2 additions & 2 deletions doc/beamerug-frames.tex
Original file line number Diff line number Diff line change
Expand Up @@ -606,7 +606,7 @@ \subsubsection{The Headline and Footline}

\itemoption{totalframenumber}{} In addition to the current frame number, this option also shows the total number of frames.

\itemoption{appendixframenumber}{} This options replicates the behaviour of the |appendixnumberbeamer| package. In the main part before the |\appendix| command the current frame number and the total number of frames in the main part is displayed. In the appendix only the frame number within the appendix and the total number of frames in the appendix are shown.
\itemoption{appendixframenumber}{} This option replicates the behaviour of the |appendixnumberbeamer| package. In the main part before the |\appendix| command the current frame number and the total number of frames in the main part is displayed. In the appendix only the frame number within the appendix and the total number of frames in the appendix are shown.

\itemoption{pagenumber}{} Shows the current page number.

Expand Down Expand Up @@ -643,7 +643,7 @@ \subsubsection{The Sidebars}
\itemoption{default}{}
installs an empty template.
\itemoption{sidebar theme}{}
This option is available if the outer theme |sidebar| is loaded with the |left| option. In this case, this options is selected automatically. It shows a mini table of contents in the sidebar.
This option is available if the outer theme |sidebar| is loaded with the |left| option. In this case, this option is selected automatically. It shows a mini table of contents in the sidebar.
\end{templateoptions}
\end{element}

Expand Down
15 changes: 9 additions & 6 deletions doc/beamerug-localstructure.tex
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ \subsection{Itemizations, Enumerations, and Descriptions}

\begin{templateinserts}
\iteminsert{\insertsubsubenumlabel}
inserts the current number of the second-level enumeration (as an Arabic number).
inserts the current number of the third-level enumeration (as an Arabic number).
\end{templateinserts}
\end{element}

Expand Down Expand Up @@ -377,7 +377,7 @@ \subsection{Highlighting}
Environment version of the |\alert| command.

\begin{element}{alerted text begin}\yes\no\no
This text is inserted at the beginning of a an |alertenv| environment.
This text is inserted at the beginning of an |alertenv| environment.

\begin{templateoptions}
\itemoption{default}{}
Expand Down Expand Up @@ -520,7 +520,10 @@ \subsection{Block Environments}
\subsection{Theorem Environments}
\label{section-theorems}

The \beamer\ class predefines several environments, like |theorem| or |definition| or |proof|, that you can use to typeset things like, well, theorems, definitions, or proofs. The complete list is the following: |theorem|, |corollary|, |definition|, |definitions|, |fact|, |example|, and |examples|. The following German block environments are also predefined: |Problem|, |Loesung|, |Definition|, |Satz|, |Beweis|, |Folgerung|, |Lemma|, |Fakt|, |Beispiel|, and |Beispiele|.
The \beamer\ class predefines several environments, like |theorem| or |definition| or |proof|, that you can use to typeset things like, well, theorems, definitions, or proofs. The complete list is the following:
|theorem|, |Theorem|, |corollary|, |Corollary|, |definition|, |Definition|, |definitions|, |fact|, |example|, |Example|, |examples|, |Examples|, |lemma|, |Lemma|, |problem|, |Problem|, |proof|, |Proof|, and |solution|.

The following German block environments are also predefined: |Problem|, |Loesung|, |Definition|, |Satz|, |Beweis|, |Folgerung|, |Lemma|, |Fakt|, |Theorem|, |Beispiel|, and |Beispiele|.

Here is a typical example on how to use them:
\begin{verbatim}
Expand Down Expand Up @@ -594,7 +597,7 @@ \subsection{Theorem Environments}
\begin{environment}{{proof}\sarg{action specification}\oarg{proof name}\sarg{action specification}}
Typesets a proof. If the optional \meta{proof name} is given, it completely replaces the word ``Proof.'' This is different from normal theorems, where the optional argument is shown in brackets.

At the end of the theorem, a |\qed| symbol is shown, except if you say |\qedhere| earlier in the proof (this is exactly as in |amsthm|). The default |\qed| symbol is an open circle. To completely suppress the symbol, write |\def\qedsymbol{}| in your preamble. To get a closed square, say
At the end of the proof, a |\qed| symbol is shown, except if you say |\qedhere| earlier in the proof (this is exactly as in |amsthm|). The default |\qed| symbol is an open square. To completely suppress the symbol, write |\def\qedsymbol{}| in your preamble. To get a closed square, say
\begin{verbatim}
\setbeamertemplate{qed symbol}{\vrule width1.5ex height1.5ex depth0pt}
\end{verbatim}
Expand Down Expand Up @@ -753,7 +756,7 @@ \subsection{Theorem Environments}

\subsection{Framed and Boxed Text}

In order to draw a frame (a rectangle) around some text, you can use \LaTeX s standard command |\fbox| and also |\frame| (inside a \beamer\ frame, the |\frame| command changes its meaning to the normal \LaTeX\ |\frame| command). More frame types are offered by the package |fancybox|, which defines the following commands: |\shadowbox|, |\doublebox|, |\ovalbox|, and |\Ovalbox|. Please consult the \LaTeX\ Companion for details on how to use these commands.
In order to draw a frame (a rectangle) around some text, you can use \LaTeX's standard command |\fbox| and also |\frame| (inside a \beamer\ frame, the |\frame| command changes its meaning to the normal \LaTeX\ |\frame| command). More frame types are offered by the package |fancybox|, which defines the following commands: |\shadowbox|, |\doublebox|, |\ovalbox|, and |\Ovalbox|. Please consult the \LaTeX\ Companion for details on how to use these commands.

The \beamer\ class also defines two environments for creating colored boxes.

Expand Down Expand Up @@ -894,7 +897,7 @@ \subsection{Figures and Tables}
\itemoption{numbered}{}
adds the figure or table number to the caption. Use this option only if your audience has a printed handout or printed lecture notes that follow the same numbering.
\itemoption{caption name own line}{}
As the name suggests, this options puts the caption name (like ``Figure'') on its own line.
As the name suggests, this option puts the caption name (like ``Figure'') on its own line.
\end{templateoptions}

Inside the template, you can use the following inserts:
Expand Down
2 changes: 1 addition & 1 deletion doc/beamerug-notes.tex
Original file line number Diff line number Diff line change
Expand Up @@ -215,7 +215,7 @@ \subsection{Specifying Which Notes and Frames Are Shown}
\end{beameroption}

\begin{beameroption}{show only notes}{}
Include only the notes in the output file and suppresses all frames. This options is useful for printing them. If you specify this command, the |.aux| and |.toc| files are \emph{not} updated. So, if you add a section and re\TeX\ your presentation, this will not be reflected in the navigation bars (which you do not see anyway since only notes are output).
Include only the notes in the output file and suppresses all frames. This option is useful for printing them. If you specify this command, the |.aux| and |.toc| files are \emph{not} updated. So, if you add a section and re\TeX\ your presentation, this will not be reflected in the navigation bars (which you do not see anyway since only notes are output).
\end{beameroption}

\begin{beameroption}{show only slides with notes}{}
Expand Down
2 changes: 1 addition & 1 deletion doc/beamerug-overlays.tex
Original file line number Diff line number Diff line change
Expand Up @@ -303,7 +303,7 @@ \subsection{Commands with Overlay Specifications}
\begin{frame}
\begin{align}
a &= b + c \label{first}\\ % no specification needed
c &= d + e \label{second}\\% no specification needed
c &= d + e \label{second}% no specification needed
\end{align}
Blah blah, \uncover<2>{more blah blah.}
Expand Down
2 changes: 1 addition & 1 deletion doc/beamerug-themes.tex
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ \subsection{Five Flavors of Themes}
\item[Color Themes]
A color theme only dictates which colors are used in a presentation. If you have chosen a particular presentation theme and then choose a color theme, only the colors of your presentation will change. A color theme can specify colors in a very detailed way: For example, a color theme can specifically change the colors used to render, say, the border of a button, the background of a button, and the text on a button.
\item[Font Themes]
A font theme dictates which fonts or font attributes are used in a presentation. As for colors, the font of all text elements used in a presentation can be specified independently.
A font theme dictates which fonts or font attributes are used in a presentation. Similar to colors, the font of all text elements used in a presentation can be specified independently.
\item[Inner Themes]
An inner theme specifies how certain elements of a presentation are typeset. This includes all elements that are at the ``inside'' of the frame, that is, that are not part of the headline, footline, or sidebars. This includes all enumerations, itemize environments, block environments, theorem environments, or the table of contents. For example, an inner theme might specify that in an enumeration the number should be typeset without a dot and that a small circle should be shown behind it. The inner theme would \emph{not} specify what color should be used for the number or the circle (this is the job of the color theme) nor which font should be used (this is the job of the font theme).
\item[Outer Themes]
Expand Down
2 changes: 1 addition & 1 deletion doc/beamerug-workflow.tex
Original file line number Diff line number Diff line change
Expand Up @@ -178,7 +178,7 @@ \subsubsection{Creating the Handout}
\subsubsection{Printing the Handout}
\label{section-printing-version}

The easiest way to print a presentation is to user the Acrobat Reader with the option ``expand small pages to paper size'' form the printer dialog enabled. This is necessary, because slides are by default only 128mm by 96mm large.
The easiest way to print a presentation is to use Acrobat Reader with the option ``expand small pages to paper size'' form the printer dialog enabled. This is necessary, because slides are by default only 128mm by 96mm large.

For the PostScript version and for printing multiple slides on a single page this simple approach does not work. In such cases you can use the |pgfpages| package, which works directly with |pdflatex|, |lualatex|, |xelatex| and |latex| plus |dvips|. Note however \emph{that this package destroys hyperlinks}. This is due to fundamental flaws in the \pdf-specification and it is not likely to change.

Expand Down

0 comments on commit 6601e7f

Please sign in to comment.