summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/talk/talkdoc.tex
blob: cc633b52ef4f1a92daee49a8ae60aa3dabda7f63 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
%% talkdoc -- (talkdoc.tex) documentation
%% The documentation for the talk class
%% Author: Martin Wiebusch
%%
%% This file may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
%%    http://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2003/12/01 or later.

\documentclass[12pt]{ltxdoc}
\usepackage[small,bf]{caption}
\usepackage{mdwtab}\setlength{\doublerulesep}{0pt}

\addtolength{\oddsidemargin}{0.5in}

\newcommand{\ccmd}[1]{\texttt{\symbol{`\\}\symbol{`@}#1}}

\newcommand{\mref}[2]{\textsl{#1\space\ref{#2}}}
\newcommand{\mrefs}[1]{\textsl{#1}}

\newcommand{\pkg}[1]{\textsf{#1}}
\newcommand{\var}[1]{\textrm{$\langle$\textit{#1}$\rangle$}}
\newcommand{\txt}[1]{\textrm{#1}}

\setlength{\parskip}{\medskipamount}

\renewenvironment{quote}{\list{}{\leftmargin\parindent}\item[]}{\endlist}

\title{The \pkg{talk} Document Class\thanks{This file has version number 1.0,
    last revised 2005/08/09}}
\author{Martin Wiebusch}

\sloppy

\begin{document}
\maketitle
\begin{abstract}
  The \pkg{talk} document class allows you to create slides for screen
  presentations or printing on transparencies. It also allows you to print
  personal notes for your talk. You can create overlays and display structure
  information (current section / subsection, table of contents) on your slides.
  The main feature that distinguishes \pkg{talk} from other presentation classes
  like \pkg{beamer} or \pkg{prosper} is that it allows the user to define an
  arbitrary number of \emph{slide styles} and switch between these styles from
  slide to slide. This way the slide layout can be adapted to the slide
  content. For example, the title or contents page of a talk can be given a
  slightly different layout than the other slides.

  The \pkg{talk} class makes no restrictions on the slide design whatsoever. The
  entire look and feel of the presentation can be defined by the user. The style
  definitions should be put in a separate sty file. Currently the package comes
  with only one set of pre-defined slide styles (sidebars.sty). Contributions
  from people who are artistically more gifted than me are more than welcome!
\end{abstract}
\newpage
\tableofcontents
%
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Installation and Requirements}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%
The \pkg{talk} class requires the packages \pkg{amsmath}, \pkg{pgf} version 1.18
or above, \pkg{multido} and \pkg{hyperref}. They can all be obtained from
\begin{quote}
  |http://www.ctan.org|.
\end{quote}

To install the \pkg{talk} class, you have to copy the files |talk.cls| and
|sidebars.sty| to a place where \LaTeX\ can find them.
%
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Using \pkg{talk}}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%
The usage of the \pkg{talk} class is almost independent of the chosen style
definitions. Therefore style definitions are most conveniently included through
separate \emph{style packages}. Currently \pkg{talk} comes with one such file
called |sidebars.sty|. (I hope that in the future the number of available style
packages will grow due to contributions from people that are artistically more
gifted than I am.) The issue of writing your own style definitions is discussed
in \mref{section}{sec:styles}. In this section we will see how to create a
presentation using the \pkg{talk} class and some ready-to-use style package like
|sidebars.sty|.

\begin{figure}
  \begin{quote}
    |\documentclass[|\var{options}|]{talk}|\\
    |\usepackage{|\var{style-def}|}|\\
    $\vdots$\\
    \txt{(more package inclusions)}\\
    $\vdots$\\
    |\title{|\var{title}|}|\\
    |\author{|\var{author}|}|\\
    |\date{|\var{date}|}|\\
    $\vdots$\\
    \txt{(global specifications required by \var{style-def})}\\
    $\vdots$\\
    |\begin{document}|\\
    |  \begin{slide}[|\var{slide-style}|]{|\var{slide-title}|}|\\
    |    |\txt{(body of first slide)}\\
    |  \end{slide}|\\
    |  \begin{notes}|\\
    |    |\txt{(notes on first slide)}\\
    |  \end{notes}|\\
    |  |$\vdots$\\
    |  |\txt{(more slides and notes)}\\
    |  |$\vdots$\\
    |  \section[|\var{short title}|]{|\var{long title}|}|\\
    |  |$\vdots$\\
    |  |\txt{(more slides and notes)}\\
    |  |$\vdots$\\
    |  \subsection[|\var{short title}|]{|\var{long title}|}|\\
    |  |$\vdots$\\
    |  |\txt{(more slides and notes)}\\
    |  |$\vdots$\\
    |  |\txt{(more sections and subsections)}\\
    |  |$\vdots$\\
    |\end{document}|
  \end{quote}
  \caption{\label{fig:structure} The general structure of a presentation
    \texttt{tex} file.}
\end{figure}
The general structure of a presentation |tex| file is shown in
\mref{figure}{fig:structure}. Note that you can structure your talk in the
usual way with |\section| and |\subsection| commands. How these commands are
handled depends on the loaded style package.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Class Options}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\label{ssec:options}
The \pkg{talk} class is loaded in the first line of the listing in
\mref{figure}{fig:structure}:
\begin{quote}
  |\documentclass[|\var{options}|]{talk}|
\end{quote}
The available options are
\begin{center}
  |screen|, |slides|, |notes|, |rotate| and |norotate|.
\end{center}
The \pkg{talk} class is built upon the |article| class, so it will pass all
unknown options to |article|. Thus, in principle, all options of the |article|
class can be used with the \pkg{talk} class as well. However, some options like
|twocolumn| etc.\ may lead to undesired results.

The options |screen|, |slides| and |notes| determine the \emph{mode}
in which your presentation is compiled. The options |rotate| and
|norotate| only take effect in the |slides| mode.

\DescribeMacro{screen}
Use the |screen| mode to create a screen presentation. With this option
the paper size is set to the slide size, so that your slides can be displayed
without white margins using the fullscreen mode of your favorite document
viewer.

\DescribeMacro{slides\\rotate\\norotate}
If you use the |slides| mode your presentation is prepared for printout on
transparencies. The slides are centered horizontally and vertically on normal
paper. The default paper size is A4, but you can change it by using any of the
paper size options of the |article| class. The options |rotate| and
|norotate| determine whether or not the slides are rotated by 90 degrees in
counterclockwise direction. By default rotation is enabled.
\DescribeMacro{\slidesmag}
In |slides| mode the slides can also be magnified. You can set the magnification
factor with
\begin{quote}
  |\slidesmag{|\var{factor}|}|.
\end{quote}

\DescribeMacro{notes}
The |notes| mode allows you to print personal notes for your presentation. In
this mode the slides are inserted in the flowing text, between your annotations.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Style Packages and Slide Styles}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
Style definitions for the \pkg{talk} class are most conveniently included
through a separate \emph{style package}. Style packages can be included with the
usual |\usepackage| command:
\begin{quote}
  |\usepackage[|\var{package-options}|]{|\var{style-package}|}|.
\end{quote}
The available package options depend on the chosen style package. The principal
task of a \pkg{talk} style package is to set the width and height of the slides
and define a number of \emph{slide styles}. To identify the different slide
styles, the style package should give them \emph{style names} like |title|,
|framed|, |sidebar|, |plain|, etc.  \DescribeMacro{\slidestyle} To switch
between different slide styles you can use the command
\begin{quote}
  |\slidestyle{|\var{style-name}|}|.
\end{quote}
To change the slide style for only one slide you can pass a style name as an
optional argument to the |slide| or |multislide| environment.

\DescribeMacro{sidebars} The |sidebars| package has one option, |compress|,
which affects the way in which the table of contents is displayed in the
sidebar. It defines three slide styles called |plain|, |outline| and
|normal|. The |plain| style has no decorations at all and can be used for the
title page or for showing large pictures. The |outline| style is designed to
show the structure of your talk. Use it, for example, for the contents page.
The |normal| style should be used for all other slides. It has a sidebar showing
the structure of your talk. The current section is highlighted.

\DescribeMacro{\backgroundcolor}%
\DescribeMacro{\sidebarcolor}%
\DescribeMacro{\titlecolor}%
\DescribeMacro{\sidebartitlecolor}%
\DescribeMacro{\highlightcolor}%
Colours can be set with the commands listed in \mref{table}{tab:colorcmds}.
their syntax is
\begin{quote}
  |\|\var{color-command}|{|\var{red-value}|,|\var{green-value}|,|%
     \var{blue-value}|}|
\end{quote}
where \var{color-command} is one of the commands listed in
\mref{table}{tab:colorcmds} and \var{red-value}, \var{green-value} and
\var{blue-value} are numbers between 0 and 1.
\begin{table}
  \centering
  \begin{tabular}{lp{3in}}
    \hlx{hhv[1pt]}
    Command & Effect \\
    \hlx{hv[1pt]}
    |\backgroundcolor|   & sets the colour of the slide background\\
    |\sidebarcolor|      & sets the colour of the sidebar\\
    |\titlecolour|       & sets the colour of the slide title\\
    |\sidebartitlecolor| & sets the colour of the sidebar title\\
    |\highlightcolor|    & sets the colour of highlighted sections and
                           subsections in the sidebar\\
    \hlx{hh}
  \end{tabular}
  \caption{\label{tab:colorcmds}The colour commands of the \pkg{sidebars}
    package}
\end{table}
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Global Specifications}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\DescribeMacro{\title}\DescribeMacro{\author}\DescribeMacro{\date}
Like the |article| class, \pkg{talk} allows you to specify the title, author
and date of your talk with the commands
\begin{quote}
  |\title[|\var{short-title}|]{|\var{title}|}|\\
  |\author[|\var{short-author}|]{|\var{author}|}|\\
  |\date{|\var{date}|}|
\end{quote}
In what context the short versions \var{short-title} and \var{short-author} are
used depends on the style package. The \pkg{sidebars} package displays
\var{short-title} and \var{short-author} in the side bar.  Other style packages
may also define addtitional commands, that allow you to specify additional
information like institute, logo, place where the talk was given etc.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Environments}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
The \pkg{talk} class defines three environments: |slide|, |multislide| and
|notes|.  All typeset material in your talk should be enclosed in one of these
environments.

\DescribeMacro{slide}
The |slide| environment is the most important environment in the \pkg{talk}
class.  It allows you to typeset the contents of your slides. Its syntax is:
\begin{quote}
  |\begin{slide}[|\var{style-name}|]{|\var{slide-title}|}|\\
  |  |\txt{(slide body)}\\  |\end{slide}|
\end{quote}
The \var{style-name} argument is optional. It must be the name of one of the
slide styles defined in style package you have loaded. For the |sidebars|
package the available slide styles are |plain|, |outline| and |normal|. If no
\var{style-name} argument is given, \pkg{talk} uses the slide style specified in
the last call of the |\slidestyle| command.

\DescribeMacro{notes}
The |notes| environment allows you to include annotations to your slides in
the |tex| file. The contents of the |notes| environment are ignored if you
compile your presentation in the |screen| or |slides| mode.

\DescribeMacro{multislide}
The |multislide| environment can be used to create overlays. Its syntax is:
\begin{quote}
  |\begin{multislide}[|\var{style-name}|]{|\var{sub-slides}|}|%
                                        |{|\var{slide-title}|}|\\
  |  |\txt{(slide body)}\\
  |\end{multislide}|
\end{quote}
As for the |slide| environment the optional \var{style-name} argument and the
\var{slide-title} argument specify the slide style and the slide title. The
\var{sub-slides} argument has to be an integer number greater than zero. It
specifies the number of sub-slides, that the |multislide| environment will
generate. In the body of the |multislide| environment, you can use the commands
|\fromslide|, |\toslide| and |\onlyslide| to specify which material goes on
which sub-slide. 

\DescribeMacro{\fromslide}\DescribeMacro{\toslide}\DescribeMacro{\onlyslide}
The syntax of the commands |\fromslide|, |\toslide| and |\onlyslide| is:
\begin{quote}
  |\fromslide*{|$n$|}{|\var{material}|}|\\
  |\toslide*{|$n$|}{|\var{material}|}|\\
  |\onlyslide*{|$n$|}{|\var{material}|}|
\end{quote}
The |\fromslide*| command ignores \var{material} on the first $n-1$ sub-slides.
The |\toslide*| command ignores \var{material} on all sub-slides after the
$n$-th. The |\onlyslide*| command ignores \var{material} on all sub-slides exept
the $n$-th. If you use the unstarred commands |\fromslide|, |\toslide| and
|\onlyslide| the \var{material} is not ignored but made invisible, so that it
still uses up the space (pretty much like the |\phantom| command).
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Title and Contents Pages}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\label{sec:toc}
Most talks begin with a title page showing the title of the talk, the name of
the speaker and possibly additional information like the date and place where
the talk is given, the institute of the speaker etc. For long talks you'll also
want to show the stucture of your talk at the beginning.

\DescribeMacro{\maketitle}\DescribeMacro{\tableofcontents}
Style packages for the \pkg{talk} class should therefore redefine the standard
\LaTeX\ commands |\maketitle| and |\tableofcontents| in such a way that they
produce suitable title and contents pages. These commands should be used in the
body of a slide environment. For example, with the |sidebars| style package
you would create title and contents pages by writing
\begin{quote}
  |\begin{slide}[plain]{}|\\
  |  \maketitle|\\
  |\end{slide}|
\end{quote}
and
\begin{quote}
  |\begin{slide}[outline]{Contents}|\\
  |  \tableofcontents|\\
  |\end{slide}|
\end{quote}

For some talks the table of contents may not fit on one slide. The \pkg{talk}
class cannot break material into multiple slides automatically, but it allows
you to split the table of contents manually.  To do this you can pass an
optional argument to the |\tableofcontents| command, which has the following
form:
\begin{quote}
  |\tableofcontents[|\var{fromsec}|.|\var{fromsubsec}%
                  |-|\var{tosec}|.|\var{tosubsec}|]|
\end{quote}
where \var{fromsec}, \var{fromsubsec}, \var{tosec} and \var{tosubsec} are
integer numbers. Their names are self-explaining. Note that the argument of
|\tableofcontents| must always have the form given above. If you wan to display
the sections 3 to 5 with all their subsections on one slide, you have to write
\begin{quote}
  |\tableofcontents[3.0-5.99]|
\end{quote}
(assuming that section 5 does not have more than 99 subsections).
%
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{The \pkg{talk} Class for Package Writers}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%
\label{sec:styles}
The entire look-and-feel of a \pkg{talk} presentation is determined by external
style packages. The macros provided by the \pkg{talk} class itself only take
care of more technical issues like
\begin{itemize}
  \item magnifying and positioning the slides on the paper,
  \item creating overlays,
  \item keeping a table of contents that is accessible on every slide,
  \item keeping a catalog of slide styles and allowing the user to switch
    between them.
\end{itemize}
To exploit these features, a style package writer needs to know some basic facts
about the inner workings of the \pkg{talk} class.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Mode Conditionals}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
As we have seen in \mref{section}{ssec:options} a \pkg{talk} presentation can be
compiled in three different modes: |slides|, |screen| and |notes|. To implement
mode-specific behaviour the \pkg{talk} class provides the following |if|
commands:
\DescribeMacro{\@ifslides}\DescribeMacro{\@ifscreen}\DescribeMacro{\@ifnotes}
\begin{quote}
  |\@ifslides{|\var{if-code}|}{|\var{else-code}|}|\\
  |\@ifscreen{|\var{if-code}|}{|\var{else-code}|}|\\
  |\@ifnotes{|\var{if-code}|}{|\var{else-code}|}|
\end{quote}
The \var{if-code} is executed if the talk is compiled in |slides|, |screen| or
|notes| mode, respectively, and the \var{else-code} is executed otherwise.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Slide Dimensions}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\DescribeMacro{\slidewidth}\DescribeMacro{\slideheight}
The width and height of the slides can be accessed through the |\slidewidth| and
|\slideheight| commands.
\DescribeMacro{\@slidesize}
However, to set the slide dimensions you should always use the command
\begin{quote}
  |\@slidesize{|\var{width}|}{|\var{height}|}|
\end{quote}
as it also adjusts the papersize and slide positioning.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Global Specifications}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\DescribeMacro{\@title}\DescribeMacro{\@author}\DescribeMacro{\@date}
The title, author and date set by the user with the |\title|, |\author| and
|\date| commands are stored in the macros |\@title|, |\@author| and |\@date|.
If you intend to display additional information like the speakers institute on
your slides you should define an |\institute| command in analogy to the commands
above:
\begin{quote}
  |\gdef\@institute{}|\\
  |\newcommand{\institute}[1]{\gdef\@institute{#1}}|
\end{quote}
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Counters}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\DescribeMacro{slide\\subslide}
In addition to the standard counters of the |article| class, \pkg{talk} defines
the counters |slide| and |subslide|. The number of the current slide is stored
in |slide|. The slides of a |multislide| environment have the same |slide|
number and different |subslide| numbers.

\DescribeMacro{\theslide}\DescribeMacro{\thesubslide}%
The commands |\theslide| and |\thesubslide| can be used to print the slide or
subslide number, respectively. They are defined as
\begin{quote}
  |\newcommand{\theslide}{\arabic{slide}}|\\
  |\newcommand{\thesubslide}{\theslide.\arabic{subslide}}|
\end{quote}
You can redefine them to change the way the slide and subslide numbers
are displayed

\DescribeMacro{\theslidelabel}
For printing labels on your slides you should use the |\theslidelabel|
command. It calls |\theslide| when you are in a |slide| environment and
|\thesubslide| when you are in a |multislide| environment. 
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Style Definitions}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
To change the look-and-feel of your slides you have to redefine some or all of
the following commands:
\begin{quote}
  |\@makeslide|\\
  |\@makeslidebackground|\\
  |\@makeslidecontent|\\
  |\@makenotesslide|\\
  |\@maketocsection|\\
  |\@maketocsubsection|
\end{quote}
These commands will be called by the |slide|, |multislide| and |notes|
environments. Their exact meaning will be explained later on.
\DescribeMacro{\@newslidestyle}
To create a \emph{named} slide style, you have to wrap a |\@newslidestyle|
command around your definitions. A typical style definition takes the form
\begin{quote}
  |\@newslidestyle{|\var{style-name}|}{|\\
  |  \renewcommand{\@makeslide}{|\var{stuff}|}|\\
  |  \renewcommand{\@makeslidebackground}{|\var{stuff}|}|\\
  |  \renewcommand{\@makeslidecontent}{|\var{stuff}|}|\\
  |  \renewcommand{\@makenotesslide}{|\var{stuff}|}|\\
  |  \renewcommand{\@maketocsection}[3]{|\var{stuff}|}|\\
  |  \renewcommand{\@maketocsubsection}[4]{|\var{stuff}|}|\\
  |}|
\end{quote}

The |\@newslidestyle| command simply dumps its second argument into a macro
called |\pres@sty@|\var{style-name}. When the style is loaded
with |\slidestyle{|\var{style-name}|}| or with the optional argument of the
|slide| environment, all the |\@make|\ldots\ commands are reset to their default
definitions. Then the macro |\pres@sty@|\var{style-name} is executed.

Note that the |\renewcommand| calls in the second argument of |\@newslidestyle|
appear in the definition of the |\pres@sty@|\var{style-name} command. Therefore
the arguments of |\@maketocsection| and |\@maketocsubsection| have to be
referenced with double hashes, for example
\begin{quote}
  |\@newslidestyle{|\var{style-name}|}{|\\
  |  \renewcommand{\@maketocsection}[3]{Section ##1: ##3}|\\
  |}|  
\end{quote}
Single hashes would refer to the arguments of |\pres@sty@|\var{style-name}.
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Typesetting Slides}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\DescribeMacro{\@slidetitle}\DescribeMacro{\@slidebody}
The |slide| and |multislide| environments store the slide title in the macro
|\@slidetitle| and the slide body in the macro |\@slidebody|. When you redefine
the various |\@make|\ldots\ commands you can therefore use |\@slidetitle| and
|\@slidebody| to insert the title and body of the current slide.

\DescribeMacro{\@makeslide} All the graphical wizardry in \pkg{talk} is done by
the \pkg{pgf} package.  To generate a slide the |slide| environment executes the
macro |\@makeslide| inside a |pgfpicture| environment. Before the call to
|\@makeslide| it executes several commands that set the bounding box of the
picture to a box of width |\slidewidth| and height |\slideheight| and scales and
rotates the picture in accordance with the on the compilation mode and class
options. The |\@makeslide| macro should therefore expand to a sequence of valid
\pkg{pgf} commands which draw the slide inside a box of width |\slidewidth| and
height |\slideheight|, with the origin located at the lower-left corner.
\DescribeMacro{\@slidebox} To obtain an LR box containing the properly
scaled and rotated slide you can use the |\@slidebox| macro.

\DescribeMacro{\@makenotesslide}
If you compile in the |notes| mode the |slide| and |multislide| environments
call |\@makenotesslide| to insert the current slide. By default the
|\@makenotesslide| command simply centers the |\@slidebox|
horizontally:
\begin{quote}
  |\newcommand{\@makenotesslide}{|\\
  |  \par\hspace*{\fill}\@slidebox\hspace*{\fill}\par|\\
  |}|
\end{quote}
You can change this behaviour by redefining the |\@makenotesslide| command. For
example, if you only want to print the title of each slide in your notes, you
should include something like
\begin{quote}
  |\renewcommand{\@makenotesslide}{|\\
  |  \begin{center}\textbf{\@slidetitle}\end{center}|\\
  |}|
\end{quote}
in your style definition.

To change the way the slides appear in the |screen| and |slides| mode you could
redefine the |\@makeslide| command. However, usually you'll want to draw the
slide background with \pkg{pgf} and then typeset the contents of the slide in a
minipage of width |\slidewidth| and height |\slideheight| placed on top of that
picture.
\DescribeMacro{\@makeslidebackground}\DescribeMacro{\@makeslidecontent}
Therefore the \pkg{talk} class provides two macros |\@makeslidebackground| and
|\@makeslidecontent| and a default definition for |\@makeslide| which does
exactly the above: It executes |\@makeslidebackground| inside a |pgfpicture|
environment, then covers the slide with a minipage of width |\slidewidth| and
height |\slideheight| and then executes the |\@makeslidecontent| inside the
minipage environment. Thus the |\@makeslidebackground| macro should expand to a
series of \pkg{pgf} commands that draw the background of the slide, with the
origin at the lower-left corner. The |\@makeslidecontent| macro should expand to
whatever you want to put in the minipage. Here, you start with the current point
in the upper left corner of the slide.

In this way \pkg{talk} gives you complete artistic freedom in the design of your
slides: It lets you define the macros that generate the slides while contents
like the slide title and body are previously stored in macros like
|\@slidetitle| and |\@slidebody|, so that you can insert them where you
like. For completeness we now summarise all commands yielding user defined
contents:
\begin{description}
  \item[\ccmd{slidetitle}] Title of the current slide.
  \item[\ccmd{slidebody}] Body of the current slide.
  \item[\texttt{\symbol{`\\}theslidelabel}] Label of the current slide. Shows
    the slide number in a |slide| environment and the slide and subslide number
    in a |multislide| environment.
  \item[\ccmd{title}] Title of the presentation.
  \item[\ccmd{shorttitle}] Short version of the title.
  \item[\ccmd{author}] Author of the presentation.
  \item[\ccmd{shortauthor}] Short version of the author.
  \item[\ccmd{date}] Date specified with the |\date| command (|\today| by
    default).
  \item[\ccmd{tableofcontents}] Prints the table of contents. See the next
    subsection for more information.
\end{description}
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{The Table of Contents}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\DescribeMacro{\@tableofcontents}
The table of contents of your talk can be created with the |\@tableofcontents|
macro. Its name is slightly misleading because, in fact, it allows you to
display any kind of structure information on your slides. For example, you can
use it to print only the title of the current section. 

\DescribeMacro{\@maketocsection}\DescribeMacro{\@maketocsubsection}
The |\@tableofcontents| macro expands to a series of |\@maketocsection| and
|\@maketocsubsection| commands. By default these commands do nothing. You can
control the appearence of the table of contents by redefining them. Their syntax
is
\begin{quote}
  |\@maketocsection{|\var{section}|}{|\var{short-title}|}{|\var{long-title}|}|
  \\[\medskipamount]
  |\@maketocsubsection{|\var{section}|}{|\var{subsection}|}%|\\
  |                   {|\var{short-title}|}{|\var{long-title}|}|
\end{quote}
where \var{section} and \var{subsection} are integer numbers.

\DescribeMacro{\@ifcurrentsection}\DescribeMacro{\@ifcurrentsubsection}
Note that the |\@tableofcontents| macro always expands to the full list of
sections and subsections. To implement a special treatment for the
\emph{current} section or subsection you can use the |\@ifcurrentsection| and
|\@ifcurrentsubsection| commands. Their syntax is
\begin{quote}
  |\@ifcurrentsection{|\var{number}|}{|\var{if-code}|}{|\var{else-code}|}|\\
  |\@ifcurrentsubsection{|\var{number}|}{|\var{if-code}|}{|\var{else-code}|}|
\end{quote}
The \var{if-code} is executed if \var{number} matches the current section or
subsection, respectively, and \var{else-code} is executed otherwise. For
example, if you want to display the current section in the top left corner of
each slide, your style definition should look somewhat like
\begin{quote}
  |\newslidestyle{|\var{style-name}|}{|\\
  |  \renewcommand{\@maketocsection}[3]{|\\
  |    \@ifcurrentsection{##1}{##3}{}|\\
  |  }|\\
  |  \renewcommand{\@makeslidecontent}{|\\
  |    \@tableofcontents|\\
  |    |$\vdots$\\
  |  }|\\
  |  |$\vdots$\\
  |}|
\end{quote}

\DescribeMacro{\tableofcontents}
Most talks begin with an outline of the talk's contents. As a package writer you
should therefore provide a |\tableofcontents| command that allows the user to
print the full table of contents. (\pkg{talk} already defines the
|\tableofcontents| command, but it does nothing by default.) You can achieve
this, too, by redefining |\@maketocsection| and |\@maketocsubsection| and then
calling |\@tableofcontents|.

\DescribeMacro{\@ifinrange}
However, if the table of contents does not fit on one slide, the user should be
able to split it, using an optional range argument of the form shown in
\mref{section}{sec:toc}. It is the package writers task to implement this
feature, but the parsing of the range argument is done by the |\@ifinrange|
macro. Its syntax is
\begin{quote}
  |\@ifinrange{|\var{sec}|}{|\var{subsec}|}{|\var{range}|}{|\var{if-code}|}{|\var{else-code}|}|
\end{quote}
\var{sec} and \var{subsec} are section and subsection numbers and \var{range} is
a string of the form
\begin{quote}
  \var{fromsec}|.|\var{fromsubsec}|-|\var{tosec}|.|\var{tosubsec}
\end{quote}
The \var{if-code} is executed if the subsection specified by \var{sec} and
\var{subsec} lies in the range specified by \var{range}, the \var{else-code} is
executed otherwise.

A typical definition of the |\tableofcontents| command will therefore look as
follows:
\begin{quote}
  |\renewcommand{\tableofcontents}[1][0.0-99.99]{|\\
  |  \bgroup|\\
  |  \def\@maketocsection##1##2##3{|\\
  |    \@ifinrange{##1}{0}{#1}{|\\
  |      ##1.\space ##3\par|\\
  |    }{}|\\
  |  }|\\
  |  \def\@maketocsubsection##1##2##3##4{|\\
  |    \@ifinrange{##1}{##2}{#1}{|\\
  |      ##1.##2.\space ##3\par|\\
  |    }{}|\\
  |  }|\\
  |  \@tableofcontents|\\
  |  \egroup|\\
  |}|
\end{quote}
If you use grouping (|\bgroup| and |\egroup| or curly brackets) and plain \TeX\
definitions (|\def| instead of |\renewcommand|), as shown above, your
definitions remain local to the goup, so you don't have to worry about restoring
the original definitions of |\@maketocsection| and |\@maketocsubsection|. A more
sophisticated definition of the |\tableofcontents| command can be found in
|sidebars.sty|.
\newpage
%
%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Contact}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%
For comments, bug reports, feature requests or submitting style packages please
email to
\begin{quote}
  |martin.wiebusch@gmx.net|
\end{quote}

\bigskip
\begin{flushright}
  Martin Wiebusch, \today
\end{flushright}
\end{document}