| 1 |
------------------------------------------------------- |
| 2 |
IMPORTANT NOTE |
| 3 |
|
| 4 |
With the agreement of Timothy Van Zandt (now [email protected]), |
| 5 |
the distributions conditions on seminar are now relaxed to: |
| 6 |
%% |
| 7 |
%% This file may be distributed and/or modified under the conditions of |
| 8 |
%% the LaTeX Project Public License, either version 1.2 of this license |
| 9 |
%% or (at your option) any later version. The latest version of this |
| 10 |
%% license is in: |
| 11 |
%% |
| 12 |
%% http://www.latex-project.org/lppl.txt |
| 13 |
%% |
| 14 |
%% and version 1.2 or later is part of all distributions of LaTeX version |
| 15 |
%% 1999/12/01 or later. |
| 16 |
%% |
| 17 |
|
| 18 |
June 3rd 1999 (last updated September 2005) |
| 19 |
Sebastian Rahtz <[email protected]> |
| 20 |
Denis Girou <[email protected]> |
| 21 |
Herbert Voß <[email protected]> |
| 22 |
|
| 23 |
(Tim's helpers on earth) |
| 24 |
------------------------------------------------------- |
| 25 |
|
| 26 |
%% BEGIN sem-read.me |
| 27 |
*********************************************************************** |
| 28 |
**** "readme" file for seminar.cls package, v1.0, 93/04/01 **** |
| 29 |
*********************************************************************** |
| 30 |
|
| 31 |
COPYRIGHT 1993, by Timothy Van Zandt |
| 32 |
|
| 33 |
DESCRIPTION: |
| 34 |
|
| 35 |
seminar.sty is a LaTeX document style for typesetting slides or |
| 36 |
transparencies, and accompanying notes. It has many advantages over |
| 37 |
SliTeX. Here are some of the style's special features: |
| 38 |
* It is a LaTeX style, rather than another format. |
| 39 |
* It is compatible with AmS-LaTeX. |
| 40 |
* You can use any fonts that work with LaTeX, including PostScript |
| 41 |
fonts and AmSFonts. |
| 42 |
* Slides can be landscape and portrait within the same file. |
| 43 |
* Color is supported through PostScript. |
| 44 |
* The slides can have a frame and a colored background. |
| 45 |
* The magnification can be changed with a single command. |
| 46 |
* Overlays can be produced from a single slide environment. |
| 47 |
* Accompanying notes, such as the text of a presentation, can be put |
| 48 |
outside the slide environments. The slides, notes or both together |
| 49 |
can then be typeset in a variety of formats. |
| 50 |
Some of these features require a PostScript output device. |
| 51 |
|
| 52 |
FILES: |
| 53 |
|
| 54 |
LaTeX: |
| 55 |
seminar.cls : The main class file. |
| 56 |
seminar.sty : The main style file. |
| 57 |
seminar.con : The main config file. |
| 58 |
sem-page.sty : Page parameters. |
| 59 |
semlayer.sty : The semlayer style option (overlays and color layers). |
| 60 |
semhelv.sty : The semhelv style option . |
| 61 |
semlcmss.sty : The semlcmss style option. |
| 62 |
semcolor.sty : The semcolor style option. |
| 63 |
semrot.sty : THe semrot style option. |
| 64 |
slidesec.sty : The slidesec style option. |
| 65 |
sem-a4.sty : The sem-a4 style option. |
| 66 |
xcomment.sty : The macros for omitting notes. |
| 67 |
2up.tex : Macros for printing documents two-up. |
| 68 |
2up.sty : The same as 2up.tex, but with .sty extension. |
| 69 |
npsfont.sty : Macros for defining new PostScript fonts with the NFSS. |
| 70 |
fancybox.sty : Box tips and tricks for LaTeX. |
| 71 |
|
| 72 |
Documentation: |
| 73 |
sem-user.tex : User's guide for seminar.sty. |
| 74 |
sem-user.ind : Index for sem-user.tex. |
| 75 |
semsamp1.tex : A sample document for seminar.sty. |
| 76 |
semsamp2.tex : Another sample document for seminar.sty. |
| 77 |
2up.doc : Documentation for 2up.tex. |
| 78 |
fancybox.doc : Documentation for fancybox.sty. |
| 79 |
tvz-hax.sty : For typesetting sem-user.tex and sem-code.tex. |
| 80 |
tvz-code.sty : For typesetting sem-code.tex. |
| 81 |
tvz-user.sty : For typesetting sem-user.tex. |
| 82 |
sem-read.me : This file. |
| 83 |
read-me.pst : The read-me file for the PSTricks package. |
| 84 |
|
| 85 |
Sources: |
| 86 |
seminar.doc : Documented code for seminar.sty. |
| 87 |
semlayer.doc : Documented code for semlayer.sty. |
| 88 |
xcomment.doc : Documented code for xcomment.sty. |
| 89 |
sem-make.tex : For extracting code from seminar.doc and semlayer.doc. |
| 90 |
sem-code.tex : For typesetting seminar.doc and semlayer.doc. |
| 91 |
xc-make.tex : For extracting code from xcomment.doc. |
| 92 |
xcomment.tex : For typesetting xcomment.doc. |
| 93 |
|
| 94 |
GETTING STARTED: |
| 95 |
|
| 96 |
1. Put the input files in a directory where your TeX looks for inputs. |
| 97 |
|
| 98 |
2. Typeset and print sem-user.tex. |
| 99 |
|
| 100 |
3. Read the preface "Getting Started", and then the appendices. |
| 101 |
|
| 102 |
4. Typeset semsamp1.tex and semsamp2.tex. |
| 103 |
|
| 104 |
5 If upgrading from v0.92, see the changes listed at the end of this |
| 105 |
file. If upgrading from v0.91 or earlier, good luck. |
| 106 |
|
| 107 |
HACKERS: |
| 108 |
|
| 109 |
The files seminar.doc, semlayer.doc and xcomment.doc contain the |
| 110 |
documented code, using Frank Mittelbach's doc system. |
| 111 |
See sem-code.tex and xcomment.tex for instructions on typesetting |
| 112 |
these files. |
| 113 |
See sem-make.tex and xc-make.tex for instruction on extracting |
| 114 |
stripped input (.sty) files from these .doc files. |
| 115 |
|
| 116 |
MORE ABOUT THE SUPPLEMENTAL STYLES AND MACROS: |
| 117 |
|
| 118 |
The following styles and macros are not specifically for use |
| 119 |
with seminar.sty, and hence are not described in detail in |
| 120 |
the seminar.sty User's Guide. You do not need to read the |
| 121 |
documentation of these files in order to use seminar.sty. |
| 122 |
If you have versions on your system that are older than the |
| 123 |
ones distributed with seminar.sty, be sure to replace these. |
| 124 |
|
| 125 |
FANCYBOX.STY: |
| 126 |
fancybox.sty is a LaTeX style option with tips and tricks for LR-box |
| 127 |
commands. The documentation, fancybox.doc, is extensive. |
| 128 |
|
| 129 |
2UP.TEX: |
| 130 |
2up.tex/2up.sty contains macros for typesetting documents in a |
| 131 |
two-up format. seminar.sty's \twoup command provides an interface. |
| 132 |
2up.doc is the documentation for 2up.tex. |
| 133 |
|
| 134 |
NPSFONT.STY: |
| 135 |
npsfont.sty contains macros for defining new PostScript fonts |
| 136 |
with the New Font Selection Scheme. The documentation is in |
| 137 |
npsfont.sty itself. |
| 138 |
|
| 139 |
XCOMMENT.STY: |
| 140 |
xcomment.sty, a LaTeX style option, permits one to typeset only |
| 141 |
selected environments, omitting input outside these environments. |
| 142 |
See xcomment.tex if you want to typeset the documentation. |
| 143 |
|
| 144 |
SLIDESEC.STY |
| 145 |
slidesec.sty is an experimental file contains sectioning commands |
| 146 |
for slide type documents. The documentation is in slidesec.sty |
| 147 |
itself. |
| 148 |
|
| 149 |
|
| 150 |
SEMINAR.STY AND PSTRICKS.TEX: |
| 151 |
|
| 152 |
pstricks.tex is a collection of PostScript macros that is compatible |
| 153 |
with most TeX macro packages, including Plain TeX and LaTeX. Included are |
| 154 |
macros for color, graphics, rotation, overlays, nodes and much more. |
| 155 |
|
| 156 |
seminar.sty, combined with the semcolor option, the PSTricks package, |
| 157 |
and your favorite macros for including EPS files, make a complete |
| 158 |
TeX presentation software package. |
| 159 |
|
| 160 |
You can probably obtain the PSTricks package from wherever you got |
| 161 |
the Seminar package, or try |
| 162 |
Princeton.EDU:/pub or Princeton.EDU:/pub/tvz |
| 163 |
|
| 164 |
You must install the PSTricks package before using the semcolor option. |
| 165 |
|
| 166 |
seminar.sty will work with pstricks.tex v0.92, and maybe later |
| 167 |
versions. |
| 168 |
|
| 169 |
|
| 170 |
ACKNOWLEDGEMENTS: |
| 171 |
|
| 172 |
The author is thankful to Frank Mittelbach for his documentation system. |
| 173 |
|
| 174 |
Thanks to Sebastian Rahtz for bits of advice, and many users for |
| 175 |
comments and bug reports. |
| 176 |
|
| 177 |
BUGS: |
| 178 |
|
| 179 |
Too many to list, and who knows what they are anyway. These files are all |
| 180 |
preliminary and unstable. Not responsible for neck injuries. |
| 181 |
|
| 182 |
|
| 183 |
Thanks. |
| 184 |
|
| 185 |
CHANGES: |
| 186 |
|
| 187 |
v1.0: Included sem-a4.sty file, as a way to let the default papersize |
| 188 |
be A4 (The a4 option still works). Added \epsfslidesize to make |
| 189 |
it easier to set the slide of eps files with epsf.sty. Fixed bug |
| 190 |
which caused the width of second pages of a multi-page slide to |
| 191 |
end up too small if the page only contained a quote or similar |
| 192 |
environment with reduced margins. |
| 193 |
|
| 194 |
v0.93a: Fixed bugs so that slides would come out properly with the |
| 195 |
2-up,article and portrait options (together), and so that |
| 196 |
slides would be positioned correctly with the portrait style |
| 197 |
option. |
| 198 |
|
| 199 |
v0.93: |
| 200 |
|
| 201 |
INCOMPATIBLE CHANGES: |
| 202 |
|
| 203 |
! Use the a4 option instead of sem-a4. There is not longer a |
| 204 |
separate file for a4. |
| 205 |
|
| 206 |
! No more \fewnotes, \nonotes. Use \slideplacement instead. |
| 207 |
|
| 208 |
! No more \layerstyle, \overlaystyle. |
| 209 |
|
| 210 |
! Slide styles are now "left" and "bottom". |
| 211 |
|
| 212 |
! No more \ifslides. Use \ifarticle\else. |
| 213 |
|
| 214 |
! You must now use the semlayer option to use overlays (in addition |
| 215 |
to the semcolor option). |
| 216 |
|
| 217 |
! No "down" slide rotation (only "none", "left" and "right". |
| 218 |
|
| 219 |
! portrait option is no longer a separate file. |
| 220 |
|
| 221 |
! \paperwidth and \paperheight are now ordinary commands, to be set |
| 222 |
with \renewcommand. |
| 223 |
|
| 224 |
! \slidefonts is now always invoked in slide environments, and never in |
| 225 |
the preamble. (But semhelv.sty and semlcmss.sty have changed to |
| 226 |
reflect this.) |
| 227 |
|
| 228 |
! Method for customizing the slide frames has changed. |
| 229 |
\slideframecolor, \slideframearc, \slidefillcolor and |
| 230 |
\slideshadowcolor are obsolete. |
| 231 |
|
| 232 |
! \landscape command replaced by \printlandscape to avoid conflict with |
| 233 |
other style files. (E.g., \def\printlandscape{\special{landscape}}). |
| 234 |
|
| 235 |
NEW FEATURES: |
| 236 |
|
| 237 |
+ A slide environment can have multiple `pages'. \extraslideheight{len} |
| 238 |
controls page cutting. See user's guide for details. |
| 239 |
|
| 240 |
+ \centerslidestrue (default) causes the contents of partially full |
| 241 |
slides to be vertically centered in the slide. \centerslidesfalse |
| 242 |
causes it to be flush top. |
| 243 |
|
| 244 |
+ New \raggedslides[len] command, for setting |
| 245 |
whether right margin in slides is ragged or justified. Default is |
| 246 |
\raggedslides. \raggedslides[0pt] gives justified slides. |
| 247 |
|
| 248 |
+ \slideplacement |
| 249 |
|
| 250 |
+ \onlynotestoo |
| 251 |
|
| 252 |
+ \slideskip and \slideshrink for added control over interline space. |
| 253 |
|
| 254 |
|
| 255 |
+ New: \slideleftmargini, \slideleftmarginii, \slideleftmarginiii, |
| 256 |
\slidelabelsep, \slideitemsep, \slidepartopsep, |
| 257 |
\slideparskip, \slideparindent, \slidefootins, \slidefootnotesep, |
| 258 |
\slidedisplayskips, \theslidefootnote |
| 259 |
|
| 260 |
+ \input and \endinput now supported for the slidesonly selection. |
| 261 |
|
| 262 |
+ New conditional: \ifportrait |
| 263 |
|
| 264 |
+ \newslideframe |
| 265 |
|
| 266 |
+ \leftsliderotation, \rightsliderotation. |
| 267 |
|
| 268 |
+ New \slidetopmargin, \slidebottommargin, \slideleftmargin, |
| 269 |
\sliderightmargin. |
| 270 |
|
| 271 |
+ New notesonly* selection. |
| 272 |
|
| 273 |
+ New \slidesclearpagetrue |
| 274 |
|
| 275 |
+ New \semcm and \semin. |
| 276 |
|
| 277 |
+ New note environment and \noxcomment command, as an alternative |
| 278 |
to treating everything outside slide environments as notes. |
| 279 |
|
| 280 |
|
| 281 |
BACKWARDS-COMPATIBLE CHANGES: |
| 282 |
|
| 283 |
* \maketitle now uses LaTeX's default from article.sty in notes. |
| 284 |
|
| 285 |
* Bug in article option with the \twoup command fixed. |
| 286 |
|
| 287 |
* \topmargin in sem-a4 changed from -.75in to 1in. |
| 288 |
|
| 289 |
* \slidefontsizes is obsolete (but still works). Use \ptsize instead. |
| 290 |
|
| 291 |
* Page parameters are now in a separate file sem-page.sty. sem-a4.sty |
| 292 |
has been changed to reflect this. |
| 293 |
|
| 294 |
v0.92: |
| 295 |
Mostly bug fixes, plus some extra options. The PSTricks package |
| 296 |
is no longer distributed with seminar.sty. |
| 297 |
|
| 298 |
Pre v0.91: |
| 299 |
Entirely rewritten. Too many changes to list. Note especially |
| 300 |
that system of formats and selections has changed. |
| 301 |
|
| 302 |
%% END sem-read.me |
| 303 |
|
| 304 |
|
| 305 |
|
| 306 |
THIS IS A SUPPLEMENTARY READ-ME FOR V1.0e OF THE SEMINAR PACKAGE |
| 307 |
|
| 308 |
*********************************************************************** |
| 309 |
**** "readme" file for the Seminar package, v1.0e, 94/09/12 **** |
| 310 |
*********************************************************************** |
| 311 |
|
| 312 |
COPYRIGHT 1993, 1994 by Timothy Van Zandt, [email protected] |
| 313 |
%% |
| 314 |
%% These files may be distributed and/or modified under the conditions of |
| 315 |
%% the LaTeX Project Public License, either version 1.2 of this license |
| 316 |
%% or (at your option) any later version. The latest version of this |
| 317 |
%% license is in: |
| 318 |
%% |
| 319 |
%% http://www.latex-project.org/lppl.txt |
| 320 |
%% |
| 321 |
%% and version 1.2 or later is part of all distributions of LaTeX version |
| 322 |
%% 1999/12/01 or later. |
| 323 |
%% |
| 324 |
|
| 325 |
BUGS: If you have problems using this seminar package with LaTeX2e, |
| 326 |
report them to [email protected]. The problem probably lies |
| 327 |
with seminar.cls. You can probably continue to use the seminar |
| 328 |
package with LaTeX2e in compatibility mode, while waiting for a bug |
| 329 |
fix, by renaming seminar.cls to something else. |
| 330 |
|
| 331 |
ABOUT V1.0e: |
| 332 |
|
| 333 |
The V1.0e distribution is identical to v1.0 of 93/04/01, |
| 334 |
except for a few changes so that Seminar can work with |
| 335 |
NFSS2 and LaTeX2e: |
| 336 |
|
| 337 |
- semhelv.sty and semlcmss.sty have been modified to work |
| 338 |
with NFSS2 and LaTeX2e (but they still work with NFSS). |
| 339 |
|
| 340 |
- seminar.cls has been added. This is a LaTeX2e document class, |
| 341 |
derived from seminar.sty v1.0 by Sebastian Rahtz. |
| 342 |
|
| 343 |
If you already have have seminar.sty v1.0e, then all you need |
| 344 |
are this read-me file plus these files from the inputs |
| 345 |
directory: |
| 346 |
|
| 347 |
seminar.cls semhelv.sty semlcmss.sty |
| 348 |
|
| 349 |
USING SEMINAR WITH LATEX2E: |
| 350 |
|
| 351 |
!!! YOU MUST BE USING A LATEX2E RELEASED AFTER 19 FEBRUARY 1994 |
| 352 |
|
| 353 |
You can either use seminar.sty in compatibility mode: |
| 354 |
\documentstyle{seminar} |
| 355 |
Or use the seminar.cls document class: |
| 356 |
\documentclass{seminar} |
| 357 |
|
| 358 |
Unless you are using other macros that only work in |
| 359 |
compatibility mode, you might as well use the document class. |
| 360 |
|
| 361 |
You can use the following options with \documentclass{seminar}: |
| 362 |
|
| 363 |
article slidesonly notes notesonly notesonly* |
| 364 |
noxcomment portrait a4 (or a4paper) semhelv semlcmss |
| 365 |
semlayer semrot semcolor slidesec |
| 366 |
|
| 367 |
plus appropriate options for the article document class |
| 368 |
(e.g., 11pt) |
| 369 |
|
| 370 |
NOTE: Use `a4' or `a4paper', not `sem-a4'. |
| 371 |
|
| 372 |
`seminar.cls' is a minimal modification of seminar.sty. The |
| 373 |
next release will take advantage of more of LaTeX2e's special |
| 374 |
capabilities. |
| 375 |
|
| 376 |
|
| 377 |
Tim Van Zandt |
| 378 |
August 24, 1994 |