Debian Codegraph @

texmf-dist/doc/latex/beamer/beamerug-globalstructure.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 2017,2018 by Louis Stuart, Joseph Wright
6 % Copyright 2020-2026 by Joseph Wright, samcarter
7 %
8 % This file may be distributed and/or modified
9 %
10 % 1. under the LaTeX Project Public License and/or
11 % 2. under the GNU Free Documentation License.
12 %
13 % See the file LICENSE.md for more details.
14
15 \section{Structuring a Presentation: The Static Global Structure}
16
17 This section lists the commands that are used for structuring a presentation ``globally'' using commands like |\section| or |\part|. These commands are used to create a \emph{static} structure, meaning that the resulting presentation is normally presented one slide after the other in the order the slides occur. Section~\ref{section-nonlinear} explains which commands can be used to create the \emph{interactive} structure. For the interactive structure, you must interact with the presentation program, typically by clicking on hyperlinks, to advance the presentation.
18
19 \subsection{Adding a Title Page}
20
21 You can use the |\titlepage| command to insert a title page into a frame. By default, it will arrange the following elements on the title page: the document title, the authors' names, their affiliation, a title graphic, and a date.
22
23 \begin{command}{\titlepage}
24 Inserts the text of a title page into the current frame.
25 \example
26 |\begin{frame}\titlepage\end{frame}|
27 \example
28 |\begin{frame}[plain]\titlepage\end{frame}| for a titlepage that fills the whole frame.
29
30 \begin{element}{title page}\yes\yes\yes
31 This template is invoked when the |\titlepage| command is used.
32
33 \begin{templateoptions}
34 \itemoption{default}{\oarg{alignment}}
35 The title page is typeset showing the title, followed by the author, their affiliation, the date, and a titlegraphic. If any of these are missing, they are not shown. Except for the titlegraphic, if the \beamer-color |title|, |author|, |institute|, or |date| is defined, respectively, it is used as textcolor for these entries. If a background color is defined for them, a colored bar in the corresponding color is drawn behind them, spanning the text width. The corresponding \beamer-fonts are used for these entries. The following templates are used by the title page:
36 \begin{element}{title}\yes\yes\yes
37 \end{element}
38 \begin{element}{author}\yes\yes\yes
39 \end{element}
40 \begin{element}{institute}\yes\yes\yes
41 \end{element}
42 \begin{element}{date}\yes\yes\yes
43 \end{element}
44 \begin{element}{titlegraphic}\yes\no\no
45 \end{element}
46
47 The \meta{alignment} option is passed on the |beamercolorbox| and can be used, for example, to flush the title page to the left by specifying |left| here.
48 \end{templateoptions}
49
50 The following commands are useful for this template:
51 \begin{templateinserts}
52 \iteminsert{\insertauthor} inserts a version of the author's name that is useful for the title page.
53 \iteminsert{\insertdate} inserts the date.
54 \iteminsert{\insertinstitute} inserts the institute.
55 \iteminsert{\inserttitle} inserts a version of the document title that is useful for the title page.
56 \iteminsert{\insertsubtitle} inserts a version of the document title that is useful for the title page.
57 \iteminsert{\inserttitlegraphic} inserts the title graphic into a template.
58 \end{templateinserts}
59 \end{element}
60 \end{command}
61
62 For compatibility with other classes, in |article| mode the following command is also provided:
63
64 \begin{command}{\maketitle}
65 \beamernote
66 If used inside a frame, it has the same effect as |\titlepage|. If used outside a frame, it has the same effect as |\begin{frame}\titlepage\end{frame}|; in other words, a frame is added if necessary.
67 \end{command}
68
69 Before you invoke the title page command, you must specify all elements you wish to be shown. This is done using the following commands:
70
71 \begin{command}{\title\oarg{short title}\marg{title}}
72 The \meta{short title} is used in headlines and footlines. Inside the \meta{title} line breaks can be inserted using the double-backslash command.
73 \example
74 \begin{verbatim}
75 \title{The Beamer Class}
76 \title[Short Version]{A Very Long Title\\Over Several Lines}
77 \end{verbatim}
78
79 \articlenote
80 The short form is ignored in |article| mode.
81 \end{command}
82
83 \begin{command}{\subtitle\oarg{short subtitle}\marg{subtitle}}
84 The \meta{short subtitle} is not used by default, but is available via the insert |\insertshortsubtitle|. The subtitle is shown below the title in a smaller font.
85 \example
86 \begin{verbatim}
87 \title{The Beamer Class}
88 \subtitle{An easily paced introduction with many examples.}
89 \end{verbatim}
90
91 \articlenote
92 This command causes the subtitle to be appended to the title with a linebreak and a |\normalsize| command issued before it. This may or may not be what you would like to happen.
93 \end{command}
94
95 \begin{command}{\author\oarg{short author names}\marg{author names}}
96 The names should be separated using the command |\and|. In case authors have different affiliations, they should be suffixed by the command |\inst| with different parameters.
97 \example
98 |\author[Hemaspaandra et al.]{L. Hemaspaandra\inst{1} \and T. Tantau\inst{2}}|
99
100 \articlenote
101 The short form is ignored in |article| mode.
102 \end{command}
103
104 \begin{command}{\institute\oarg{short institute}\marg{institute}}
105 If more than one institute is given, they should be separated using the command |\and| and they should be prefixed by the command |\inst| with different parameters.
106 \example
107 \begin{verbatim}
108 \institute[Universities of Rijeka and Berlin]{
109 \inst{1}Department of Informatics\\
110 University of Rijeka
111 \and
112 \inst{2}Fakult\"at f\"ur Elektrotechnik und Informatik\\
113 Technical University of Berlin}
114 \end{verbatim}
115
116 \articlenote
117 The short form is ignored in |article| mode. The long form is also ignored, except if the document class (like |llncs|) defines it.
118 \end{command}
119
120 \begin{command}{\date\oarg{short date}\marg{date}}
121 \example|\date{\today}| or |\date[STACS 2003]{STACS Conference, 2003}|.
122
123 \articlenote
124 The short form is ignored in |article| mode.
125 \end{command}
126
127 \begin{command}{\titlegraphic\marg{text}}
128 The \meta{text} is shown as title graphic. Typically, a picture environment is used as \meta{text}.
129 \example
130 |\titlegraphic{\pgfuseimage{titlegraphic}}|
131
132 \articlenote
133 The command is ignored in |article| mode.
134 \end{command}
135
136 \begin{command}{\subject\marg{text}}
137 Enters the \meta{text} as the subject text in the \pdf\ document info. It currently has no other effect.
138 \end{command}
139
140 \begin{command}{\keywords\marg{text}}
141 Enters the \meta{text} as keywords in the \pdf\ document info. It currently has no other effect.
142 \end{command}
143
144
145 By default, the |\title| and |\author| commands will also insert their arguments into a resulting \pdf-file in the document information fields. This may cause problems if you use complicated things like boxes as arguments to these commands. In this case, you might wish to switch off the automatic generation of these entries using the following class option:
146
147 \begin{classoption}{usepdftitle=false}
148 Suppresses the automatic generation of title and author entries in the \pdf\ document information.
149 \end{classoption}
150
151
152 \subsection{Adding Sections and Subsections}
153
154 You can structure your text using the commands |\section| and |\subsection|. Unlike standard \LaTeX, these commands will not create a heading at the position where you use them. Rather, they will add an entry to the table of contents and also to the navigation bars.
155
156 In order to create a line break in the table of contents (usually not a good idea), you can use the command |\breakhere|. Note that the standard command |\\| is modified so that it's no longer robust (see Section 9.3; using |\protect\\| or |\newline| will also be fine).
157
158 \begin{command}{\section\sarg{mode specification}\oarg{short section name}\marg{section name}}
159 Starts a section. No heading is created. By default the \meta{section name} is shown in the table of contents and in the navigation bars; if \meta{short section name} is specified, it will be used in the navigation bars instead; if \meta{short section name} is explicitly empty, it will not appear in the navigation bars. If a \meta{mode specification} is given, the command only has an effect for the specified modes.
160
161 \example
162 |\section[Summary]{Summary of Main Results}|
163
164 \articlenote
165 The \meta{mode specification} allows you to provide an alternate section command in |article| mode. This is necessary for example if the \meta{short section name} is unsuitable for the table of contents:
166
167 \example
168 \begin{verbatim}
169 \section<presentation>[Results]{Results on the Main Problem}
170 \section<article>{Results on the Main Problem}
171 \end{verbatim}
172
173 \begin{element}{section in toc}\yes\yes\yes
174 This template is used when a section entry is to be typeset. For the permissible \meta{options} see the parent template |table of contents|.
175
176 The following commands are useful for this template:
177 \begin{templateinserts}
178 \iteminsert{\inserttocsection}
179 inserts the table of contents version of the current section name.
180
181 \iteminsert{\inserttocsectionnumber}
182 inserts the number of the current section (in the table of contents).
183 \end{templateinserts}
184 \end{element}
185
186 \begin{element}{section in toc shaded}\yes\yes\yes
187 This template is used instead of the previous one if the section should be shown in a shaded way, because it is not the current section. For the permissible \meta{options} see the parent template |table of contents|.
188 \end{element}
189 \end{command}
190
191 \begin{command}{\section\sarg{mode specification}\declare{|*|}\marg{section name}}
192 Starts a section without an entry in the table of contents. No heading is created, but the \meta{section name} is shown in the navigation bar.
193 \example
194 |\section*{Outline}|
195 \example
196 |\section<beamer>*{Outline}|
197 \end{command}
198
199 \begin{command}{\subsection\sarg{mode specification}\oarg{short subsection name}\marg{subsection name}}
200 This command works the same way as the |\section| command.
201 \example
202 |\subsection[Applications]{Applications to the Reduction of Pollution}|
203
204 \begin{element}{subsection in toc}\yes\yes\yes
205 Like |section in toc|, only for subsection.
206
207 In addition to the inserts for the |section in toc| template, the following commands are available for this template:
208 \begin{templateinserts}
209 \iteminsert{\inserttocsubsection}
210 inserts the table of contents version of the current subsection name.
211
212 \iteminsert{\inserttocsubsectionnumber}
213 inserts the number of the current subsection (in the table of contents).
214 \end{templateinserts}
215 \end{element}
216
217 \begin{element}{subsection in toc shaded}\yes\yes\yes
218 Like |section in toc shaded|, only for subsections.
219 \end{element}
220 \end{command}
221
222 \begin{command}{\subsection\sarg{mode specification}\declare{|*|}\marg{subsection name}}
223 Starts a subsection without an entry in the table of contents. No heading is created, but the \meta{subsection name} is shown in the navigation bar, \emph{except} if \meta{subsection name} is empty. In this case, neither a table of contents entry nor a navigation bar entry is created, \emph{but} any frames in this ``empty'' subsection are shown in the navigation bar.
224
225 \example
226 \begin{verbatim}
227 \section{Summary}
228
229 \begin{frame}
230 This frame is not shown in the navigation bar
231 \end{frame}
232
233 \subsection*{}
234
235 \begin{frame}
236 This frame is shown in the navigation bar, but no subsection entry is shown.
237 \end{frame}
238
239 \subsection*{A subsection}
240
241 \begin{frame}
242 Normal frame, shown in navigation bar. The subsection name is
243 also shown in the navigation bar, but not in the table of contents.
244 \end{frame}
245 \end{verbatim}
246 \end{command}
247
248 \begin{command}{\subsubsection\sarg{mode specification}\oarg{short subsubsection name}\marg{subsubsection name}}
249 This command works the like |\subsection|. However, subsubsections are supported less well than subsections. For example, in the table of contents subsubsections are always shown with the same shading/hiding parameters as the subsection.
250
251 We \emph{strongly} discourage the use of subsubsections in presentations. If you do not use them, you will give a better presentation.
252
253 \example
254 |\subsubsection[Applications]{Applications to the Reduction of Pollution}|
255
256 \begin{element}{subsubsection in toc}\yes\yes\yes
257 Like |subsection in toc|, only for subsection.
258
259 In addition to the inserts for the |subsection in toc| template, the following commands are available for this template:
260 \begin{templateinserts}
261 \iteminsert{\inserttocsubsubsection}
262 inserts the table of contents version of the current subsubsection name.
263
264 \iteminsert{\inserttocsubsubsectionnumber}
265 inserts the number of the current subsubsection (in the table of contents).
266 \end{templateinserts}
267 \end{element}
268
269 \begin{element}{subsubsection in toc shaded}\yes\yes\yes
270 Like |subsection in toc shaded|, only for subsubsections.
271 \end{element}
272 \end{command}
273
274 \begin{command}{\subsubsection\sarg{mode specification}\declare{|*|}\marg{subsubsection name}}
275 Starts a subsubsection without an entry in the table of contents. No heading is created, but the \meta{subsubsection name} is shown in a possible sidebar.
276 \end{command}
277
278 Often, you may want a certain type of frame to be shown directly after a section or subsection starts. For example, you may wish every subsection to start with a frame showing the table of contents with the current subsection highlighted. To facilitate this, you can use the following commands.
279
280 \begin{command}{\AtBeginSection\oarg{special star text}\marg{text}}
281 The given text will be inserted at the beginning of every section. If the \meta{special star text} parameter is specified, this text will be used for starred sections instead. Different calls of this command will not ``add up'' the given texts (like the |\AtBeginDocument| command does), but will overwrite any previous text.
282
283 \example
284 \begin{verbatim}
285 \AtBeginSection[] % Do nothing for \section*
286 {
287 \begin{frame}<beamer>
288 \frametitle{Outline}
289 \tableofcontents[currentsection]
290 \end{frame}
291 }
292 \end{verbatim}
293
294 \articlenote
295 This command has no effect in |article| mode.
296
297 \end{command}
298
299 \begin{command}{\AtBeginSubsection\oarg{special star text}\marg{text}}
300 The given text will be inserted at the beginning of every subsection. If the \meta{special star text} parameter is specified, this text will be used for starred subsections instead. Different calls of this command will not ``add up'' the given texts.
301
302 \example
303 \begin{verbatim}
304 \AtBeginSubsection[] % Do nothing for \subsection*
305 {
306 \begin{frame}<beamer>
307 \frametitle{Outline}
308 \tableofcontents[currentsection,currentsubsection]
309 \end{frame}
310 }
311 \end{verbatim}
312 \end{command}
313
314 \begin{command}{\AtBeginSubsubsection\oarg{special star text}\marg{text}}
315 Like |\AtBeginSubsection|, only for subsubsections.
316 \end{command}
317
318 \beamer\ also provides |\sectionpage| and |\subsectionpage| commands, which are used to fill a frame with section or subsection number and title in a stylish way. They are very similar to |\partpage| command described below.
319
320 \begin{command}{\sectionpage}
321 This command shows a frame with the section number and title of the current section.
322 \example
323 \begin{verbatim}
324 \section{A section}
325
326 \begin{frame}
327 \sectionpage
328 \end{frame}
329
330 \begin{frame}
331 Some text.
332 \end{frame}
333 \end{verbatim}
334
335 \begin{element}{section page}\yes\no\no
336 This template is invoked when the |\sectionpage| command is used.
337
338 \begin{templateoptions}
339 \itemoption{default}{\oarg{alignment}}
340 The section page is typeset showing the current section number and, below, the current section title. The templates
341 \begin{element}{section name}\no\yes\yes
342 \end{element}
343 and
344 \begin{element}{section title}\no\yes\yes
345 \end{element}
346 are used, including the background color of |section title|. As for the |title page| template, the \meta{alignment} option is passed on the |beamercolorbox|.
347 \end{templateoptions}
348
349 The following commands are useful for this template:
350 \begin{templateinserts}
351 \iteminsert{\insertsection}
352 inserts the title of the current section.
353 \iteminsert{\insertsectionnumber}
354 inserts the current section number.
355 \end{templateinserts}
356 \end{element}
357 \end{command}
358
359 \begin{command}{\subsectionpage}
360 Works the same way as the |\sectionpage|.
361 \begin{element}{subsection page}\yes\no\no
362 \begin{templateoptions}
363 \itemoption{default}{\oarg{alignment}}
364
365 The templates
366 \begin{element}{subsection name}\no\yes\yes
367 \end{element}
368 and
369 \begin{element}{subsection title}\no\yes\yes
370 \end{element}
371 are used, including the background color of |subsection title|. As for the |title page| template, the \meta{alignment} option is passed on the |beamercolorbox|.
372 \end{templateoptions}
373
374 The following commands are useful for this template:
375 \begin{templateinserts}
376 \iteminsert{\insertsubsection}
377 inserts the title of the current subsection.
378 \iteminsert{\insertsubsectionnumber}
379 inserts the current subsection number.
380 \end{templateinserts}
381 \end{element}
382 \end{command}
383
384 \subsection{Adding Parts}
385
386 If you give a long talk (like a lecture), you may wish to break up your talk into several parts. Each such part acts like a little ``talk of its own'' with its own table of contents, its own navigation bars, and so on. Inside one part, the sections and subsections of the other parts are not shown at all.
387
388 To create a new part, use the |\part| command. All sections and subsections following this command will be ``local'' to that part. Like the |\section| and |\subsection| command, the |\part| command does not cause any frame or special text to be produced. However, it is often advisable for the start of a new part to use the command |\partpage| to insert some text into a frame that ``advertises'' the beginning of a new part.
389
390 \begin{command}{\part\sarg{mode specification}\oarg{short part name}\marg{part name}}
391 Starts a part. The \meta{part name} will be shown when the |\partpage| command is used. The \meta{short part name} is not shown anywhere by default, but it is accessible via the command |\insertshortpart|.
392 \example
393 \begin{verbatim}
394 \begin{document}
395 \begin{frame}
396 \titlepage
397 \end{frame}
398
399 \section*{Outlines}
400 \subsection{Part I: Review of Previous Lecture}
401 \begin{frame}
402 \frametitle{Outline of Part I}
403 \tableofcontents[part=1]
404 \end{frame}
405 \subsection{Part II: Today's Lecture}
406 \begin{frame}
407 \frametitle{Outline of Part II}
408 \tableofcontents[part=2]
409 \end{frame}
410
411 \part{Review of Previous Lecture}
412 \begin{frame}
413 \partpage
414 \end{frame}
415 \section[Previous Lecture]{Summary of the Previous Lecture}
416 \subsection{Topics}
417 \begin{frame}...\end{frame}
418 \subsection{Learning Objectives}
419 \begin{frame}...\end{frame}
420
421 \part{Today's Lecture}
422 \begin{frame}
423 \partpage
424 \end{frame}
425 \section{Topic A}
426 \begin{frame}
427 \tableofcontents[currentsection]
428 \end{frame}
429 \subsection{Foo}
430 \begin{frame}...\end{frame}
431 \section{Topic B}
432 \begin{frame}
433 \tableofcontents[currentsection]
434 \end{frame}
435 \subsection{bar}
436 \begin{frame}...\end{frame}
437 \end{document}
438 \end{verbatim}
439 \end{command}
440
441 \begin{command}{\partpage}
442 Works like |\titlepage|, only that the current part, not the current presentation is ``advertised.''
443 \example
444 |\begin{frame}\partpage\end{frame}|
445
446 \begin{element}{part page}\yes\no\no
447 This template is invoked when the |\partpage| command is used.
448
449 \begin{templateoptions}
450 \itemoption{default}{\oarg{alignment}}
451 The part page is typeset showing the current part number and, below, the current part title. The templates
452 \begin{element}{part name}\no\yes\yes
453 \end{element}
454 and
455 \begin{element}{part title}\no\yes\yes
456 \end{element}
457 are used, including the background color of |part title|. As for the |title page| template, the \meta{alignment} option is passed on the |beamercolorbox|.
458 \end{templateoptions}
459
460 The following commands are useful for this template:
461 \begin{templateinserts}
462 \iteminsert{\insertpart}
463 inserts the current part name.
464 \iteminsert{\insertpartnumber}
465 inserts the current part number as an Arabic number into a template.
466 \iteminsert{\insertromanpartnumber}
467 inserts the current part number as a Roman number into a template.
468 \end{templateinserts}
469 \end{element}
470 \end{command}
471
472 \begin{command}{\AtBeginPart\marg{text}}
473 The given text will be inserted at the beginning of every part.
474
475 \example
476 \begin{verbatim}
477 \AtBeginPart{
478 \begin{frame}
479 \partpage
480 \end{frame}
481 }
482 \end{verbatim}
483 \end{command}
484
485
486 \subsection{Splitting a Course Into Lectures}
487
488 When using \beamer\ with the |article| mode, you may wish to have the lecture notes of a whole course reside in one file. In this case, only a few frames are actually part of any particular lecture.
489
490 The |\lecture| command makes it easy to select only a certain set of frames from a file to be presented. This command takes (among other things) a label name. If you say |\includeonlylecture| with this label name, then only the frames following the corresponding |\lecture| command are shown. The frames following other |\lecture| commands are suppressed.
491
492 By default, the |\lecture| command has no other effect. It does not create any frames or introduce entries in the table of contents. However, you can use |\AtBeginLecture| to have \beamer\ insert, say, a title page at the beginning of (each) lecture.
493
494 \begin{command}{\lecture\oarg{short lecture name}\marg{lecture name}\marg{lecture label}}
495 Starts a lecture. The \meta{lecture name} will be available via the |\insertlecture| command. The \meta{short lecture name} is available via the |\insertshortlecture| command.
496
497 \example
498 \begin{verbatim}
499 \begin{document}
500 \lecture{Vector Spaces}{week 1}
501
502 \section{Introduction}
503 ...
504 \section{Summary}
505
506 \lecture{Scalar Products}{week 2}
507
508 \section{Introduction}
509 ...
510 \section{Summary}
511
512 \end{document}
513 \end{verbatim}
514
515 \articlenote
516 This command has no effect in |article| mode.
517 \end{command}
518
519 \begin{command}{\includeonlylecture\meta{lecture label}}
520 Causes all |\frame|, |frame|, |\section|, |\subsection|, and |\part| commands following a |\lecture| command to be suppressed, except if the lecture's label matches the \meta{lecture label}. Frames before any |\lecture| commands are always included. This command should be given in the preamble.
521
522 \example
523 |\includeonlylecture{week 1}|
524
525 \articlenote
526 This command has no effect in |article| mode.
527 \end{command}
528
529 \begin{command}{\AtBeginLecture\marg{text}}
530 The given text will be inserted at the beginning of every
531 lecture.
532
533 \example
534 \begin{verbatim}
535 \AtBeginLecture{
536 \begin{frame}
537 \Large Today's Lecture: \insertlecture
538 \end{frame}
539 }
540 \end{verbatim}
541
542 \articlenote
543 This command has no effect in |article| mode.
544 \end{command}
545
546
547 \subsection{Adding a Table of Contents}
548
549 You can create a table of contents using the command |\tableofcontents|. Unlike the normal \LaTeX\ table of contents command, this command takes an optional parameter in square brackets that can be used to create certain special effects.
550
551 \begin{command}{\tableofcontents\oarg{comma-separated option list}}
552 Inserts a table of contents into the current frame.
553
554 \example
555 \begin{verbatim}
556 \section*{Outline}
557 \begin{frame}
558 \tableofcontents
559 \end{frame}
560
561 \section{Introduction}
562 \begin{frame}
563 \tableofcontents[currentsection]
564 \end{frame}
565 \subsection{Why?}
566 \begin{frame}...\end{frame}
567 \begin{frame}...\end{frame}
568 \subsection{Where?}
569 \begin{frame}...\end{frame}
570
571 \section{Results}
572 \begin{frame}
573 \tableofcontents[currentsection]
574 \end{frame}
575 \subsection{Because}
576 \begin{frame}...\end{frame}
577 \subsection{Here}
578 \begin{frame}...\end{frame}
579 \end{verbatim}
580
581 The following options can be given:
582 \begin{itemize}
583 \item
584 \declare{|currentsection|} causes all sections but the current to be shown in a semi-transparent way. Also, all subsections but those in the current section are shown in the semi-transparent way. This command is a shorthand for specifying the following options:
585
586 \begin{verbatim}
587 sectionstyle=show/shaded,subsectionstyle=show/show/shaded
588 \end{verbatim}
589 \item
590 \declare{|currentsubsection|} causes all subsections but the current subsection in the current section to be shown in a semi-transparent way. This command is a shorthand for specifying the option |subsectionstyle=show/shaded|.
591 \item
592 \declare{|firstsection=|\meta{section number}} specifies which section should be numbered as section~``1.'' This is useful if you have a first section (like an overview section) that should not receive a number. Section numbers are not shown by default. To show them, you must install a different table of contents templates.
593 \item
594 \declare{|hideallsubsections|} causes all subsections to be hidden. This command is a shorthand for specifying the option |subsectionstyle=hide|.
595 \item
596 \declare{|hideothersubsections|} causes the subsections of sections other than the current one to be hidden. This command is a shorthand for specifying the option |subsectionstyle=show/show/hide|.
597 \item
598 \declare{|lastsection=|\meta{section number}} similar to |firstsection|, this option specifies which section should be the last numbered section. This is useful if you have unnumbered sections at the end, like a summary or outlook. Section numbers are not shown by default. To show them, you must install a different table of contents templates.
599 \item
600 \declare{|part=|\meta{part number}} causes the table of contents of part \meta{part number} to be shown, instead of the table of contents of the current part (which is the default). This option can be combined with the other options, although combining it with the |current| option obviously makes no sense.
601 \item
602 \declare{|pausesections|} causes a |\pause| command to be issued before each section. This is useful if you wish to show the table of contents in an incremental way.
603 \item
604 \declare{|pausesubsections|} causes a |\pause| command to be issued before each subsection.
605 \item
606 \declare{|sections=|\marg{overlay specification}} causes only the sections mentioned in the \meta{overlay specification} to be shown. For example, \verb/sections={<2-4| handout:0>}/ causes only the second, third, and fourth section to be shown in the normal version, nothing to be shown in the handout version, and everything to be shown in all other versions. For convenience, if you omit the pointed brackets, the specification is assumed to apply to all versions. Thus |sections={2-4}| causes sections two, three, and four to be shown in all versions.
607 \item
608 \declare{|sectionstyle=|\meta{style for current section}|/|\meta{style for other sections}} specifies how sections should be displayed. Allowed \meta{styles} are |show|, |shaded|, and |hide|. The first will show the section title normally, the second will show it in a semi-transparent way, and the third will completely suppress it. You can also omit the second style, in which case the first is used for all sections (this is not really useful).
609 \item
610 \declare{|subsectionstyle=|\meta{style for current subsection}|/|\meta{style for other subsections in current section}|/|\\\meta{style for subsections in other sections}} specifies how subsections should be displayed. The same styles as for the |sectionstyle| option may be given. You can omit the last style, in which case the second also applies to the last, and you can omit the last two, in which case the first applies to all.
611 \example
612 |subsectionstyle=shaded| causes all subsections to be shaded.
613 \example
614 |subsectionstyle=hide| causes all subsections to be hidden.
615 \example
616 |subsectionstyle=show/shaded| causes all subsections but the current subsection in the current section to be shown in a semi-transparent way.
617 \example
618 |subsectionstyle=show/show/hide| causes all subsections outside the current section to be suppressed.
619 \example
620 |subsectionstyle=show/shaded/hide| causes all subsections outside the current section to be suppressed and only the current subsection in the current section to be highlighted.
621 \item
622 \declare{|subsubsectionstyle=|\meta{style for current subsubsection}|/|\meta{style for other subsubsections in current subsection}|/|\\\meta{style for subsubsections in other subsections in current section}|/|\meta{style for subsubsections in other subsections in other sections}} specifies how subsubsections should be displayed.
623 The same styles as for the |sectionstyle| option may be given. You can omit styles from the end of the list, in which case the last given style will also be applied to the omitted styles.
624 This option operates in an analogous manner to |subsectionstyle|.
625 \end{itemize}
626
627 The last examples are useful if you do not wish to show too many details when presenting the talk outline.
628
629 \articlenote
630 The options are ignored in |article| mode.
631
632 \begin{element}{sections/subsections in toc}\semiyes\no\no
633 This is a parent template, whose children are |section in toc| and |subsection in toc|. This means that if you use the |\setbeamertemplate| command on this template, the command is instead called for both of these children (with the same arguments).
634
635 \begin{templateoptions}
636 \itemoption{default}{}
637 In the default setting, the sections and subsections are typeset using the fonts and colors |section in toc| and |subsection in toc|, though the background colors are ignored. The subsections are indented.
638 \itemoption{sections numbered}{}
639 Similar to the default setting, but the section numbers are also shown. The subsections are not numbered.
640 \itemoption{subsections numbered}{}
641 This time, the subsections are numbered, but not the sections. Nevertheless, since the subsections are ``fully numbered'' as in ``1.2'' or ``3.2,'' if every section has at least one subsection, the section numbered will not really be missed.
642 \itemoption{circle}{}
643 Draws little circles before the sections. Inside the circles the section number is shown. The \beamer-font and color |section number projected| is used for typesetting the circles, that is, the circle gets the background color and the text inside the circle the foreground color.
644 \itemoption{square}{}
645 Similar to the |circle| option, except that small squares are used instead of circles. Small, unnumbered squares are shown in front of the subsections.
646 \itemoption{ball}{}
647 Like |square|, the only difference being the balls are used instead of squares.
648 \itemoption{ball unnumbered}{}
649 Similar to |ball|, except that no numbering is used. This option makes the table of contents look more like an |itemize|.
650 \end{templateoptions}
651
652 If none of the above options suits you, you have to change the templates |section in toc| and |subsection in toc| directly.
653 \end{element}
654
655 \begin{element}{sections/subsections in toc shaded}\semiyes\no\no
656 A parent template with children |section in toc shaded| and |subsection in toc shaded|. They are used to render section and subsection entries when they are currently shaded; like all non-current subsections in |\tableofcontents[currentsubsection]|.
657
658 \begin{templateoptions}
659 \itemoption{default}{\oarg{opaqueness}}
660 In the default setting, the templates |section in toc shaded| and |subsection in toc shaded| just show whatever the nonshaded versions of these templates show, but only \meta{opaqueness}\% opaque. The default is 20\%.
661
662 \example
663 |\setbeamertemplate{section in toc shaded}[default][50]| makes dimmed entries 50\% transparent.
664 \end{templateoptions}
665 \end{element}
666 \end{command}
667
668
669 \subsection{Adding a Bibliography}
670
671 You can use the bibliography environment and the |\cite| commands of \LaTeX\ in a \beamer\ presentation. You will typically have to typeset your bibliography items partly ``by hand.'' Nevertheless, you \emph{can} use |bibtex| to create a ``first approximation'' of the bibliography. Copy the content of the file |main.bbl| into your presentation. If you are not familiar with |bibtex|, you may wish to consult its documentation. It is a powerful tool for creating high-quality citations.
672
673 Using |bibtex| or your editor, place your bibliographic references in the environment |thebibliography|. This (standard \LaTeX) environment takes one parameter, which should be the longest |\bibitem| label in the following list of bibliographic entries.
674
675 \begin{environment}{{thebibliography}\marg{longest label text}}
676 Inserts a bibliography into the current frame. The \meta{longest label text} is used to determine the indentation of the list. However, several predefined options for the typesetting of the bibliography ignore this parameter since they replace the references by a symbol.
677
678 Inside the environment, use a (standard \LaTeX) |\bibitem| command for each reference item. Inside each item, use a (standard \LaTeX) |\newblock| command to separate the authors' names, the title, the book/journal reference, and any notes. Each of these commands may introduce a new line or color or other formatting, as specified by the template for bibliographies.
679
680 The environment must be placed inside a frame. If the bibliography does not fit on one frame, you should split it (create a new frame and a second |thebibliography| environment) or use the |allowframebreaks| option. Even better, you should reconsider whether it is a good idea to present so many references.
681
682 \example
683 \begin{verbatim}
684 \begin{frame}
685 \frametitle{For Further Reading}
686
687 \begin{thebibliography}{Dijkstra, 1982}
688 \bibitem[Salomaa, 1973]{Salomaa1973}
689 A.~Salomaa.
690 \newblock {\em Formal Languages}.
691 \newblock Academic Press, 1973.
692
693 \bibitem[Dijkstra, 1982]{Dijkstra1982}
694 E.~Dijkstra.
695 \newblock Smoothsort, an alternative for sorting in situ.
696 \newblock {\em Science of Computer Programming}, 1(3):223--233, 1982.
697 \end{thebibliography}
698 \end{frame}
699 \end{verbatim}
700
701 Four templates govern the appearance of the author, title, journal, and note text. These author templates are inserted before the first block of the entry (the first block is all text before the first occurrence of a |\newblock| command). The title template is inserted before the second block (the text between the first and second occurrence of |\newblock|). Likewise for the journal and note templates.
702
703 The templates are inserted \emph{before} the blocks and you do not have access to the blocks themselves via insert commands. The corresponding \beamer-color and -font are also installed before the blocks.
704
705 \begin{element}{bibliography entry author}\yes\yes\yes
706 This template is inserted before the author of a bibliography entry. The color and font are also installed. Note that the effect of this template will persist until the end of the bibliography item or until one of the following templates undo the effect.
707
708 By default, this template does nothing. The default color is the structure color.
709 \end{element}
710
711 \begin{element}{bibliography entry title}\yes\yes\yes
712 This template is inserted before the title of a bibliography entry (more precisely, it is inserted after the first occurrence of the |\newblock| command). By default, this template starts a new paragraph, causing a line break. The default color is the normal text color.
713 \end{element}
714
715 \begin{element}{bibliography entry location}\yes\yes\yes
716 This template is inserted before the journal of a bibliography entry (the second |\newblock|). By default, this template starts a new paragraph. The default color is a slightly transparent version of the structure color.
717 \end{element}
718
719 \begin{element}{bibliography entry note}\yes\yes\yes
720 This template is inserted before any note text at the end of a bibliography entry (it is inserted before the third |\newblock|). By default, this template starts a new paragraph. The default color is the same as for the journal.
721 \end{element}
722 \end{environment}
723
724 \begin{command}{\bibitem\sarg{overlay specification}\oarg{citation text}\marg{label name}}
725 The \meta{citation text} is inserted into the text when the item is cited using |\cite{|\meta{label name}|}| in the main presentation text. For a \beamer\ presentation, this should usually be as long as possible.
726
727 Use |\newblock| commands to separate the authors's names, the title, the book/journal reference, and any notes. If the \meta{overlay specification} is present, the entry will only be shown on the specified slides.
728
729 \example
730 \begin{verbatim}
731 \bibitem[Dijkstra, 1982]{Dijkstra1982}
732 E.~Dijkstra.
733 \newblock Smoothsort, an alternative for sorting in situ.
734 \newblock {\em Science of Computer Programming}, 1(3):223--233, 1982.
735 \end{verbatim}
736
737 \begin{element}{bibliography item}\yes\yes\yes
738 \colorfontparents{item}
739 This template is used to render the bibliography item. Unlike normal \LaTeX, the default template for the bibliography does not repeat the citation text (like ``[Dijkstra, 1982]'') before each item in the bibliography. Instead, a cute, small article symbol is drawn. The rationale is that the audience will not be able to remember any abbreviated citation texts till the end of the
740 talk.
741 \begin{templateoptions}
742 \itemoption{default}{}
743 Draws a cute little article icon as the reference. Use this for journal articles, parts of books (like conference proceedings), or technical reports.
744
745 \itemoption{article}{}
746 Alias for the default.
747
748 \itemoption{book}{}
749 Draws a cute little book icon as the reference. Use this for, well, books.
750
751 \itemoption{online}{}
752 Draws a cute little globe icon as the reference. Use this for websites and the like.
753
754
755 \itemoption{triangle}{}
756 Draws a triangle as the reference. This is more in keeping with the standard itemize items.
757
758 \itemoption{text}{}
759 Uses the reference text (like ``[Dijkstra, 1982]'') as the reference text. Be sure you know what you are doing if you use this.
760 \end{templateoptions}
761 The following insert is useful for the template:
762 \begin{itemize}
763 \iteminsert{\insertbiblabel}
764 inserts the current citation label.
765 \end{itemize}
766 \end{element}
767 \end{command}
768
769
770 \subsection{Adding an Appendix}
771
772 You can add an appendix to your talk by using the |\appendix| command. You should put frames and perhaps whole subsections into the appendix that you do not intend to show during your presentation, but which might be useful to answer a question. The |\appendix| command essentially just starts a new part named |\appendixname|. However, it also sets up certain hyperlinks. Like other parts, the appendix is kept separate from your actual talk.
773
774 \begin{command}{\appendix\sarg{mode specification}}
775 Starts the appendix in the specified modes. All frames, all |\subsection| commands, and all |\section| commands used after this command will not be shown as part of the normal navigation bars.
776 \example
777 \begin{verbatim}
778 \begin{document}
779 \begin{frame}
780 \titlepage
781 \end{frame}
782 \section*{Outline}
783 \begin{frame}
784 \tableofcontents
785 \end{frame}
786 \section{Main Text}
787 \begin{frame}
788 Some text
789 \end{frame}
790 \section*{Summary}
791 \begin{frame}
792 Summary text
793 \end{frame}
794
795 \appendix
796 \section{\appendixname}
797 \begin{frame}
798 \tableofcontents
799 \end{frame}
800 \subsection{Additional material}
801 \begin{frame}
802 Details
803 \end{frame}
804 \begin{frame}
805 Text omitted in main talk.
806 \end{frame}
807 \subsection{Even more additional material}
808 \begin{frame}
809 More details
810 \end{frame}
811 \end{document}
812 \end{verbatim}
813 \end{command}