Debian Codegraph @

texmf-dist/doc/latex/seminar/seminar-doc.tex

raw
1 %% BEGIN sem-user.tex
2 \def\FileDate{93/04/01}
3 \def\FileVersion{1.0}
4 %%
5 %% COPYRIGHT 1993, by Timothy Van Zandt, [email protected]
6 %%
7 %%
8 %% This file may be distributed and/or modified under the conditions of
9 %% the LaTeX Project Public License, either version 1.2 of this license
10 %% or (at your option) any later version. The latest version of this
11 %% license is in:
12 %%
13 %% http://www.latex-project.org/lppl.txt
14 %%
15 %% and version 1.2 or later is part of all distributions of LaTeX version
16 %% 1999/12/01 or later.
17 %%
18 %%
19 %%
20 %% This LaTeX file prints the User's Guide for seminar.sty.
21 %% You must have my tvz-hax.sty, tvz-user.sty, and fancybox.sty,
22 %% which are distributed with seminar.sty.
23 %%
24 %% This is distributed with the index file sem-user.ind.
25 %% To make an new index, run, e.g.:
26 %% makeindex sem-user.idx
27 %%
28 %% STYLE OPTIONS:
29 %% `a4' : For A4 paper.
30 %% `twoside' : For two-sided printing.
31 %% `2up' : For two-up printing. (Uses non-standard font magnifications.
32 %% See 2up.doc for details.)
33 %%
34
35 \documentstyle[12pt]{tvz-user}
36
37 \makeindex
38
39 % Used with twoside option:
40 \def\theheadertitle{seminar.sty: User's Guide}
41
42 % No headers, 1in top margin
43 \setlength{\topmargin}{0pt}
44 \setlength{\headheight}{0pt}
45 \setlength{\headsep}{0pt}
46 \setlength{\textheight}{8.75in}
47 \setlength{\footskip}{.625in}
48 \papersizeadjust
49
50 % Change part environment:
51 \renewcommand{\part}[1]{%
52 \clearpage
53 \refstepcounter{part}
54 \addcontentsline{toc}{part}{\protect\numberline{\thepart}#1}%
55 \hrule height 1pt\relax
56 \vskip 1ex
57 \hbox to\columnwidth{\strut\huge\bf\thepart\hfil#1}%
58 \vskip 1ex
59 \hrule height 1pt\relax
60 \vskip 3ex}
61
62 \def\MainFont{\tt} % For macro definitions.
63
64 \ShortVerb
65 \ShortMeta
66
67 \let\filedate\FileDate
68
69 \begin{document}
70
71 \thispagestyle{empty}
72
73 \null
74 \vfill
75
76 \begin{center}
77 {\huge\bf seminar.sty}\\[9pt]
78 {\LARGE\bf A \bLaTeX\ style for slides and notes}\\[14pt]
79 {\LARGE\bf User's Guide}\par
80 \vskip 1.5em
81 \large
82 \renewcommand{\thefootnote}{\fnsymbol{footnote}}
83 Timothy Van Zandt\\
84 {\normalsize\tt [email protected]}
85 \vskip 1em
86 \thefiledate\\ Version \FileVersion\par
87 \end{center}
88 \par
89 \setlength{\unitlength}{1cm}
90 \thicklines
91 \centerline{\lower.8in\hbox{%
92 \begin{picture}(0,0)
93 \put(2,-11){\framebox(4,2){}}
94 \put(2,-11){\line(-2,3){1}}
95 \put(2,-9){\line(-2,3){1}}
96 \put(6,-9){\line(-2,3){1}}
97 \put(1,-9.5){\line(0,1){2}}
98 \put(1,-7.5){\line(1,0){4}}
99 \put(5.8,-8.7){\line(0,1){2}}
100 \put(5.0,-6.7){\oval(1.6,1.6)[tr]}
101 \put(5.0,-5.9){\line(-1,0){.7}}
102 \put(3.1,-6.4){\framebox(1.2,1){}}
103 \put(3.1,-6.4){\line(-1,2){.3}}
104 \put(3.1,-5.4){\line(-1,3){.3}}
105 \put(4.3,-5.4){\line(-1,3){.3}}
106 \put(2.8,-5.8){\line(0,1){1.3}}
107 \put(2.8,-4.5){\line(1,0){1.2}}
108 \put(0,6.2){\oval(14,10)}
109 \put(.02,6.18){\oval(14,10)}
110 \thinlines
111 \put(2.8,-5.8){\line(-4,3){9.6}}
112 \put(2.8,-4.5){\line(-3,5){9.35}}
113 \put(4,-4.5){\line(1,6){2.6}}
114 \put(6.8,1.4){\line(-1,-3){2.5}}
115 \end{picture}}}
116 \par
117 \bigskip
118 \rightskip=0pt plus 2em\relax
119 \parshape=20
120 0cm 2.3cm
121 0cm 2.9cm
122 0cm 3.5cm
123 0cm 4.1cm
124 0cm 4.7cm
125 0cm 5.3cm
126 0cm 5.9cm
127 0cm 6.5cm
128 0cm 7.1cm
129 0cm 7.7cm
130 0cm 8.3cm
131 0cm 8.3cm
132 0cm 8.3cm
133 0cm 7.3cm
134 0cm 7.3cm
135 0cm 7.3cm
136 0cm 7.3cm
137 0cm 7.3cm
138 0cm 7.3cm
139 0cm 7.3cm
140 seminar.sty is a \LaTeX\ style for typesetting slides or
141 transparencies, and accompanying notes. Here are some of its special features:
142 It is compatible with \AmS-\LaTeX, and you can use PostScript and \AmS{}
143 fonts. Slides can be landscape and portrait. There is support for color and
144 frames. The magnification can be changed easily.
145 Overlays can be produced from a single slide environment. Accompanying notes,
146 such as the text of a presentation, can be put
147 outside the slide environments. The slides, notes or both together
148 can then be typeset in a variety of formats.
149
150 \vfill
151
152 \twosideclearpage
153 \pagenumbering{roman}
154 \tableofcontents
155
156 \twosideclearpage
157
158 \section*{Getting Started}
159 \addcontentsline{toc}{section}{Getting Started}
160 \markboth{Getting Started}{Getting Started}
161
162 "seminar.sty" is a \LaTeX{} document style for typesetting slides, and more.
163
164 You should know how to use \LaTeX, as described in Leslie Lamport's \LaTeX:
165 {\em User's Guide and Reference Manual}.
166
167 Let's get started:
168 \begin{enumerate}
169 \item If you are installing "seminar.sty", read the the accompanying read-me
170 file, and put the input files where your \TeX\ looks for inputs.
171
172 \item Typeset the sample file, "semsamp1.tex", to see that everything is
173 working. You can use \LaTeX\ or \AmS-\LaTeX.
174
175 \item Read Appendix \ref{short-fonts}, on page \pageref{short-fonts}.
176
177 \item To start making landscape slides, use
178 \begin{LVerbatim}
179 \documentstyle{seminar}
180 \begin{document}
181 \begin{slide}
182 foo
183 \end{slide}
184 \end{document}
185 \end{LVerbatim}
186 and print out your document in landscape mode.
187
188 \item To start making portrait slides, include the \o{portrait} style option,
189 and use the \e{slide*} environment instead of \e{slide}:
190 \begin{LVerbatim}
191 \documentstyle[portrait]{seminar}
192 \begin{document}
193 \begin{slide*}
194 foo
195 \end{slide*}
196 \end{document}
197 \end{LVerbatim}
198
199 \item If you have used \SliTeX, see Section \ref{slitex}.
200
201 \item For A4 paper, use the "a4" style option.
202
203 \item When you are ready to explore "seminar.sty"'s special features, skim the
204 {\em User's Guide}, including the appendices.
205
206 \item Play around with the sample file "semsamp2.tex" to try out some of
207 "seminar.sty"'s special features.
208
209 \item When you run into problems, look for help in Part \ref{Help}.
210
211 \end{enumerate}
212
213 \twosideclearpage
214
215 \pagenumbering{arabic}
216
217 \part{Just slides}
218
219 \section{Landscape and portrait slides}
220
221 "seminar.sty" is a \LaTeX\ (or \AmS-\LaTeX) document style. Thus, begin your
222 document with
223 \begin{LVerbatim}
224 \documentstyle{seminar}
225 \end{LVerbatim}
226
227 The slide environments are\MainEnvIndex{slide}\MainEnvIndex{slide*}%
228 \begin{LVerbatim}
229 \begin{slide} ... \end{slide}
230 \begin{slide*} ... \end{slide*}
231 \end{LVerbatim}
232 \e{slide} is for landscape slides and \e{slide*} is for portrait slides.
233
234 By default, the document is typeset in landscape mode, but if you include the
235 \O{portrait} style option, the document is typeset in portrait mode.
236 Typesetting the document in landscape mode is different from printing it in
237 landscape mode; you may have to take care of the latter when printing with
238 your dvi driver (see Appendix \ref{S-landscape}).
239
240 If you have both landscape and portrait slides in your file, there are two
241 ways to print the slides:
242 \begin{itemize}
243 \item If you dvi driver supports rotation, then you can print all the slides
244 at once. See Appendix \ref{S-landscape} for details.
245 \item You can first print your landscape slides by putting the command
246 \begin{MD}
247 \landscapeonly
248 \end{MD}
249 in the preamble, and then print the portrait slides by inserting instead the
250 command
251 \begin{MD}
252 \portraitonly
253 \end{MD}
254 and including the \o{portrait} style option.
255 \end{itemize}
256
257 \section{The height and width of slides\label{slidedim}}
258
259 The dimensions of the slides are set by the lengths
260 \begin{MD}
261 \slidewidth\\
262 \slideheight
263 \end{MD}
264 The ``width'' refers to the width of a slide when looking at it in landscape
265 orientation, whether it is a landscape or portrait slide (and the same goes
266 for ``height''). The default width is 8.5 inches and the default height is 6.3
267 inches.
268
269 The slide environments have an optional argument that lets you change the
270 dimensions of a single slide, as in
271 \begin{LVerbatim}
272 \begin{slide*}[7.5in,6in]
273 \end{LVerbatim}
274 The first dimension is the slide's ``width'', and the second dimension is the
275 slides ``height''. If you remember what we said about what ``width'' and
276 ``height'' mean, you will see that the above example begins a portrait slide
277 that is 7.5 inches high and 6 inches wide.
278
279
280 \section{Margins within a slide}
281
282 When a slide is not full, the material is vertically centered within the
283 slide. The command
284 \begin{MD}
285 \centerslidesfalse
286 \end{MD}
287 cause the material to be flush to the top, instead. The command
288 \begin{MD}
289 \centerslidestrue
290 \end{MD}
291 switches back to vertical centering.
292
293 The right margin in slides is ragged by default. You can change this with the
294 command
295 \begin{MD}
296 \raggedslides[len]
297 \end{MD}
298 <len> should be the maximum space between the end of the line and the right
299 margin. The argument is optional; \n\raggedslides\ is equivalent to
300 \begin{LVerbatim}
301 \raggedslides[1fil]
302 \end{LVerbatim}
303 which gives a ragged right margin, as in \LaTeX's "flushleft" environment (the
304 default). On the other hand,
305 \begin{LVerbatim}
306 \raggedslides[0pt]
307 \end{LVerbatim}
308 gives a justified margin, and
309 \begin{LVerbatim}
310 \raggedslides[2em]
311 \end{LVerbatim}
312 gives a semi-ragged margin. Note that as a margin becomes less ragged,
313 hyphenation becomes more likely and more material fits on a slide.
314
315 \section{Page breaking within a slide environment\label{S-pagebreak}}
316
317 A slide environment can contain more than one ``page'' of slides; \TeX\ will
318 break slides into pages automatically.
319
320 If the mere idea disturbs you, put the command
321 \begin{LVerbatim}
322 \extraslideheight{10in}
323 \end{LVerbatim}
324 in your document. You can then divide slides into pages yourself by starting
325 new slide environments or using the
326 \begin{MD}
327 \newslide
328 \end{MD}
329 command within a slide environment. And you need read this section no further.
330
331 If instead you use the command
332 \begin{LVerbatim}
333 \extraslideheight{0pt}
334 \end{LVerbatim}
335 then \TeX\ will break pages the way you would expect. This is a quick and
336 dirty way to break a whole paper or a long proof into slides.
337
338 However, dividing material into slides is usually too delicate a matter to be
339 left up to \TeX, and ultimately you will make all the page breaks yourself. On
340 the other hand, automatic page breaking can still be helpful at the early
341 stages, letting \TeX\ find preliminary page breaks for you.
342
343 Setting the "\extraslideheight" to "0pt" doesn't give you much flexibility
344 about where to put the page breaks. Of course, you can always put a page break
345 earlier than the one found by \TeX, but occasionally you will prefer to let a
346 slide overflow by a small amount rather than rewrite the whole slide.
347
348 Therefore, by default, "seminar.sty" uses\MainIndex{\extraslideheight}%
349 \begin{LVerbatim}
350 \extraslideheight{10pt}
351 \end{LVerbatim}
352 This adds on an extra "10pt" to the target slide height (as determined by
353 "\slideheight" for landscape slides and "\slidewidth" for portrait slides)
354 {\em for the purpose of page-breaking only}.
355
356 If the resulting slide exceeds the slide height, you will get a message like
357 \begin{LVerbatim}
358 LaTeX Error: Slide 3 overfull by 9pt.
359 \end{LVerbatim}
360 "seminar.sty" then tries to reduce the slide to its maximum height by
361 squeezing out rubber vertical space (e.g., tightening up the interline
362 spacing). If the slide is still too full, you will get another warning like:
363 \begin{LVerbatim}
364 Overfull \vbox by 4.4pt while output was active.
365 \end{LVerbatim}
366 You can go back and look for a way to make the slide shorter, or you can
367 insert a "\newslide" command to change the page-break, or you can just ignore
368 these warnings.
369
370 The recommended value to give in the argument of "\extraslideheight" is the
371 largest length by which you might be willing to let a slide overflow.
372
373 After you have decided on the page breaks, you can shut up the warnings about
374 overfull slides and "\vbox"'s with
375 \begin{LVerbatim}
376 \renewcommand{\slidefuzz}{1in}
377 \end{LVerbatim}
378 The value of \n\slidefuzz\ (which should be length, even though \n\slidefuzz\
379 is an ordinary command sequence) is the threshold above which "seminar.sty"
380 gives a warning about an overfull slide. The default definition is "2pt".
381
382
383 \section{Margins on the page\label{S-slidemargins}}
384
385 After "seminar.sty" makes a slide (or a slide page) as described above, it
386 (optionally) frames the slide. This is described in Section \ref{S-frames}.
387 For making and framing the slide, "seminar.sty" does not need to know anything
388 about the paper you are printing on, or the margins you want. Hence, none of
389 \LaTeX's standard page parameters are relevant within a slide environment.
390 (However, for the sake of consistency, "seminar.sty" sets "\textwidth" to the
391 width of the slide and "\textheight" to the height of the slide within a slide
392 environment.)
393
394 Now "seminar.sty" has to do something with the finished slide. As you read
395 this User's Guide, you will find that there are various options. However,
396 right now we are making slides for printing on transparencies, and so we have
397 to position the slide on the transparency and add headers and footers.
398 "seminar.sty" does not use \LaTeX's page parameters for this either. Instead,
399 it uses the following parameters:
400 \begin{center}
401 \begin{tabular}{lc}
402 {\em Parameter:} & \em Default:\\
403 \N\slideleftmargin & .5in\\
404 \N\sliderightmargin & .5in\\
405 \N\slidetopmargin & .5in\\
406 \N\slidebottommargin & .5in
407 \end{tabular}
408 \end{center}
409 There are commands, to be set with "\renewcommand".\footnote{The only true
410 length parameters (meaning that thay should be set with "\setlength") in
411 "seminar.sty" are \n\slidewidth, \n\slideheight, \n\slideframewidth,
412 \n\slideframesep, \n\semin, and \n\semcm.}
413
414 \begin{figure}
415 \hrule height 1pt\relax
416 \begin{center}
417 \setlength\unitlength{.7cm}
418 \begin{picture}(13,11.5)(-1,-1.5)
419 \thicklines
420 \put(0,0){\framebox(11,8.5){\Huge My slide}}
421 \put(5.5,4.25){\fancyoval(8.5,6){}}
422
423 \thinlines
424 \put(0,8.65){\line(0,1){.3}}
425 \put(.75,8.65){\line(0,1){.3}}
426 \put(.5,8.8){\vector(1,0){.25}}
427 \put(.5,8.8){\vector(-1,0){.5}}
428 \put(.375,9.1){\makebox(0,0)[b]{\n\slideleftmargin}}
429
430 \put(10.25,8.65){\line(0,1){.3}}
431 \put(11,8.65){\line(0,1){.3}}
432 \put(10.75,8.8){\vector(1,0){.25}}
433 \put(10.75,8.8){\vector(-1,0){.5}}
434 \put(10.625,9.1){\makebox(0,0)[b]{\n\sliderightmargin}}
435
436 \put(0,-.15){\line(0,-1){.3}}
437 \put(11,-.15){\line(0,-1){.3}}
438 \put(5.5,-.3){\vector(1,0){5.5}}
439 \put(5.5,-.3){\vector(-1,0){5.5}}
440 \put(5.5,-.6){\makebox(0,0)[t]{\n\paperheight}}
441
442 \put(-.15,0){\line(-1,0){.3}}
443 \put(-.15,.75){\line(-1,0){.3}}
444 \put(-.3,.5){\vector(0,1){.25}}
445 \put(-.3,.5){\vector(0,-1){.5}}
446 \put(-.6,.375){\makebox(0,0)[r]{\n\slidebottommargin}}
447
448 \put(-.15,8.5){\line(-1,0){.3}}
449 \put(-.15,7.75){\line(-1,0){.3}}
450 \put(-.3,8){\vector(0,1){.5}}
451 \put(-.3,8){\vector(0,-1){.25}}
452 \put(-.6,8.125){\makebox(0,0)[r]{\n\slidetopmargin}}
453
454 \put(11.15,0){\line(1,0){.3}}
455 \put(11.15,8.5){\line(1,0){.3}}
456 \put(11.3,4.25){\vector(0,1){4.25}}
457 \put(11.3,4.25){\vector(0,-1){4.25}}
458 \put(11.6,4.25){\makebox(0,0)[l]{\n\paperwidth}}
459
460 \put(.75,7.75){\makebox(0,0)[bl]{Here is my header}}
461 \put(10.25,7.75){\makebox(0,0)[br]{9/30/99}}
462 \put(.75,.75){\makebox(0,0)[tl]{Here is my footer}}
463 \put(10.25,.75){\makebox(0,0)[tr]{7-9}}
464 \end{picture}
465
466 \caption{Slide margins.\label{SlideMargins}}
467 \end{center}
468 \hrule height 1pt\relax
469 \end{figure}
470
471 Look at Figure \ref{SlideMargins}. Note that the headers and footers lie {\em
472 inside} the top and bottom margins, respectively. The slide is then centered
473 horizontally and vertically between the margins.
474
475
476 \section{Magnification and lengths}
477
478 "seminar.sty" changes \TeX's magnification so that the output is larger than
479 when typesetting an article. This means, for example, that if you paste some
480 input from a paper you are writing with \LaTeX\ into a slide, it will look
481 pretty much the same in the slide, except that it is magnified. For example,
482 "\vspace{.5in}" produces a space that gets bigger along with the fonts and
483 everything else. Of course, it won't look identical, since "seminar.sty" uses
484 its own spacing parameters and margins.
485
486 \TeX's standard magnifications are in magsteps. $n$ magsteps means a
487 magnification of $1.2^n$. "seminar.sty"'s default magnification is 4 magsteps,
488 but you can change this with the command
489 \begin{MD}
490 \slidesmag{n}
491 \end{MD}
492 <n> should be an integer between $-5$ and 9.
493
494 As noted above, lengths grow with the magnification. For spacing, like the
495 parameter "\parindent" or using "\\[2pt]" to add a little extra space between
496 lines, this is great, because it is easier to think in unmagnified dimensions.
497 Setting "\parindent" to ".5cm" will look the same (relative to everything
498 else) whatever the magnification.
499
500 However, if you want to set the unit in a "picture" environment to 1cm, {\em
501 as it appears on the slide}, use
502 \begin{LVerbatim}
503 \setslidelength{\unitlength}{1cm}
504 \end{LVerbatim}
505 "\setslidelength" is like \LaTeX's "\setlength", but it scales the size down
506 so that the resulting size after magnification is, in this example, 1cm (in
507 the process, it removes any stretch from rubber lengths).%
508 \footnote{If you know what {\tt true} dimensions are, you may be wondering why
509 they haven't been mentioned. These are not recommended because you will not be
510 able to print the slides two-up or use the {\tt article} format.}
511 There is also a
512 \begin{MD}
513 \addtoslidelength{cmd}{len}
514 \end{MD}
515 command.
516
517 "seminar.sty" also provides the lengths
518 \begin{MD}
519 \semin\\
520 \semcm
521 \end{MD}
522 which are equal to an inch and a centimeter, scaled down to ``before
523 magnification'' size. For example,
524 \begin{LVerbatim}
525 \rule{1pt}{4\semcm}
526 \end{LVerbatim}
527 makes a line 4 centimeters long on the transparency,.\footnote{Suppose you
528 want to use another unit, such as millimeters, instead of centimeters. Then
529 try this:
530 \begin{LVerbatim}
531 \newcommand{\semmm}{\semcm}
532 \renewcommand{\semcmlength}{1mm}
533 \setslidelength{\semmm}{1mm}
534 \end{LVerbatim}}
535
536 "\textwidth", "\textheight", "\columnwidth" and "\linewidth" all have the
537 expected values in slides. (But "\slidewidth" and "\slideheight" do not.)
538 Thus, this would
539 \begin{LVerbatim}
540 \rule{1pt}{.5\textwidth}
541 \end{LVerbatim}
542 make a line that is 1/2 the width of the slide.
543
544 For help getting an EPS file to be the right size, see page \pageref{EPS}.
545
546 Finally, there are some parameters that "seminar.sty" scales for you, and
547 hence you can (and should) set them at their magnified values (the actual size
548 on transparencies):
549 \begin{itemize}
550 \item "\slidewidth" and "\slideheight"
551 \item "\slideframewidth" and "\slideframesep" (see Section \ref{S-frames}).
552 \item The slide margin parameters (see Section \ref{S-slidemargins}).
553 \item The \LaTeX\ page parameters, {\em when they are set in the
554 preamble}.\footnote{The \LaTeX\ page parameters are listed on page 163 of
555 Lamport's {\em \LaTeX\ User's Guide and Reference Manual}. They are used for
556 notes (see Section \ref{S-notes}) and the \o{article} option (see Sections
557 \ref{S-twoup} and \ref{S-article}), but not for printing slides onto
558 transparencies. Lamport warns that resetting page parameters in the middle of
559 the document is tricky; here it is more so, because you do have to worry about
560 scaling them. But you can use "\setslidelength" for this.}
561 \end{itemize}
562
563 Note that the warnings about overfull slides (see Section \ref{S-pagebreak})
564 report unmagnified dimensions.
565
566
567 \section{Font sizes}
568
569 The "\slidesmag" command lets you change the magnification of your document.
570 You can effectively fine tune the magnification by using the "11pt" and "12pt"
571 style options. For example, instead of increasing the magnification from 4 to
572 5, you can switch to the "12pt" style option. There are differences---e.g.,
573 magnification affects the space you get from "\hspace{1in}"---but the fonts
574 will at least be roughly the same size either way. The "11pt" option gives a
575 half-step, somewhat like "\slidesmag{4.5}", if the latter were permitted.
576
577 Sometimes you want to use smaller font sizes for a single slide, in order to
578 fit in that little bit of extra material, or to use larger font sizes, so that
579 the few things you have to say on a slide don't look too lonely. You can't
580 changing the magnification in the middle of the document, but you can change
581 the size of the fonts with the command
582 \begin{MD}
583 \ptsize{n}
584 \end{MD}
585 This switches to the font sizes that are in effect when you use the "<n>pt"
586 option. Actually, <n> can be 8, 9, 10, 11, 12, 14 or 17, whether you have
587 "art<n>.sty" or not.
588
589
590 \section{Spacing parameters\label{S-spacing}}
591
592 \begin{figure}
593 \hrule height 1pt
594 \begin{center}
595 \begin{tabular}{llc}
596 {\em Command:} & {\em Initializes:} & {\em Default} \\[2pt]
597 \N\slideparskip & "\parskip" & "1ex minus .2ex"\\
598 \N\slideparindent & "\parindent" & "0pt"\\
599 \N\slidefootnotesep & "\footnotesep" & "1.2ex"\\
600 \N\slideleftmargini & "\leftmargini" & "1.8em" \\
601 \N\slideleftmarginii & "\leftmarginii" & "1.4em" \\
602 \N\slideleftmarginiii & "\leftmarginiii" & "1em" \\
603 \N\slidelabelsep & "\labelsep" & ".5em" \\
604 \N\slideitemsep & "\itemsep" & ".8ex minus .2ex" \\
605 \N\slidepartopsep & "\partopsep" & "1ex minus .2ex" \\
606 \N\slidestretch & "\baselinestretch" & "1.2"\\
607 \N\slidearraystretch & "\arraystretch" & "1.2"
608 \end{tabular}
609
610 \caption{Slide spacing parameters.\label{SpacingDefaults}}
611 \end{center}
612 \hrule height 1pt
613 \end{figure}
614
615 The commands in Figure \ref{SpacingDefaults} are used to initialize some of
616 the spacing parameters at the beginning of each slide environment and when
617 "\ptsize" is used in a slide environment. These are spacing parameters that
618 should depend on the size of fonts and that in \LaTeX's "article" style would
619 be set in "art10.sty", etc. These commands should all be changed with
620 "\renewcommand", even though, except for the "stretch" parameters, their
621 values should be lengths.
622 Note that "ex" and "em" units are used because these are the units that depend
623 of font sizes.
624
625 Outside a slide environment, redefine the commands on the left if you want to
626 change these spacing parameters. Within a slide environment, reset the
627 parameters directly, or redefine the commands on the left and then use the
628 "\ptsize" command.
629
630 In other \LaTeX\ styles, the extra distance between lines that is inserted
631 when "\baselinestretch" exceeds 1 is eaten up by tall or deep lines. E.g., if
632 the line contains a table or a large math operator, there is probably no
633 extra space at all. The advantage of this system is that the distance between
634 baselines does not fluctuate with every tilde. The disadvantage is that lines
635 can end up too close.
636
637 In "seminar.sty", on the other hand, fraction
638 \begin{MD}
639 \slideskip
640 \end{MD}
641 of the extra space cannot be eaten, but up to fraction
642 \begin{MD}
643 \slideshrink
644 \end{MD}
645 of this extra space that cannot be eaten can be removed if there is too much
646 material on the slide. This gives you added flexibility about how much
647 material to include on a slide. Both \n\slideskip\ and \n\slideshrink\ can be
648 set with "\renewcommand" to a number between 0 and 1. The default value of
649 \n\slideskip\ is ".75" and the default value of \n\slideshrink\ is ".25". Set
650 \n\slideskip\ to "0" to revert to \LaTeX's usual behavior, as described above.
651
652 For example, suppose you are using a 10pt font, \n\slidestretch\ is "1.2",
653 \n\slideskip\ is ".75", and \n\slideshrink\ is ".25". The "\baselineskip" for
654 a 10pt font is normally 12pt, leaving a little space between the lines. Then
655 "\baselineskip" is set to
656 \begin{center}
657 "\slidestretch" $\times$ "12pt" $=$ 1.2$\times$12pt $=$ 14.4pt
658 \end{center}
659 The extra space between lines that is inserted is thus 2.4pt, and
660 \begin{center}
661 "\slideskip" $\times$ 2.4pt $=$ .75$\times$2.4pt $=$ 1.8pt
662 \end{center}
663 of this cannot be eaten by tall or deep lines. However, the space between
664 lines can be reduced by up to
665 \begin{center}
666 "\slideshrink" $\times$ 1.8pt $=$ .25$\times$1.8pt $=$ .45pt
667 \end{center}
668 if the slide would otherwise be too long.
669
670
671 \section{Slide frames\label{S-frames}}
672
673 Slides can be framed. The command
674 \begin{MD}
675 \slideframe[commands]{style}
676 \end{MD}
677 specifies the frame style to use. Valid frame styles are "none" and "plain",
678 unless you use macros that define additional styles. For example, the
679 \o{fancybox} style option defines the frames "shadow", "double", "oval" and
680 "Oval" (corresponding to the "\shadowbox", "\doublebox", "\ovalbox" and
681 "\Ovalbox" commands defined in that style option). The \o{semcolor}
682 option defines the styles "scplain", "scdouble", and "scshadow".
683
684 All the frame styles use the lengths
685 \begin{MD}
686 \slideframewidth\\
687 \slideframesep
688 \end{MD}
689 which are the (magnified) width of the line (default 4pt) and the distance
690 between the slide and the frame (default .4in), respectively.
691
692 \n\slideframe's optional argument is for commands that you want to use to
693 customize the slide frame style. For example:
694 \begin{LVerbatim}
695 \slideframe[\setlength{shadowsize}{12pt}]{shadow}\\
696 \slideframe[\psset{fillstyle=gradient}]{scplain}
697 \end{LVerbatim}
698
699 If you want to build your own custom slide frame, use the command
700 \begin{MD}
701 \newslideframe{style}[commands]{frame command}
702 \end{MD}
703 <style> is the name of the frame, "[<commands>]", which is optional, will be
704 inserted before the frame command and before the <commands> given by
705 "\slideframe"'s optional argument. These commands can be used to set some
706 default parameter values. Then the final argument should frame "#1".
707
708 For example, if "\myframe{foo}" frames "foo", and if "\myframe" uses the
709 length "\baldness" as a parameter, then you might write
710 \begin{LVerbatim}
711 \newslideframe{wildframe}[\setlength{\baldness}{.2cm}]%
712 {\myframe{#1}}
713 \end{LVerbatim}
714 You can still override the default value of "\baldness", as in
715 \begin{LVerbatim}
716 \slideframe[\setlength{\baldness}{.1cm}]{wildframe}
717 \end{LVerbatim}
718
719 There is a starred version of \n\slideframe\ that adds the frame to previously
720 specified frames.\footnote{If using color or PostScript images, note that each
721 frame gets added to the background.} This can be used for special tricks. For
722 example, if you are using the \o{fancybox} and \o{semcolor} options, then
723 \begin{LVerbatim}
724 \newslideframe{draft}%
725 {\boxput{\rput{30}{\Huge\gray DRAFT}}{#1}}
726 \slideframe{draft}
727 \slideframe*{scdouble}
728 \end{LVerbatim}
729 puts the word ``DRAFT'' in the background of each slide, gray and rotated 30
730 degrees, and then adds a double frame.\footnote{Use "\boxput*" to put "DRAFT"
731 in the foreground. See "fancybox.doc" for details.}
732
733
734 \part{Advanced Features}
735
736 \section{Counters}
737
738 The counter for slides is \C{slide}. The default definition of \N\theslide\ is
739 "\arabic{slide}". You can use "\label" and "\ref" to cross-reference slides,
740 and the page number in slide environments is set to
741 \n\theslide.\footnote{However, these page or slide cross-references are not
742 always accurate when you let \TeX\ break pages for you within a slide.} Thus,
743 you can write, for example,
744 \begin{LVerbatim}
745 See equation (\ref{foo}) on Slide \pageref{foo}.
746 \end{LVerbatim}
747
748 You may want some counters, such as equation counters, to be reset with each
749 new slide environment or \n\newslide\ command. By default, only the "footnote"
750 counter is reset this way, but you can specify your own (comma-separated) list
751 of counters to be reset with the command
752 \begin{MD}
753 \slidereset{list}
754 \end{MD}
755 If you want to reset additional counters, rather than replace the list
756 entirely, use
757 \begin{MD}
758 \addtoslidereset{list}
759 \end{MD}
760
761 There is another way in which the footnote counter gets special treatment. The
762 command
763 \begin{MD}
764 \theslidefootnote
765 \end{MD}
766 is used for the counter text instead of "\thefootnote". The default definition
767 is
768 \begin{LVerbatim}
769 \alph{footnote}
770 \end{LVerbatim}
771
772 \section{Selectively including or excluding slides}
773
774 The commands
775 \begin{MD}
776 \onlyslides{list}\\
777 \notslides{list}
778 \end{MD}
779 can be used to include or exclude only those slides in the given list. The
780 argument should expand to a comma-separated list of numbers or ranges. The
781 numbers do not need to be in order, the list can contain numbers that do not
782 correspond to any slide, and there can be duplicate numbers. Negative numbers
783 should be enclosed in curly braces. Since the argument is first expanded, you
784 can use the "\ref" command in the argument. For example,
785 \begin{LVerbatim}
786 \onlyslides{{-2},\ref{dp}-10,\ref{chart},0,17-999}
787 \end{LVerbatim}
788 is legal. If "\label{dp}" appears in slide 5 and "\label{chart}" appears in
789 slide 12, this is equivalent to:
790 \begin{LVerbatim}
791 \onlyslides{{-2},5-10,12,0,17-999}
792 \end{LVerbatim}
793
794 \section{Printing your slides two-up\label{S-twoup}}
795
796 Printing your slides two-up is useful both for previewing slides and for
797 making hard copies to distribute or for proofreading.
798
799 One way to print your slides two-up is to include the \O{article} style
800 option. This is described further below.
801
802 Another way is to include the command
803 \begin{MD}
804 \twoup[n]
805 \end{MD}
806 in the preamble. This inputs "2up.tex", which contains generic macros for
807 two-up printing, and sets the parameters to values that are likely to work.
808 Including the optional argument "[<n>]" increases the two-up magnification by
809 $n$ magsteps. $n$ can be a positive or negative integer. If you are not able
810 to get the right layout, then include the \O{2up} style option, read the
811 documentation of "2up.tex", and set the parameters yourself, rather than using
812 the \n\twoup\ command.
813
814 The \o{article} style option is also called the article {\em format} (as
815 opposed to the slides format). In the article format without the \o{portrait}
816 option, the slides are centered horizontally and vertically, two to a page (if
817 they fit---landscape slides do fit by default). With the portrait option, the
818 slides are printed side-by-side, two to a page. In the \o{article} format, you
819 can mix landscape and portrait slides with different orientations, but this
820 does not work well with the \o{portrait} option.
821
822 You can change the article format's magnification with
823 \begin{MD}
824 \articlemag{n}
825 \end{MD}
826 This command works like the "\slidesmag" command (page \pageref{+slidesmag}).
827 The default is
828 \begin{LVerbatim}
829 \articlemag{0}
830 \end{LVerbatim}
831 Increase the article magnification if the slides look too lonely; decrease it
832 if they are not coming out two-up.
833
834 The size of the slides depends on the {\em difference} between the
835 magnifications in the slides and article format. E.g., since the default
836 slides magnification is 4 magsteps, the slides are scaled down in the article
837 format by 4 magsteps. When you change the slides magnification with
838 \n\slidesmag, you also have to change the article magnification with
839 \n\articlemag\ by the same amount if you want the size of the slides in the
840 article format to remain the same. However, when the article magnification in
841 magsteps is negative , you will be using non-standard font magnifications
842 (which will produce terrible results if you cannot generate the needed
843 fonts---see Appendix \ref{bitmaps} for advice).
844
845 Whether or not landscape slides (or rotated portrait slides) come out two-up
846 in the article format without the \o{portrait} option depends on (i) the
847 difference between the slides and article magnification, (ii) the values of
848 \n\slidewidth\ and \n\slideheight\, (iii) the size of the slide frame, and
849 (iv) the article format's page parameters. With the default values of
850 (ii)--(iv), the slides will still come out two-up if you change the difference
851 between the slides and article magnification to 3 (e.g., increase the value of
852 \n\articlemag\ by 1). Try this if you want the slides to be larger.
853
854 If you use the \o{article} option {\em and} the \n\twoup\ command, then your
855 slides should be printed four-up!
856
857 You will notice labels on the side or bottom of each slide in the \o{article}
858 format. The command
859 \begin{MD}
860 \slidestyle{style}
861 \end{MD}
862 determines where these labels go. There are three predefined slide styles:
863 \begin{description}
864 \item[\tt empty] No captions or labels are used.
865 \item[\tt left] The labels go on the left of each slide (the default when the
866 \o{portrait} option is not used).
867 \item[\tt bottom] The labels go on the bottom (the default with the
868 \o{portrait} option).
869 \end{description}
870 The label you get is the value of \N\slidelabel. The default definition of
871 \n\slidelabel\ is
872 \begin{LVerbatim}
873 \bf Slide \theslide
874 \end{LVerbatim}
875
876 \section{Notes\label{S-notes}}
877
878 In addition to slides, you can include a few comments following each slide to
879 remind you of what to say, or even the entire text of your presentation for
880 your own benefit or to be distributed to others. These comments or text,
881 referred to in this documentation as ``notes'', do not go inside any special
882 environment. However, a slide cannot go in the middle of a paragraph of notes.
883
884 To include notes this way, you have to use one of the following style options,
885 which determine what is printed:
886 \begin{quote}
887 \begin{tabular}{ll}
888 \O{slidesonly} & Only the slides are printed.\\
889 \O{notes} & Both notes and slides are printed.\\
890 \O{notesonly} & Only the notes are printed.\\
891 \end{tabular}
892 \end{quote}
893 These style options are referred to as {\em selections} in this documentation.
894
895 The pages of notes following slide 5 are numbered 5.1, 5.2, etc.
896
897 You can use the "portrait" option to print out your notes, even if you don't
898 use this option when printing the slides.
899
900 With the "notesonly" selection, the slides are not printed, but they are
901 processed. This means that one can still refer in the notes to slides or to
902 equations in slides.
903
904 The fact that various spacing parameters are initialized at the beginning of
905 each slide (see Section \ref{S-spacing}) means that when you reset these
906 parameters outside a slide environment, only the notes are affected. This lets
907 you use different values for notes and slides. The command \N\slidefonts\ can
908 be used for any special font commands that should apply only to slides. Also,
909 the command \N\everyslide\ is executed at the beginning of every slide, and
910 you can use this for any other customizations you want to include.
911
912 You can also use the "11pt" or "12pt" style option for your notes, without
913 changing the size of the fonts in the slides, by using the "\ptsize" command
914 to set the font sizes for slides. For example, suppose that the "12pt"
915 document style option is used, but the preamble contains the command
916 \begin{LVerbatim}
917 \ptsize{11}
918 \end{LVerbatim}
919 and the second slide begins with the command
920 \begin{LVerbatim}
921 \ptsize{9}
922 \end{LVerbatim}
923 Then the notes use the "12pt" font size declarations, all the slides but the
924 second one use the "11pt" font size declarations, and the second slide uses
925 the "9pt" font size declarations.
926
927 Notes are typeset using \LaTeX's standard output routines, and \LaTeX's
928 standard page parameters.
929
930 Finally, it is even possible to use a different page style for notes and
931 slides. The page style for notes is set by the "\pagestyle" and
932 "\thispagestyle" commands. The command
933 \begin{MD}
934 \slidepagestyle{style}
935 \end{MD}
936 sets a different page style for the slides. If the argument is empty, then the
937 page style for slides reverts to the one for notes.\footnote{There is no
938 "\thisslidepagestyle" command.}
939
940 With the command
941 \begin{MD}
942 \onlynotestoo
943 \end{MD}
944 the "\onlyslides" and "\notslides" commands apply to the notes as well.
945
946
947 \section{How notes are omitted\label{omit}}
948
949 In the previous section, it was stated that notes are not enclosed in a
950 special environment. "seminar.sty" omits notes using special
951 macros\footnote{Defined in {\tt xcomment.sty}} that comment out everything
952 {\em outside} the slide environments (and a few other environments mentioned
953 below). Global declarations that should be processed even when slides are
954 omitted go in \e{allversions*} environments, described below.
955
956 "seminar.sty" also let you use a more conventional approach to notes. If you
957 put the command
958 \begin{MD}
959 \noxcomment
960 \end{MD}
961 in the preamble, then the notes go inside \E{note} environments, and you can
962 put all the global declarations outside any environment. "xcomment.sty" is
963 used to make \e{note} a comment environment when note should be omitted, and
964 otherwise the \e{note} environment does nothing. This mode of operation is
965 more robust than omitting everything outside the slide environments, but
966 remembering to insert the
967 \begin{LVerbatim}
968 \begin{note} ... \end{note}
969 \end{LVerbatim}
970 is more tedious.
971
972 Here are a few technicalities that have to do with "xcomment.sty" and that
973 apply whether or not you use \n\noxcomment.
974 \begin{enumerate}
975 \item The text that follows the beginning of a slide environment (when not
976 using \n\noxcomment) or the end of a \e{note} environment {\em must have
977 balanced curly braces}.
978 \item "\input" and "\include" commands are followed, even when found in
979 omitted notes, but you must use the \LaTeX\ syntax "\input{<file>}" (as
980 opposed to \verb*+\input <file> +), and the inputted file must end with
981 "\endinput" (this is a good practice anyway).
982 \item In omitted text, "%" is still a comment character (hence it is possible
983 to comment out a slide or note environment).
984 \item A temporary file, "\jobname.tmp", is created (this is of no
985 consequence---just in case you wanted to know where it comes from).
986 \end{enumerate}
987
988 The rest of this section deals with special considerations when omitting
989 everything outside the slide environments.
990
991 If you might want to make a global change to one of the slide parameters after
992 the document preamble, you cannot include it in a slide environment because
993 the change will be local, and you cannot include it in the notes because the
994 change won't be processed when the notes are omitted.
995
996 To get around this problem, an environment \E{allversions*} is provided. It is
997 processed even when notes are omitted, and any parameter changes or command
998 definitions made within the environment are global. Don't generate any output
999 within this environment.
1000
1001 On a rare occasion you might want to include some text that should be typeset
1002 even when the other notes are omitted (e.g., a list of the slides, or a cover
1003 page). The \E{allversions} environment is provided for this purpose.
1004
1005 If you do any serious hacking, you might want to add to the list of
1006 environments that should be included with the "slidesonly" selection. Do this
1007 with the command
1008 \begin{MD}
1009 \addtoslidelist{list}
1010 \end{MD}
1011 where <list> is a comma separated list of environments, without spaces.
1012
1013 \section{The article format\label{S-article}}
1014
1015 The \o{article} style option was described in Section \ref{S-twoup} as a way
1016 to print your slides two-up. This option is also a good way to print your
1017 notes.
1018
1019 The \o{article} option gets its name because your document is typeset somewhat
1020 like it would be with \LaTeX's "article" style. (It uses \LaTeX's standard
1021 page parameters, but some of the default values are different.) It is also
1022 called the article {\em format}; the slides format is what you get without the
1023 \o{article} option.
1024
1025 You probably don't want to use the \o{portrait} style option with the
1026 \o{article} format except when you are only printing portrait slides. But you
1027 are welcome to experiment.
1028
1029 With the \o{notesonly} selection, you can make the notes as big as you want
1030 using the \n\articlemag\ command (e.g., for easy reading while giving a
1031 presentation). Just as in the \o{slides} format, the page parameters are
1032 scaled at the beginning of the document so that they can be set with their
1033 true dimensions in the preamble.
1034
1035 The commands
1036 \begin{MD}
1037 \setartlength{cmd}{len}\\
1038 \addtoartlength{cmd}{len}
1039 \end{MD}
1040 are analogous to "\setslidelength" and "\addtoslidelength", but they scale the
1041 lengths so that they end up at the specified size after magnification in the
1042 "article" format. You never would use such a command in slide environments or
1043 to set slide parameters, but you might use these in the notes if you were
1044 planning on typesetting your notes with the "article" format rather than the
1045 "slides" format.
1046
1047 You can change the placement of slides in the \o{article} format using the
1048 \begin{MD}
1049 \slideplacement{name}
1050 \end{MD}
1051 command. Here are the valid placement names:
1052 \begin{description}
1053 \item[float] The slides are floated. This is the default with the \o{notes}
1054 selection and the \o{portrait} option.
1055 \item[float*] Like "float", but if the notes are printed in a two-column
1056 format the slides extend across both columns (e.g., like "table" versus
1057 "table*"). This is the default with the \o{notes} selection without the
1058 \o{portrait} option.
1059 \item[onepercol] Each slide is centered horizontally and vertically within a
1060 single column. This is the default when only slides are printed and the
1061 \o{portrait} option is used.
1062 \item[twopercol] Each slide is centered horizontally, two or one per column,
1063 depending on how many fit. This is the default when only slides are printed
1064 and the \o{portrait} option is not used.
1065 \item[here] Each slide is centered horizontally, separated from adjoining
1066 text or other slides by the rubber length \N\slidesep. The default value of
1067 \n\slidesep\ is "\intextskip". This is useful with the \o{notes} selection
1068 when you want the slides to precede accompanying comments and when you do not
1069 mind large spaces at the bottom of pages.
1070 \item[here*] This is like "here*", but with "here*" the length \n\slidesep\
1071 is not lost when it falls at the beginning of a page or after a slide.
1072 \end{description}
1073
1074 If you want each slide environment to begin a new page (with any of the
1075 selections), put the command
1076 \begin{MD}
1077 \slideclearpagetrue
1078 \end{MD}
1079 in the preamble.
1080
1081 The \o{notesonly} selection has a starred version, \O{notesonly*}, which
1082 produces a slide marker for each slide environment, like this one:
1083 \begin{center}
1084 \leavevmode
1085 \vbox{%
1086 \hrule height 1pt
1087 \kern 8pt
1088 \hbox to \linewidth{\hss \LARGE\bf Slide 4 \hss}%
1089 \kern 8pt
1090 \hrule height 1pt}
1091 \end{center}
1092
1093
1094 Commands that are irrelevant in the "article" format are simply ignored. The
1095 idea is that it should be possible to switch back and forth between the two
1096 formats without making any other changes in the document. However, this is not
1097 entirely possible. Changing "\parindent" or "\textwidth" in the preamble
1098 affects both formats. You can get around this using the \n\ifarticle\
1099 conditional. For example,
1100 \begin{LVerbatim}
1101 \ifarticle
1102 blah blah
1103 \else
1104 blee blee
1105 \fi
1106 \end{LVerbatim}
1107 The "\else" part is optional.
1108
1109
1110 \section{Page styles}
1111
1112 The page styles "empty", "plain", "headings" and "myheadings" work like in
1113 \LaTeX's article style. There is also a page style "align" which puts "+"
1114 signs in the corners, like in \SliTeX.\footnote{See question \ref{Pagestyle}
1115 in Section \ref{tips} for suggestions on defining new page styles.} You can
1116 change the size of the fonts used in headers and footers in the slides format
1117 by setting the commands
1118 \begin{MD}
1119 \slideheadfont\\
1120 \slidefootfont
1121 \end{MD}
1122 to the desired size, using "\renewcommand" (but any explicit font declarations
1123 in a page style override these commands). The default definition of these
1124 commands is "\scriptsize".
1125
1126
1127 \section{Other style options\label{options}}
1128
1129 The style options described so far, "portrait", "article", "slidesonly",
1130 "notes", and "notesonly", were designed specifically for "seminar.sty". There
1131 are other such style options described elsewhere in this documentation:
1132 "semrot" (page \pageref{o+semrot}), \o{semlayer} (page \pageref{o+semlayer}).
1133 \o{semcolor} (page \pageref{o+semcolor}), "semhelv" (page
1134 \pageref{o+semhelv}), "semlcmss" (page \pageref{o+semlcmss}), and "a4" (page
1135 \pageref{o+a4}).
1136
1137 Here are two more style options that are part of the "seminar.sty" package,
1138 but that can be used with other document styles:
1139 \begin{description}
1140 \item[fancybox] "fancybox.sty" is specific to slides, but it contains commands
1141 and documentation that are useful for making slides.
1142
1143 \item[slidesec] This sets up some sectioning/heading commands for slides, and
1144 lets you print a list of slides or a table of contents. See the file
1145 "slidesec.sty" for details.
1146 \end{description}
1147
1148 It is impossible to predict, much less describe, the consequences of using all
1149 the other available \LaTeX{} style option with each selection and format.
1150 Since this document style is an extension of \LaTeX's "article" style, style
1151 options and commands that do not work with \SliTeX{} may well work here. Just
1152 about any style option that works with \LaTeX's "article" style will work with
1153 the "article" format. When unsure of the effect of an option, just try it and
1154 see for yourself what happens.
1155
1156 \section{Overlays\label{S-overlays}}
1157
1158 For overlays, you must use both the \O{semlayer} and \o{semcolor} style
1159 options (see page \pageref{o+semcolor}).
1160
1161 Overlays have two purposes. First, you can use overlays to gradually add
1162 layers of information on a slide during a presentation. Second, you can use
1163 overlays to make color layers; each layer is printed in black-on-white on
1164 paper, and then you use some kind of color copying service to put each layer
1165 on a transparency in a different color. This is not nearly as nice as having a
1166 color printer or using a color printing service, but it's the next best thing.
1167
1168 "seminar.sty" lets you make both types of overlays (and the main slide) from a
1169 single slide environment. The command\footnote{You can also write
1170 \begin{Ex}
1171 "\begin{overlay}{<n>}" $\ldots$ "\end{overlay}"
1172 \end{Ex}}
1173 \begin{MD}
1174 \overlay{n}
1175 \end{MD}
1176 puts whatever is in its scope (\TeX\ group) on overlay $n$, where
1177 $n=0,\ldots,9$. Actually, overlay 0 refers to the main slide, but you might
1178 use "\overlay{0}" because overlay commands can be nested. As implemented by
1179 the "semcolor" style option, these overlay commands can be used just about
1180 anywhere, including in math mode, tables, and around an included graphics file
1181 (if it is a conforming EPS file, at least). Also, it is all right to use
1182 non-consecutive overlay numbers.
1183
1184 For color layers, you have to start by defining some colors using the command
1185 \begin{MD}
1186 \colorlayers{colors}
1187 \end{MD}
1188 <colors> should be a comma separated list of color names, without spaces, as
1189 in
1190 \begin{LVerbatim}
1191 \colorlayers{red,green,blue}
1192 \end{LVerbatim}
1193 Then you can use the command "\red" just like the command \n\overlay"{<n>}";
1194 everything in its scope goes on a red color layer.
1195
1196 The "\colorlayers" command obeys the usual rules on scope. You can use this
1197 command any time, including in a slide environment. The command is cumulative,
1198 meaning that previously defined color layers continue to exist. The command
1199 was purposely defined so that it does not complain when a color name is
1200 already defined; this makes it easier to switch from some other color system
1201 to a layer system. However, you should be careful not to inadvertently
1202 redefine some command that you need. Fortunately, there are no \TeX{}
1203 primitives whose names are the names of colors.
1204
1205 When you print out the slides, the main slide is printed, followed by each of
1206 the color layers (if any) for the main slide. Then each of the overlays is
1207 printed, together with each of its color layers. Only overlays or color layers
1208 that are actually used (i.e., that are not empty) are printed.
1209
1210 You can turn overlays and color layers on and off with the commands
1211 \begin{MD}
1212 \overlaystrue\\
1213 \overlaysfalse\\
1214 \layerstrue\\
1215 \layersfalse
1216 \end{MD}
1217 These commands can be used at any time, and they obey the usual scoping rules.
1218 The default is for overlays to be active in the "slides" format and suppressed
1219 in the "article" format.
1220
1221 The counter \C{overlay} keeps track of the overlays. The default definition of
1222 \N\theoverlay\ is:
1223 \begin{LVerbatim}
1224 \theslide-\alph{overlay}
1225 \end{LVerbatim}
1226 Overlays can be cross-referenced.
1227
1228 The command \N\currlayer\ is set to the name of the current color layer.
1229 \N\thelayer\ makes a label for layers; its default definition is:
1230 \begin{LVerbatim}
1231 \theoverlay-\currlayer
1232 \end{LVerbatim}
1233 Color layers cannot be cross-referenced.
1234
1235 For example, if slide 7 has overlays 1 and 2 and colors "red" and "green",
1236 then the main slide is numbered 7, followed by layers 7-red and 7-green,
1237 followed by overlay 7-a, followed by layers 7-a-red and 7-a-green, followed by
1238 overlay 7-b, followed by layers 7-b-red and 7-b-green.
1239
1240 The caption used in the slide styles is \n\overlaylabel\ for overlays and
1241 \N\layerlabel\ for layers. The defaults are, respectively,
1242 \begin{LVerbatim}
1243 \bf Overlay \theoverlay
1244 \bf Layer \thelayer
1245 \end{LVerbatim}
1246
1247 By default the overlays and layers use the same page styles in the "slides"
1248 format as their ``owner.'' You can specify special page styles with the
1249 commands:
1250 \begin{MD}
1251 \overlaypagestyle{style}\\
1252 \layerpagestyle{style}
1253 \end{MD}
1254
1255 Finally, by default the overlays and layers use the same frame style as their
1256 ``owner.'' You can specify special frame styles with the commands:
1257 \begin{MD}
1258 \overlayframe[commands]{style}\\
1259 \layerframe[commands]{style}
1260 \end{MD}
1261
1262
1263 \part{Help\label{Help}}
1264
1265 Road map:
1266 \begin{itemize}
1267 \item If you just want to figure out how to do something, check Section
1268 \ref{tips}, ``Tips and tricks.''
1269 \item If you are trying to decipher an error message, check Section
1270 \ref{errors}, ``Errors.''
1271 \item If you are trying to solve some system-dependent problem that has
1272 arisen, check Section \ref{trouble}, ``Troubleshooting.''
1273 \item To convert \SliTeX\ files, see Section \ref{slitex}, ``Converting
1274 \SliTeX\ files''.
1275 \end{itemize}
1276
1277 \section{Tips and tricks\label{tips}}
1278
1279 \faq{How can I fit more material in the slides?}
1280
1281 Or alternatively, make the little material you have fill up the slide.
1282
1283 Let us count the ways:
1284 \begin{enumerate}
1285 \item Change the magnification with \n\slidesmag"{<n>}" (affects all the
1286 slides).
1287 \item Change the height and/or width of one or all the slides.
1288 \item Use "\ptsize{<n>}".
1289 \item Change \n\slidestretch.
1290 \item Use the \n\raggedslides\ command, which changes the propensity to
1291 hyphenate.
1292 \end{enumerate}
1293
1294 \faq{How do I include an Encapsulated PostScript figure?\label{EPS}}
1295
1296 The only thing tricky about including EPS files is getting the size right. For
1297 example, suppose the you want to include a postscript file in a slide using
1298 the "epsf.sty" macros, and you want it to be 6 inches wide. Then this will do
1299 the trick:
1300 \begin{LVerbatim}
1301 \setslidelength{\epsfxsize}{6in}
1302 \epsffile{mypic.eps}
1303 \end{LVerbatim}
1304
1305 If you include the command
1306 \begin{MD}
1307 \espfslidesize
1308 \end{MD}
1309 (e.g., in the preamble), then "epsf.sty" will take care of scaling the size
1310 for you, and so you can just set "\epsfxsize" and "\epsfysize" to their
1311 magnified sizes (using "\setlength" rather than "\setslidelength"). Or you can
1312 not set these parameters at all, and then the eps file appears at its natural
1313 size on the slide.
1314
1315 Either way, this will have the expected effect:
1316 \begin{LVerbatim}
1317 \setlength{\epsfysize}{.8\textheight}
1318 \epsffile{mypic.eps}
1319 \end{LVerbatim}
1320
1321 "psfig.tex" does not handle magnification properly. By using magnified
1322 dimensions, without "\setslidelength", as in
1323 \begin{LVerbatim}
1324 \psfig{file=mypic.eps,width=6in}
1325 \end{LVerbatim}
1326 the picture should appear correctly within a slide, but then it will not scale
1327 properly if you try to use the \o{article} option or the \n\twoup\ command.
1328 The solution, if using Rokicki's "dvips", is to use "epsf.sty" (written by the
1329 man himself).
1330
1331 \faq{How can I print just selected overlays, layers or pages of notes in the
1332 {\tt slides} format?}
1333
1334 The "\onlyslides" and "\notslides" commands affect only slides. If a slide is
1335 omitted, so are all its overlays and color layers. To be more selective, you
1336 have to use your dvi driver to select the pages to be printed.
1337
1338 In the "slides" format, the page numbers recognized by dvi drivers correspond
1339 to the numbers of the slides. This means that a slide and all the overlays,
1340 layers and notes that correspond to that slide have the same page number. Some
1341 drivers allow one to select occurrence $n$ of a page number. E.g., with
1342 "dvips",
1343 \begin{LVerbatim}
1344 dvips -p2.1 -l2.4 myslides
1345 \end{LVerbatim}
1346 will print the first through fourth page of overlays or notes that follow
1347 slide 2.
1348
1349 If your dvi driver does not support such selection, and you would prefer that
1350 the driver recognize physical page numbers, then put the command
1351 \N\truepagenumbers\ in the preamble.
1352
1353
1354 \faq{How do I define custom page styles?}
1355 \label{Pagestyle}
1356
1357 There is nothing special about defining new page styles in "seminar.sty".
1358 However, to make it easier to do this in the preamble, the commands
1359 \begin{MD}
1360 \newpagestyle{style}{header}{footer}\\
1361 \renewpagestyle{style}{header}{footer}
1362 \end{MD}
1363 are provided.\footnote{%
1364 You can also use the macros in "fancyheadings.sty", which is available from
1365 various archives. However, you have to set the pagestyle {\em after}
1366 "\begin{document}".
1367 Otherwise, the dimensions get screwed up. If using the \o{slidesonly}
1368 selection, then you also need to enclose the "\pagestyle" command in
1369 an \e{allversions*} environment. E.g.,
1370 \begin{LVerbatim}
1371 \begin{allversions*}
1372 \pagestyle{fancy}
1373 \end{allversions*}
1374 \end{LVerbatim}}
1375
1376 <style> is the name of the page style, and <header> is the header, and
1377 <footer> is the footer. These can only be used for simple page styles that are
1378 the same for odd and even pages, and that do not do anything special with
1379 section marks.
1380
1381 Headers and footers are set in an "\hbox" the width of the page
1382 ("\textwidth"). You can use stretchable space such as "\hspace*{\fill}" or
1383 "\hfil" to center some information or put it flush against the margins. See
1384 the definitions of page styles in "latex.tex" and "article.sty" for examples.
1385
1386 Here is an example: Professor Starr wants lots of information in the headers
1387 and footers for the slides, and so she defines the page style
1388 "mypagestyle":\footnote{{\tt\string\thedate} is set with the {\tt\string\date}
1389 command.}
1390 \begin{LVerbatim}
1391 \newpagestyle{mypagestyle}%
1392 {\sl Big U \hfil \thedate \hfil \thepage}%
1393 {\hfil File \jobname.tex; printed \today\hfil}
1394 \end{LVerbatim}
1395 Prof.\ Starr wants to use the standard "headings" page style for notes and the
1396 "mypagestyle" page style for slides, and she wants overlays to just have the
1397 overlay number. Therefore, she defines another page style for the overlays:
1398 \begin{LVerbatim}
1399 \newpagestyle{myoverlays}{\hfil \thepage}{}
1400 \end{LVerbatim}
1401 and she puts
1402 \begin{LVerbatim}
1403 \pagestyle{headings}
1404 \slidepagestyle{mypagestyle}
1405 \overlaypagestyle{myoverlays}
1406 \end{LVerbatim}
1407 in the preamble.
1408
1409 \faq{How do I change a parameter only for the {\tt slides} format?}
1410 \label{conditionals}
1411
1412 The conditionals
1413 \begin{MD}
1414 \ifarticle\ $\ldots$ "\else" $\ldots$ "\fi"\\
1415 \ifslidesonly\ $\ldots$ "\else" $\ldots$ "\fi"\\
1416 \ifnotes\ $\ldots$ "\else" $\ldots$ "\fi"\\
1417 \ifnotesonly\ $\ldots$ "\else" $\ldots$ "\fi"\\
1418 \ifportrait\ $\ldots$ "\else" $\ldots$ "\fi"
1419 \end{MD}
1420 allow one to select for what versions material is to be processed. "\ifnotes"
1421 is true if and only if the "notes" selection is in effect, and so on. The
1422 "\else" clause is optional. See {\em The \TeX book}, Chapter 20, for more
1423 information about using conditionals.
1424
1425 For example, the first line below sets the slide rotation to "right" in the
1426 "article" format only. The second line changes the page style for the "notes"
1427 and "notesonly" selections and "article" format:
1428 \begin{LVerbatim}
1429 \ifarticle\sliderotation{right}\fi
1430 \ifarticle\ifslidesonly\else\pagestyle{myheadings}\fi\fi
1431 \end{LVerbatim}
1432
1433 \faq{Why does extra space get inserted at the top of a slide when I begin the
1434 slide with a color or overlay command (when using the \o{semcolor} option)?}
1435
1436 Color and overlay commands with the "semcolor" option use "\special"'s. \TeX{}
1437 adds the space "\parskip" between the "\special"'s and the first material in
1438 the slide.
1439
1440 Here is the workaround: If that material is an ordinary paragraph, put the
1441 command "\leavevmode" just after the color or overlay command. In other cases,
1442 if you are sure this is the problem, put "\vskip-\parskip" just before the
1443 color or overlay command.
1444
1445 \section{Errors\label{errors}}
1446
1447 There are several errors that identify themselves as being from "seminar.sty",
1448 but the error messages are so self-explanatory that that there is no need to
1449 describe them here. Instead, this section explains a few especially cryptic
1450 \TeX{} error messages that can arise when using "seminar.sty". These errors
1451 may also arise for reasons that are not particular to the "seminar.sty"
1452 macros. See your favorite \TeX{} and \LaTeX{} manuals for more help in
1453 debugging your documents.
1454
1455 \error"! File ended while scanning use of \next."
1456
1457 You are missing an "\end{document}" on the main file or an "\endinput" on a
1458 file that is input.
1459
1460
1461 \error"! File ended within \read."
1462
1463 You may have an unmatched curly brace following "\begin{slide}" on the same
1464 line. See Section \ref{omit}.
1465
1466
1467 \error"! Paragraph ended before \begin@slide was complete."
1468
1469 You have not specified the optional argument for the "slide" or "slide*"
1470 environment correctly (see Section \ref{slidedim}), or the first character in
1471 a slide environment is a "[" (put a pair "{}" of braces before the "[").
1472
1473 \section{Troubleshooting\label{trouble}}
1474 \setcounter{faq}{0}
1475
1476 \faq{A few slides do not come out two-up with the \o{article} option.}
1477
1478 First, read Section \ref{S-twoup} carefully. If the slides still do not come
1479 out twoup, it might be that there is extraneous output between the slides. Try
1480 putting the commands
1481 \begin{LVerbatim}
1482 \slideplacement{here*}
1483 \setlength{\slidesep}{8pt plus 1fill}
1484 \end{LVerbatim}
1485 in the preamble ("8pt" should be one-half the minimum distance between
1486 slides). If this solves the problem, look for the extraneous output, or just
1487 leave those commands in the preamble.
1488
1489
1490 \faq{What kind of incompatibilities are there between {\tt seminar.sty} and
1491 other macros?}
1492
1493 Of course, whenever you load macros that are not part of the standard \LaTeX{}
1494 distribution and that were not designed to work with "seminar.sty", problems
1495 may arise because of name conflicts. What are listed here are changes made to
1496 \LaTeX{} commands that may conflict with other macros that also redefine these
1497 command. The problems listed here are very unlikely to occur, however, unless
1498 you have a habit of seriously hacking the standard \LaTeX{} macro files.
1499
1500 \begin{enumerate}
1501 \item This style modifies the definitions of the \LaTeX{} primitive
1502 "\document". It generally will not be upset by, nor will it void,
1503 modifications to "\document" made before "seminar.sty" is input. However,
1504 subsequent modifications of "\document" may cause problems.
1505
1506 \item "xcomment.sty", which is input by "seminar.sty" with the "slidesonly"
1507 selection, modifies the definition of "\end" within included environments.
1508 This is generally compatible with modifications to "\end" made outside
1509 environments, but may conflict with modifications to "\end" made inside
1510 environments.
1511 \end{enumerate}
1512
1513 \faq{Why are the landscape slides displayed sideways and the portrait slides
1514 displayed upside down on my previewer?}
1515
1516 This document style makes frequent use of landscape mode. Some DVI-to-PS
1517 converters, such as older versions of Rokicki's "dvips", use their own
1518 PostScript macros to print a landscape document, rather than simply
1519 instructing PostScript to use landscape mode.
1520 If the PostScript output of such a converter is viewed using a PostScript
1521 previewer that does not allow you to choose the orientation of the display,
1522 the output will be positioned correctly on the page, but the page will always
1523 be displayed in portrait mode. When viewing slides without the "portrait"
1524 option, the landscape slides will be sideways, and the portrait slides will be
1525 upside-down!
1526
1527 There is nothing this style can do to coerce the page to be displayed in
1528 landscape mode. There are various ways to minimize neck strain, however:
1529 \begin{enumerate}
1530 \item The direction in which the portrait slides are rotated can be reversed,
1531 so that they end up right-side-up. Just put
1532 \begin{LVerbatim}
1533 \sliderotation{right}
1534 \end{LVerbatim}
1535 before the beginning of the document (assuming that you are using rotation
1536 macros).
1537 \item You can also get the portrait slides to be displayed right-side-up by
1538 using the "portrait" style option (Section \ref{options}).
1539 \item In the "article" format, the document is typeset in portrait mode
1540 (unless the "portrait" option is used), and so the landscape slides are
1541 right-side-up. You can use this format when composing and proof-reading the
1542 slides.
1543 \end{enumerate}
1544
1545 \faq{Why is my dvi driver soooo slow?}
1546
1547 Probably it cannot find the right font bitmaps, and so it is either
1548 automatically generating new ones, or it is scaling the ones it can find.
1549 Either way, as long as you can somehow generate the missing font bitmaps, this
1550 problem is transitory. See Appendix \ref{bitmaps} for details.
1551
1552 \faq{Why does \TeX{} complain about missing circle fonts?}
1553
1554 Older versions of the NFSS use the names "circle10" and "circlew10" for the
1555 \LaTeX circle fonts, instead of the otherwise standard names "lcircle10" and
1556 "lcirclew10". You can copy your ".pk" and ".tfm" files to the new names, or
1557 get a new version of the NFSS.
1558
1559 \section{Converting \SliTeX\ files}\label{slitex}
1560
1561 "seminar.sty" can do everything \SliTeX\ can do, and much
1562 more\footnote{However, color layers and overlays require PSTricks and a
1563 PostScript printer.} Here is a brief and incomplete description of how to do
1564 with "seminar.sty" what you can do with \SliTeX, and how to convert \SliTeX\
1565 files.
1566
1567 \begin{itemize}
1568 \item Use "seminar" as your document style, instead of "slides".
1569
1570 \item Run \LaTeX\ or \AmS-\LaTeX, instead of \SliTeX.
1571
1572 \item With "seminar.sty", the preamble and slides can all go in the same
1573 file.
1574
1575 \item The default in "seminar.sty" is to get landscape slides. If you want
1576 to convert a \SliTeX\ file containing portrait slides, add the "portrait"
1577 style option, and replace your "slide" environments by "slide*" environments.
1578
1579 \item With "seminar.sty", notes do not need to go in a separate environment.
1580 To convert a \SliTeX\ file containing "note" environments, define a note
1581 environment that does nothing:
1582 \begin{LVerbatim}
1583 \newenvironment{note}{}{}
1584 \end{LVerbatim}
1585
1586 \item For color layers:
1587 \begin{itemize}
1588 \item Use the "\colorlayers" command instead of the "\colors" command.
1589 \item Delete the argument to the "slide" and "slide*" environments that
1590 lists the color layers.
1591 \item Include the \o{semlayer} style option.
1592 \end{itemize}
1593
1594 \item "seminar.sty" does not use separate environments for overlays:
1595 \begin{itemize}
1596 \item Remove the "overlay" environments.
1597 \item Replace "\invisible" commands by "\overlay{1}", "\overlay{2}", etc.
1598 \item Include the \o{semlayer} style option.
1599 \end{itemize}
1600
1601 \item To actually produce the overlays and color layers, you have to have
1602 PSTricks and a PostScript printer, and you must include the \o{semcolor} style
1603 option.
1604
1605 \item Use \n\onlyslides"{<list>}" and \n\onlynotestoo\ instead of
1606 "\onlynotes".
1607 \end{itemize}
1608
1609
1610 \begingroup
1611 \def\addcontentsline#1#2#3{}%
1612 \def\thepart{Appendices:}
1613 \part{Configuration}
1614 \endgroup
1615 \begingroup
1616 \def\thepart{}
1617 \addcontentsline{toc}{part}{Appendices:\hspace{1em}Configuration}
1618 \endgroup
1619 \appendix
1620
1621 Before reading this appendix, you should follow the installation instructions
1622 in the file "sem-read.me" that is distributed with "seminar.sty".
1623
1624 \section{The short story about fonts}\label{short-fonts}
1625
1626 "seminar.sty" is a \LaTeX{} style, and you can use whatever fonts that are
1627 compatible with \LaTeX\ (or \AmS-\LaTeX). However, you are likely to want to
1628 use special fonts with "seminar.sty"; see Appendix \ref{fonts} for help.
1629 Furthermore, you are likely to want to use fonts in sizes that are larger than
1630 the standard sizes; see Appendix \ref{bitmaps} for help.
1631
1632 But if you don't want to read these appendices, you can just use whatever
1633 \LaTeX\ fonts you know how to use (e.g., the standard Computer Modern fonts).
1634 To be sure you need only standard font magnifications:\footnote{This is not a
1635 consideration if you are using only PostScript or other scalable fonts.}
1636 \begin{itemize}\label{font-res}
1637 \item Don't use the "11pt" or "12pt" style options (or the \n\ptsize{}
1638 command).
1639 \item Don't change the document magnification (or only use 0--4 magsteps).
1640 \item Don't use any font size larger than "\large".
1641 \item Don't use the \n\twoup\ command.
1642 \end{itemize}
1643
1644 \section{Choosing fonts\label{fonts}}
1645
1646 So that you can use different fonts for the notes and the slides (if you
1647 want), the command "\slidefonts" is invoked at the beginning of every slide
1648 environment. Define it to set up any special fonts for the slides.
1649
1650 Here are the font configurations that come ready-to-use with "seminar.sty".
1651 You might also use these as a starting point for your own configurations.
1652 \begin{enumerate}
1653 \item You can just use the regular old Computer Modern fonts that you probably
1654 grew up on. For this, you don't have to do anything at all. Ain't that easy?
1655 But see the next section about font bitmaps.
1656
1657 \item The \O{semhelv} style option sets up the PostScript Helvetica text fonts
1658 for the slides. The Computer Modern fonts are still used for math and for the
1659 notes with the \o{article} format. You need a PostScript printer, a dvi-to-ps
1660 driver that supports PostScript fonts (e.g., Rokicki's "dvips"), and the New
1661 Font Selection Scheme. You should also check the font file names used in
1662 "semhelv.sty", and change them if necessary to match the names on your system.
1663
1664 This combination of fonts is highly recommended because sans serif fonts look
1665 good for slides, Helvetica is a resident font in just about all PostScript
1666 printers, and the fonts are scalable and thus there is no problem of needing
1667 new bitmaps.
1668
1669 \item The \O{semlcmss} style option sets up the \SliTeX\ sans serif fonts for
1670 the slides, and uses the Computer Modern fonts for notes with the \o{article}
1671 format. The \SliTeX\ fonts are ugly, but they might be the only usable sans
1672 serif font you have on your system and you are really dying for that kind of
1673 font. Also, they usually come ready for printing magnified documents, and so
1674 you won't need too many new font bitmaps. You must have the New Font Selection
1675 Scheme. "semlcmss" uses
1676 \begin{LVerbatim}
1677 \slidesmag{4}
1678 \ptsize{10}
1679 \end{LVerbatim}
1680 Deviating from this will increase the need for new font bitmaps.
1681 \end{enumerate}
1682
1683 The New Font Selection Scheme (NFSS) mentioned above is a macro package for
1684 \LaTeX{} that greatly simplifies using non-standard fonts. The NFSS was
1685 written by Frank Mittelbach and Rainer Sch\"opf, and is available from various
1686 archives, including:
1687 \begin{center}
1688 "ftp.uni-stuttgart.de"
1689 \end{center}
1690 It is far easier to take the 10 minutes or so that are required (in theory, at
1691 least) to install the NFSS, than it is to try to muck around with \LaTeX's
1692 font primitives.
1693
1694
1695 \section{Font bitmaps\label{bitmaps}}
1696
1697 If you are only using PostScript or other scalable fonts, or if you obey the
1698 restrictions listed on page \pageref{font-res}, then you can ignores this
1699 appendix.
1700
1701 To use "seminar.sty", you may need font bitmap sizes that are not currently
1702 found on your system. This section describes how to avoid this and what to do
1703 about it. First, a few paragraphs about magnification and font bitmaps.
1704
1705 \TeX's Metafont fonts are designed for a type size, such as 5pt. Most font
1706 families are available at least in the sizes 5pt, 6pt, 7pt, 8pt, 9pt and 10pt.
1707 Some are also available in the sizes 12pt and 17pt (and others), but often any
1708 size above 10pt is obtained by scaling the 10pt fonts. Table \ref{font-mag}
1709 lists the possible magnifications for fonts, depending on which option you are
1710 using ("10pt", "11pt" or "12pt"), and depending on the \LaTeX{} type size
1711 declaration that is in effect (e.g., "\small"). The magnifications are given
1712 in magsteps, which is \TeX's standard unit for font magnifications. $n$
1713 magsteps means a magnification of $1.2^n$.
1714
1715 \begin{table}
1716 \hrule height 1pt\relax
1717 \begin{center}
1718 \begin{tabular}{l|c|c|c|}
1719 \multicolumn{1}{l}{size} &
1720 \multicolumn{1}{c}{default (10pt)} &
1721 \multicolumn{1}{c}{11pt option} &
1722 \multicolumn{1}{c}{12pt option}\\
1723 \cline{2-4} "\tiny" & 0 & 0 & 0\\
1724 \cline{2-4} "\scriptsize" & 0 & 0 & 0\\
1725 \cline{2-4} "\footnotesize" & 0 & 0 & 0 \\
1726 \cline{2-4} "\small" & 0 & 0 & 1/2 \\
1727 \cline{2-4} "\normalsize" & 0 & 1/2 & 1 \\
1728 \cline{2-4} "\large" & 1 & 1 & 2 \\
1729 \cline{2-4} "\Large" & 2 & 2 & 3 \\
1730 \cline{2-4} "\LARGE" & 3 & 3 & 4\\
1731 \cline{2-4} "\huge" & 4 & 4 & 5\\
1732 \cline{2-4} "\Huge" & 5 & 5 & 5\\
1733 \cline{2-4}
1734 \end{tabular}
1735
1736 \caption{Font magnification in magsteps ($n$ means a magnification of $1.2^n$)
1737 for a font that is available in 5pt, 6pt, 7pt, 8pt, 9pt and 10pt
1738 sizes.\label{font-mag}}
1739 \end{center}
1740 \hrule height 1pt\relax
1741 \end{table}
1742
1743 Both the "article" and the "slides" formats may also magnify the document. By
1744 default, the magnification of the "slides" format is 4 magsteps, and the
1745 magnification of the "article" format is 0. To find the total font
1746 magnification, add the magnification listed in the table to the magnification
1747 of the document. E.g., in the "slides" format with the "12pt" option (or the
1748 command "\ptsize{12}" at the beginning of a slide), the "\large" command may
1749 invoke fonts that have a magnification of up to 7 magsteps.
1750
1751 Most systems have font bitmaps for 0, 1/2, 1, 2, 3, 4 and 5 magsteps. If you
1752 obey the restrictions listed on page \pageref{font-res}, then you will only
1753 need fonts in these standard magnifications. However, if you want to use other
1754 font magnifications, then check with your system administrator to determine
1755 which of the following applies to you (or just plunge ahead and see what
1756 happens):
1757 \begin{enumerate}
1758 \item If you have Metafont and "dvips" or some other driver that automatically
1759 generates font bitmaps as needed, and if this feature is enabled, then you
1760 will simply notice that it takes a long time to print documents at first,
1761 because the driver has to wait for the new font bitmaps to be made.
1762 Eventually, you will have generated all the extra bitmaps you need, and this
1763 delay will go away.
1764 \item If you have Metafont, but your dvi driver does not automatically
1765 generate needed bitmaps, then you just need to keep track of what font bitmaps
1766 you are missing as you use "seminar.sty" and occasionally run Metafont to make
1767 them. You will also notice a delay when a font bitmap is missing, because your
1768 driver will probably scale the closest bitmap it finds, and this can take time
1769 on some systems.
1770 \item If you do not even have Metafont, then you have to try to get by without
1771 the extra bitmaps. Scaled fonts look lousy, but an occasional scaled font in a
1772 heading is not so bad.
1773 \end{enumerate}
1774
1775 Of course, PostScript and other scalable fonts do not present any problem, and
1776 so it is a good idea to use these as much as possible. The Computer Modern
1777 fonts are available from Blue Sky Research in PostScript Type I format. If you
1778 do not have PostScript versions of the CM fonts, and you instead use other
1779 PostScript fonts for text, then you are likely to still need bitmapped fonts
1780 for mathematics. However, since mathematics is usually set at "\normalsize" or
1781 smaller, this is not a big problem.
1782
1783 If you are installing "seminar.sty" on a multi-user system, then hopefully you
1784 will make the needed fonts available.
1785
1786 \section{Color}
1787
1788 You can use whatever color commands you ordinarily use with \LaTeX. You might
1789 try the \o{semcolor} style option, which lets you use the PSTricks color
1790 commands for printing on a color PostScript printer. The \o{semcolor} option
1791 combined with the \o{semlayer} option (see Section \ref{S-overlays}) lets you
1792 print color layers.
1793
1794 \section{Landscape printing and slide rotation\label{S-landscape}}
1795
1796 If your dvi driver supports a "\special" for landscape printing, then you can
1797 define \N\printlandscape\ in the preamble of your document to invoke this
1798 command. E.g., for "dvips" put the line
1799 \begin{LVerbatim}
1800 \renewcommand{\printlandscape}{\special{landscape}}
1801 \end{LVerbatim}
1802 in the preamble. Otherwise, "seminar.sty" will display a message reminding you
1803 to print your document in landscape mode, when appropriate.
1804
1805 You can print both landscape and portrait slides in one shot if you can rotate
1806 the portrait slides when printing in landscape mode or the landscape slides
1807 when printing in portrait mode. If you are using a PostScript printer, you
1808 probably are using a dvi driver that supports rotation; otherwise, you
1809 probably are not. Here are suggestions for setting up rotation:
1810 \begin{itemize}
1811 \item The \o{semcolor} option provides an interface to the rotation macros in
1812 PSTricks (see Appendix \ref{S-semcolor}); it works with many popular dvi-to-ps
1813 drivers.
1814
1815 \item If you are using Rokicki's "dvips" and want rotation but do not want to
1816 load the entire PSTricks package, then use the \O{semrot} option instead of
1817 the \o{semcolor} option.
1818
1819 \item If the \o{semcolor} and \o{semrot} options do not work for you, but you
1820 have your own rotation macros, then you have to define the commands
1821 \begin{MD}
1822 \leftsliderotation\\
1823 \rightsliderotation
1824 \end{MD}
1825 so that they rotate something left and right, respectively. For example,
1826 \begin{LVerbatim}
1827 \renewcommand{\leftsliderotation}[1]{\rotateleft{#1}}
1828 \end{LVerbatim}
1829 \end{itemize}
1830
1831 In any case, you can determine the direction of rotation using
1832 \begin{MD}
1833 \sliderotation{direction}
1834 \end{MD}
1835 where valid directions are "none", "left" and "right". The default is "left".
1836
1837 By default, the headers and footers aren't rotated, but you can switch between
1838 rotating and not rotating the headers with the commands:
1839 \begin{MD}
1840 \rotateheaderstrue\\
1841 \rotateheadersfalse
1842 \end{MD}
1843
1844 \section{The semcolor style option\label{S-semcolor}}
1845
1846 The \O{semcolor} option sets up an interface between "seminar.sty" and the
1847 PSTricks package. PSTricks is a collection of PostScript macros for \TeX. It
1848 works with Rokicki's "dvips", and several other dvi-to-ps drivers. You can
1849 probably get the PSTricks package from wherever you obtained "seminar.sty", or
1850 check the archives listed in the PSTricks read-me file, "read-me.pst", which
1851 is distributed with "seminar.sty".
1852
1853 What the \o{semcolor} style option gives you, compared to just using the
1854 PSTricks package, is:
1855 \begin{description}
1856 \item[Color] A small patch to make the PSTricks color commands more robust in
1857 slides.
1858 \item[Rotation] The rotations "left" and "right" are defined. "left" is the
1859 default.
1860 \item[Framing] The frame styles "scplain" (using "\psframebox"), "scdouble"
1861 (using "\psdblframebox") and "scshadow" (using "\psshadowbox").
1862 \item[Overlays] Overlays and layers, when used in conjunction with the
1863 \o{semlayer} option.
1864 \end{description}
1865
1866 \section{A4 and other paper sizes\label{S-papersizes}}
1867
1868 Use the \O{a4} option when using A4 paper. Note that this option does not
1869 correspond to an independent file.
1870
1871 If you want to configure seminar.sty for A4 paper by default (without having
1872 to include style options), then you can do one of the following:
1873 \begin{enumerate}
1874
1875 \item Add the following line to "seminar.con" (see Appendix
1876 \ref{S-configfile}):
1877 \begin{LVerbatim}
1878 \input{sem-a4.sty}
1879 \end{LVerbatim}
1880
1881 \item Add the following lines to "seminar.con" (these lines are just the
1882 contents of "sem-a4.sty"):
1883 \begin{LVerbatim}
1884 \def\paperwidth{210mm}
1885 \def\paperheight{297mm}
1886 \input sem-page.sty
1887 \slidewidth 222mm
1888 \slideheight 152mm
1889 \end{LVerbatim}
1890
1891 \item Create a file such as "mysem.sty", to be used as a document {\em
1892 style} (rather than style {\em option}), with the following lines:
1893 \begin{LVerbatim}
1894 \def\paperwidth{210mm}
1895 \def\paperheight{297mm}
1896 \input seminar.sty
1897 \slidewidth 222mm
1898 \slideheight 152mm
1899 \end{LVerbatim}
1900
1901 \end{enumerate}
1902
1903 For other paper sizes, you can create a style option by modifying
1904 "sem-a4.sty". Then any of the options described above is available to you,
1905 (with the appropriate parameter values). However, this will give satisfactory
1906 results only for paper sizes that are close to A4 or 8.5in by 11in.
1907
1908 Note that for any paper size, even 8.5in by 11in, the page parameters that are
1909 set this way are just suggested defaults, and most people will want to
1910 customize them. Because of the variety of ways in which "seminar.sty"
1911 documents can be printed, this is a little more complex than with most
1912 document styles. Examine "sem-page.sty" to see what page parameters need to be
1913 set, and when.
1914
1915 \section{Configuration file\label{S-configfile}}
1916
1917 You can put customizations to "seminar.sty" in a file named "seminar.con".
1918 This file is optional. It is loaded by "seminar.sty" if it exists, {\em
1919 before} loading the style option files. E.g., "seminar.con" might contain the
1920 following lines:
1921 \begin{LVerbatim}
1922 \input semhelv.sty
1923 \input semcolor.sty
1924 \renewcommand{\printlandscape}{\special{landscape}}
1925 \endinput
1926 \end{LVerbatim}
1927
1928 \clearpage
1929 \PrintUserIndex
1930
1931 \end{document}
1932 %% END sem-user.tex