Debian Codegraph @

texmf-dist/doc/latex/beamer/beamerug-notes.tex

raw
1 % !TeX root = beameruserguide.tex
2 % Copyright 2003-2007 by Till Tantau
3 % Copyright 2010 by Vedran Mileti\'c
4 % Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright
5 % Copyright 2020-2026 by Joseph Wright, samcarter
6 %
7 % This file may be distributed and/or modified
8 %
9 % 1. under the LaTeX Project Public License and/or
10 % 2. under the GNU Free Documentation License.
11 %
12 % See the file LICENSE.md for more details.
13
14 \section{Adding Notes for Yourself}
15
16 A \emph{note} is text that is intended as a reminder to yourself of what you should say or should keep in mind when presenting a slide. Notes are usually printed out on paper, but with two-screen support they can also be shown on your laptop screen while the main presentation is shown on the projector.
17
18
19 \subsection{Specifying Note Contents}
20
21 To add a note to a slide or a frame, use the |\note| command. This command can be used both inside and outside frames, but it has quite different behaviors then: Inside frames, |\note| commands accumulate and append a single note page after the current slide; outside frames each |\note| directly inserts a single note page with the given parameter as contents. Using the |\note| command inside frames is usually preferably over using them outside, since only commands issued inside frames profit from the option |show only slides with notes|.
22
23 Inside a frame, the effect of |\note|\meta{text} is the following: When you use it somewhere inside the frame on a specific slide, a note page is created after the slide, containing the \meta{text}. Since you can add an overlay specification to the |\note| command, you can specify after which slide the note should be shown. If you use multiple |\note| commands on one slide, they ``accumulate'' and are all shown on the same note.
24
25 To make the accumulation of notes more convenient, you can use the |\note| command with the option |[item]|. The notes added with this option are accumulated in an |enumerate| list that follows any text inserted using |\note|.
26
27 The following example will produce one note page that follows the second slide and has two entries.
28 \begin{verbatim}
29 \begin{frame}
30 \begin{itemize}
31 \item<1-> Eggs
32 \item<2-> Plants
33 \note[item]<2>{Tell joke about plants.}
34 \note[item]<2>{Make it short.}
35 \item<3-> Animals
36 \end{itemize}
37 \end{frame}
38 \end{verbatim}
39
40 Outside frames, the command |\note| creates a single note page. It is ``independent'' of any usage of the |\note| commands inside the previous frame. If you say |\note| inside a frame and |\note| right after it, \emph{two} note pages are created.
41
42 In the following, the syntax and effects of the |\note| command \emph{inside} frames are described:
43
44 \begin{command}{\note\sarg{overlay specification}\oarg{options}\marg{note text}}
45 Effects \emph{inside} frames:
46
47 This command appends the \meta{note text} to the note that follows the current slide. Multiple uses of this command on a slide accumulate. If you do not specify an \meta{overlay specification}, the note will be added to \emph{all} slides of the current frame. This is often not what you want, so adding a specification like |<1>| is usually a good idea.
48
49 The following \meta{options} may be given:
50 \begin{itemize}
51 \item
52 \declare{|item|} causes the note to be put as an item in a list that is shown at the end of the note page.
53 \end{itemize}
54
55 \example|\note<2>{Do not talk longer than 2 minutes about this.}|
56
57 \articlenote
58 Notes are ignored in |article| mode.
59
60 \end{command}
61
62 Next, the syntax and effects of the |\note| command \emph{outside} frames are described:
63
64 \begin{command}{\note\oarg{options}\marg{note text}}
65 Outside frames, this command creates a note page. This command is \emph{not} affected by the option |show only slides with notes|.
66
67 The following \meta{options} may be given:
68 \begin{itemize}
69 \item
70 \declare{|itemize|} will enclose the whole note page in an |itemize| environment. This is just a convenience.
71 \item
72 \declare{|enumerate|} will enclose the whole note page in an |enumerate| environment.
73 \end{itemize}
74
75 \example
76 \begin{verbatim}
77 \begin{frame}
78 some text
79 \end{frame}
80 \note{Talk no more than 1 minute.}
81
82 \note[enumerate]
83 {
84 \item Stress this first.
85 \item Then this.
86 }
87 \end{verbatim}
88
89 \articlenote
90 Notes are ignored in |article| mode.
91 \end{command}
92
93 The following element dictates how the note pages are rendered:
94
95 \begin{element}{note page}\yes\yes\yes
96 This template is used to typeset a note page. The template should contain a mentioning of the insert |\insertnote|, which will contain the note text. To squeeze more onto note pages you might consider changing the size of the \beamer-font |note page| to something small. The default is |\small|.
97 \begin{templateoptions}
98 \itemoption{default}{}
99 The default template shows the last slide in the upper right corner and some ``hints'' that should help you match a note page to the slide that is currently shown.
100 \itemoption{compress}{}
101 The option produces an output that is similar to the default, only more fits onto each note page at the price of legibility.
102 \itemoption{plain}{}
103 Just inserts the note text, no fancy hints.
104 \itemoption{lined}{\oarg{number}}
105 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.
106 \end{templateoptions}
107 The following two inserts are useful for note pages:
108 \begin{itemize}
109 \iteminsert{\insertnote}
110 Inserts the text of the current note into the template.
111 \iteminsert{\insertslideintonotes}\marg{magnification}
112 Inserts a ``mini picture'' of the last slide into the current note. The slide will be scaled by the given magnification.
113
114 \emph{Note:} The backgrounds, headlines, footlines and sidebars will not appear in the slide.
115 \example
116 |\insertslideintonotes{0.25}|
117
118 This will give a mini slide whose width and height are one fourth of the usual size.
119 \end{itemize}
120 \end{element}
121
122
123 \subsection{Specifying Contents for Multiple Notes}
124
125 Sometimes you wish some text to be shown on every note or at least on every note in a long series of notes. To achieve this effect, you can use the following two commands:
126
127 \begin{command}{\AtBeginNote\marg{text}}
128 The \meta{text} will be inserted at the beginning of every note in the scope of the command. To stop the effect, either use |\AtBeginNote{}| or enclose the area in a \TeX\ group.
129
130 It is advisable to add a |\par| command or an empty line at the end of the \meta{text} since otherwise any note text will directly follow the \meta{text} without a line break.
131
132 \example
133 \begin{verbatim}
134 \section{My Section}
135
136 \AtBeginNote{Finish this section by 14:35.\par}
137 \begin{frame}
138 ...
139 \note{some note}
140 \end{frame}
141 \begin{frame}
142 ...
143 \note{some other note}
144 \end{frame}
145 \AtBeginNote{}
146 \end{verbatim}
147 \end{command}
148
149 \begin{command}{\AtEndNote\marg{text}}
150 This command behaves the same way as |\AtBeginNote|, except that the text is inserted at the end (bottom). You may wish to add a |\par| at the beginning of \meta{text}.
151 \end{command}
152
153
154 \subsection{Specifying Which Notes and Frames Are Shown}
155
156 Since you normally do not wish the notes to be part of your presentation, you must explicitly say so in the preamble if notes should be included in your presentation. You can use the following \beamer\ options for this:
157
158 \begin{beameroption}{hide notes}{}
159 Notes are not shown. This is the default in a presentation.
160 \end{beameroption}
161
162 \begin{beameroption}{show notes}{}
163 Include notes in the output file. Normal slides are also included and the note pages are interleaved with them.
164 \end{beameroption}
165
166 \begin{beameroption}{show notes on second screen}{|=|\meta{location}}
167 \label{command-notesonsecondscreen}
168 When this option is given, a two screen version of your talk is created, see Section~\ref{section-twoscreens} for further details. The second screen, which is displayed on the right by default, shows your notes. By specifying a different \meta{location}, you can also place the second screen on the |left|, |bottom|, or |top|.
169
170 \example
171 \begin{verbatim}
172 \documentclass{beamer}
173 \setbeameroption{show notes on second screen}
174 \begin{document}
175 \begin{frame}
176 A frame.
177 \note{This is shown on the right.}
178 \end{frame}
179 \end{document}
180 \end{verbatim}
181
182 In detail, the following happens: The presentation is typeset normally and shown on the main screen or, to be precise, on |pgfpages|'s logical page number zero. The second screen (logical screen number one) is initialized to be empty.
183
184 Whenever a note page is to be typeset, either because a frame contained |\note| commands or because the frame was followed by a |\note| command, the note page is normally typeset. Then the note page is put on the second screen. Then the whole page is shipped out. (The exact details are bit more complex, but that is what happens, basically.)
185
186 An important effect of this behavior is that a note page \emph{following} a frame is shown next to this frame. Normally, this is exactly what you want and expect. However, if there are multiple note pages for a single slide only the last one is shown, currently. This may change in the future, so do not rely on this effect.
187
188 \example
189 \begin{verbatim}
190 \begin{frame}
191 First frame.
192 \end{frame}
193 \note{This note is not shown at all (currently).}
194 \note{This note is shown together with the first frame.}
195
196 \begin{frame}
197 Second frame.
198 \note{This note is shown together with the second frame.}
199 \end{frame}
200
201 \begin{frame}
202 No note text is shown for this frame.
203 \end{frame}
204 \end{verbatim}
205
206 If you really need multiple note pages for a single slide, you will have to use something more complicated like this:
207 \begin{verbatim}
208 \begin{frame}<1-3>
209 First frame.
210 \note<1>{First page of notes for this frame.}
211 \note<2>{Second page of notes for this frame.}
212 \note<3>{Third page of notes for this frame.}
213 \end{frame}
214 \end{verbatim}
215 \end{beameroption}
216
217 \begin{beameroption}{show only notes}{}
218 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).
219 \end{beameroption}
220
221 \begin{beameroption}{show only slides with notes}{}
222 Include only slides in the output file that have an accompanying note page. Slides without notes will be excluded. 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.
223 \end{beameroption}