summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/powerdot/docs/powerdot.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/powerdot/docs/powerdot.tex')
-rw-r--r--Master/texmf-dist/doc/latex/powerdot/docs/powerdot.tex2807
1 files changed, 0 insertions, 2807 deletions
diff --git a/Master/texmf-dist/doc/latex/powerdot/docs/powerdot.tex b/Master/texmf-dist/doc/latex/powerdot/docs/powerdot.tex
deleted file mode 100644
index e0e38b9fdbc..00000000000
--- a/Master/texmf-dist/doc/latex/powerdot/docs/powerdot.tex
+++ /dev/null
@@ -1,2807 +0,0 @@
-%% ---------------------------------------------------------------
-%% Copyright (C) 2005-2011 Hendri Adriaens and Christopher Ellison
-%% ---------------------------------------------------------------
-%%
-%% Version 1.4g prepared by Herbert Voss
-%% Additional work for the documentation by Patrice Mégret
-%%
-%% This work may be distributed and/or modified under the
-%% conditions of the LaTeX Project Public License, either version 1.3
-%% of this license or (at your option) any later version.
-%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
-%% and version 1.3 or later is part of all distributions of LaTeX
-%% version 2003/12/01 or later.
-%%
-%% This work has the LPPL maintenance status "unmaintained".
-%%
-\documentclass[a4paper]{ltxdoc}
-
-\usepackage{url}
-\usepackage{fourier}
-\usepackage{xcolor}
-\usepackage{enumitem}
-\usepackage{graphicx}
-\usepackage{pst-text}
-\usepackage{listings}
-\usepackage{array}
-\usepackage{xkeyval}
-\usepackage[section]{placeins}
-\addtolength\textheight{2cm}
-\addtolength\topmargin{-1cm}
-\lstnewenvironment{command}{%
- \lstset{columns=flexible,frame=single,backgroundcolor=\color{blue!20},%
- xleftmargin=\fboxsep,xrightmargin=\fboxsep,escapeinside=`',gobble=1}}{}
-\lstnewenvironment{example}[1][]{%
- \lstset{basicstyle=\footnotesize\ttfamily,columns=flexible,frame=single,%
- backgroundcolor=\color{yellow!20},xleftmargin=\fboxsep,%
- xrightmargin=\fboxsep,gobble=1,%
- language=[LaTeX]TeX,keywordstyle=\color{blue},%
- moretexcs=[1]{color,ProvidesPackage},%
- moretexcs=[2]{onslide,pause,pdsetup,maketitle,tableofcontents},%
- texcsstyle=[2]\color{red}%
- }\lstset{#1}}{}
-\def\mktitledecor{%
- \rput[tl]{90}(-5.5,-26.51){%
- \psline[linewidth=1pt](0,1.5)(\paperheight,1.5)%
- \rput[lB](.075\paperheight,.5){\pscharpath[linecolor=blue!50,%
- fillcolor=yellow!20,fillstyle=solid,linewidth=.5pt]%
- {\Huge\bfseries\sffamily powerdot}%
- }%
- \rput[rB](.925\paperheight,.5){\pscharpath[linecolor=blue!50,%
- fillcolor=yellow!20,fillstyle=solid,linewidth=.5pt]%
- {\Huge\bfseries Documentation}%
- }%
- \psline[linewidth=1pt](0,0)(\paperheight,0)%
- }%
-}
-\makeatletter
-\def\option#1{%
- \XKV@for@n{#1}\pd@tempa{%
- \fcolorbox{black}{red!20}{\texttt\pd@tempa}\quad
- }%
- \vspace*{.2cm}%
-}
-\def\tableofcontents{\@starttoc{toc}}
-\renewenvironment{theglossary}{%
- \section*{Version history}%
- For more information on bug fixes, typeset the source code
- documentation (see section~\ref{sec:source}).\par\medskip
- \GlossaryParms \let\item\@idxitem \ignorespaces
-}{}%
-\def\DescribeMacros{\leavevmode\@bsphack
- \begingroup\MakePrivateLetters\Describe@Macros}
-\def\Describe@Macros#1{\endgroup\strut
- \marginpar{\raggedleft
- \def\@tempa{#1}\count@\z@
- \XKV@for@o\@tempa\@tempa{%
- \ifnum\count@>\z@\\\fi\advance\count@\@ne
- \MacroFont\expandafter\string\@tempa
- \expandafter\SpecialUsageIndex\expandafter{\@tempa}%
- }}%
- \@esphack\ignorespaces
-}
-\def\DescribeOption#1{\leavevmode\@bsphack
- \marginpar{\raggedleft\PrintDescribeOption{#1}}%
- \SpecialOptionIndex{#1}\@esphack\ignorespaces}
-\def\PrintDescribeOption#1{\strut\emph{option}\\\MacroFont #1\ }
-\def\SpecialOptionIndex#1{\@bsphack
- \index{#1\actualchar{\protect\ttfamily#1}
- (option)\encapchar usage}\@esphack}
-\def\DescribeOptions#1{\leavevmode\@bsphack
- \marginpar{\raggedleft\strut\emph{options}%
- \@for\@tempa:=#1\do{%
- \\\strut\MacroFont\@tempa\SpecialOptionIndex\@tempa
- }}\@esphack\ignorespaces}
-\def\SpecialEnvIndex#1{\@bsphack
- \index{#1\actualchar{\protect\ttfamily#1}
- (environment)\encapchar usage}\@esphack}
-\def\changes@#1#2#3{%
- \protected@edef\@tempa{%
- \noexpand\glossary{\textbf{#1}\hfill\emph{(#2)}%
- \levelchar
- \ifx\saved@macroname\@empty
- \space\actualchar\generalname
- \else
- \expandafter\@gobble\saved@macroname
- \actualchar\string\verb\quotechar*%
- \verbatimchar\saved@macroname\verbatimchar
- \fi
- :\levelchar #3}%
- }%
- \@tempa\endgroup\@esphack
-}
-\makeatother
-\def\PrintChangesX{%
- \begingroup
- \let\efill\relax
- \PrintChanges
- \endgroup
-}
-\def\PrintIndexX{%
- \begingroup
- \setcounter{IndexColumns}{2}
- \setlength{\columnsep}{18pt}%
- \setlength{\columnseprule}{.4pt}%
- \PrintIndex
- \endgroup
-}
-\def\larg#1{{\ttfamily\char`\<}\meta{#1}{\ttfamily\char`\>}}
-\def\LyX{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
-\def\LyXarrow{\leavevmode\,$\triangleright$\,\allowbreak}
-\let\pf\textsf
-\def\equals{=}
-\setcounter{tocdepth}{2}
-\newcolumntype{d}{c|l}
-\newcolumntype{e}{c|c|c|c}
-\newcolumntype{f}{l|p{8cm}}
-\RecordChanges
-\CodelineIndex
-\newcounter{FAQ}
-\def\question{%
- \stepcounter{FAQ}%
- \parskip4pt plus 2pt minus 1pt
- \itemsep4pt plus 2pt minus 1pt
- \parsep4pt plus 2pt minus 1pt
- \item[\textbf{Q\arabic{FAQ}}]%
-}
-\def\answer{%
- \parskip0pt
- \itemsep0pt
- \parsep0pt
- \item[\textbf{A\arabic{FAQ}}]%
-}
-\def\styleexample#1{%
- \IfFileExists{powerdot-styleexample-#1.001}{%
- \IfFileExists{powerdot-styleexample-#1.002}{%
- \hspace*{\stretch{1}}%
- \fbox{\includegraphics[scale=.16,angle=-90,clip]%
- {powerdot-styleexample-#1.001}}%
- \hspace*{\stretch{2}}%
- \fbox{\includegraphics[scale=.16,angle=-90,clip]%
- {powerdot-styleexample-#1.002}}%
- \hspace*{\stretch{1}}\par
- }{\textbf{No example files found for style \pf{#1}.}}%
- }{\textbf{No example files found for style \pf{#1}.}}%
-}
-
-\def\fileversion{v1.4g}
-\def\filedate{2011/04/25}
-
- \changes{v1.0}{2005/09/04}{Initial release}
- \changes{v1.1}{2005/09/19}{Fixed some small bugs}
- \changes{v1.1}{2005/09/19}{Added \texttt{tocsecindent} and
- \texttt{tocslideindent} options}
- \changes{v1.1}{2005/09/19}{Added \pf{elcolors}, \pf{aggie}, \pf{husky}
- and \pf{sailor} styles}
- \changes{v1.1}{2005/09/19}{Changed \texttt{size\protect\equals 10}
- to \texttt{size\protect\equals 10pt}}
- \changes{v1.1}{2005/09/19}{Added \LyX\ layout, description and example}
- \changes{v1.1}{2005/09/19}{Added graphical examples of styles to documentation}
- \changes{v1.1}{2005/09/19}{Improved section title handling}
- \changes{v1.1}{2005/09/19}{\texttt{blackslide} options adds hyperlink
- to slide and section titles}
- \changes{v1.1}{2005/09/19}{Extended FAQ}
- \changes{v1.1}{2005/09/19}{Improved \pf{tycja}, \pf{ciment} and \pf{fyma} styles}
- \changes{v1.2}{2005/10/09}{Added \pf{upen} and \pf{bframe} styles}
- \changes{v1.2}{2005/10/09}{Solved some small bugs}
- \changes{v1.2}{2005/10/09}{Simplified coding of most styles}
- \changes{v1.2}{2005/10/09}{Speeded up compilations}
- \changes{v1.3}{2005/12/06}{Solved some small bugs}
- \changes{v1.3}{2005/12/06}{Improved \texttt{figure} and \texttt{table} handling}
- \changes{v1.3}{2005/12/06}{Added \pf{horatio}, \pf{paintings}, \pf{klope}, \pf{jefka}
- and \pf{pazik} styles}
- \changes{v1.3}{2005/12/06}{Added palettes feature}
- \changes{v1.3}{2005/12/06}{Added random dots feature}
- \changes{v1.3}{2005/12/06}{Added optional argument to \cs{maketitle}}
- \changes{v1.3}{2005/12/06}{Added clock feature}
- \changes{v1.3}{2005/12/06}{Updated all styles}
- \changes{v1.3}{2005/12/06}{Added palettes to \pf{default}, \pf{fyma} and \pf{sailor} styles}
- \changes{v1.3}{2005/12/06}{Revised docs}
- \changes{v1.3}{2005/12/06}{Updated \LyX\ example and information}
- \changes{v1.3}{2005/12/06}{Cleaned up options}
- \changes{v1.3}{2005/12/06}{Added possibility to create horizontal table of contents}
- \changes{v1.3}{2005/12/06}{Added logo feature}
- \changes{v1.3}{2005/12/06}{Added examples and example file}
- \changes{v1.3}{2005/12/06}{Added two slide processing methods to do verbatim on slides easily}
-
- \changes{v1.4 }{2005/12/10}{Moved \texttt{lf} and \texttt{rf} keys from \texttt{global} to \texttt{glslide} family}
- \changes{v1.4 }{2005/12/10}{Added \texttt{cf} option}
- \changes{v1.4 }{2005/12/10}{Updated styles}
- \changes{v1.4 }{2005/12/10}{Solved some small bugs}
- \changes{v1.4 }{2005/12/10}{Moved footers out of slide box in handout mode}
- \changes{v1.4 }{2008/08/24}{Added \texttt{clockformat} and \texttt{clockrefresh} keys to \texttt{global} family}
- \changes{v1.4 }{2008/08/24}{\texttt{blackslide} replaced by the more general \texttt{pauseslide}}
- \changes{v1.4 }{2008/08/24}{\texttt{pauseslide} does not get randomdots anymore}
- \changes{v1.4 }{2008/08/24}{Renames \texttt{nopagebreaks} option to \texttt{nohandoutpagebreaks}}
- \changes{v1.4 }{2008/08/24}{Added option for no frames in handout mode}
-
- \changes{v1.4a}{2010/10/07}{fixed bug with geometry 5.x (hv)}
- \changes{v1.4b}{2010/11/16}{fixed bug with centered footnote (hv)}
- \changes{v1.4c}{2010/11/16}{fixed bug with missing macros for centered footer (hv)}
- \changes{v1.4d}{2010/12/03}{fixed misleading comment header of powerdot.cls (hv)}
- \changes{v1.4e}{2010/12/18}{fixed bugs with enumitem (hv)}
- \changes{v1.4f}{2011/04/01}{added paper size smartboard (hv)}
- \changes{v1.4g}{2011/04/25}{load enumitem version 2.2 and younger (hv)}
-
-
-
-\begin{document}
-%\let\Section\section\def\section*#1{\Section*{#1}\addcontentsline{toc}{section}{#1}}
-\title{\vspace*{-2cm}\mktitledecor The \pf{powerdot} class
-\thanks{This class can be downloaded from the CTAN mirrors:
-\texttt{/macros/latex/contrib/powerdot}. See \texttt{powerdot.tex} for
-information on installing \pf{powerdot} into your \LaTeX\
-distribution and for the license of this class.\newline
-This documentation prepared by Herbert Vo\ss}}
-\author{Hendri Adriaens\and Christopher Ellison}
-\date{\fileversion\ (\filedate)}
-\maketitle
-
-\begin{abstract}\noindent
-\pf{powerdot} is a presentation class for \LaTeX\ that allows for
-the quick and easy development of professional presentations. It
-comes with many tools that enhance presentations and aid the
-presenter. Examples are automatic overlays, personal notes and a
-handout mode. To view a presentation, DVI, PS or PDF output can be
-used. A powerful template system is available to easily develop new
-styles. A \LyX\ layout file is provided.
-\end{abstract}
-
-\begin{multicols}{2}
-[\section*{Contents}
-\setlength{\columnseprule}{.4pt}
-\setlength{\columnsep}{18pt}]
-\tableofcontents
-\end{multicols}
-
-\newpage
-\section{Introduction}\label{sec:intro}
-This class gives you the possibility to easily create professionally
-looking slides. The class is designed to make the development of
-presentations as simple as possible so that you can concentrate on
-the actual content instead of keeping yourself busy with technical
-details. Of course, some knowledge of \LaTeX\ is still required
-though.
-
-This class builds on and extends the \pf{prosper} class
-\cite{prosper} and the \pf{HA-prosper} package \cite{HA-prosper}.
-The \pf{HA-prosper} package was initially intended to extend
-\pf{prosper} and correct some bugs and problems of that class. As
-developments on that package progressed, it was found that
-unfortunately, not all of the problems could be overcome with the
-package. That discovery was the start of a new project set up to
-make a new class to replace the \pf{prosper} plus \pf{HA-prosper}
-combination. You're currently reading the result of that project.
-
-The remainder of this section will be devoted to giving a feel of
-what the \pf{powerdot} presentation source looks like and giving an
-overview of this documentation.
-
-The document structure of a presentation is always the same. You can
-find it in the example below.
-
-\begin{example}
- \documentclass[<class options>]{powerdot}
- \pdsetup{<presentation options>}
- \begin{document}
- \begin{slide}{a slide}
- Contents of the slide.
- \end{slide}
- \section{first section}
- \begin{slide}[<slide options>]{another slide}
- Contents of the slide.
- \end{slide}
- \begin{note}{personal note}
- The note.
- \end{note}
- \end{document}
-\end{example}
-
-There are several elements that define the document structure. First
-of all, the class accepts some class options that control the output
-of the class, for instance, paper type and style. These class
-options will be discussed in section~\ref{sec:classopts}. Then there
-are presentation specific options which control some of the elements
-of the presentation globally, for instance, the footers. These will
-be discussed in section~\ref{sec:pdsetup}.
-
-Once the setup has been decided on, you can use the slide
-environment to produce slides (see section~\ref{sec:slides}) and the
-note environment to produce notes that go with the slides (see
-section~\ref{sec:notes}). You can use overlays to display material
-in steps. This is described in section~\ref{sec:overlays}. The
-|\section| command provides a way to structure your presentation.
-This is discussed in section~\ref{sec:structure}.
-Section~\ref{sec:styles} will show an overview of the styles that
-come with this class and the characteristics of each style.
-Section~\ref{sec:compiling} will tell you more about how to produce
-output. This section contains important information on required
-packages.
-
-Section~\ref{sec:writestyle} is mostly interesting for people that
-want to develop their own style for this class or want to modify an
-existing style. Section~\ref{sec:lyx} explains how \LyX\
-\cite{LyXWeb} can be used to create \pf{powerdot} presentations.
-This documentation concludes with a section devoted to questions
-(section~\ref{sec:questions}), like `Where can I find examples?'. It
-also tells you where to turn to in case your questions are still not
-solved.
-
-\section{Setting up the presentation}\label{sec:setup}
-This section will describe all options that are available to control
-the output of the presentation and the looks of it.
-
-\subsection{Document class options}\label{sec:classopts} We will
-start with the class options that are typed in the |\documentclass|
-command as a comma-separated list. For each option, the preset
-value\footnote{The value that will be used when you don't use the
-option.} will be mentioned in the description. This is the value
-that will be used if you decide to not give a value to the option or
-not use the option at all.
-
-\DescribeOption{mode}
-This options controls the kind of output that we want to produce.
-The preset value is |present|.
-\begin{description}
-\item\option{mode=present}\\
-This mode is used when you want to create the actual presentation. It
-will enable overlays and transition effects. You can read more about
-overlays in section~\ref{sec:overlays}.
-\item\option{mode=print}\\
-This mode can be used when printing the slides including their visual
-markup, but without any overlay or transition effects.
-\item\option{mode=handout}\\
-This mode will produce a black and white overview of your slides that
-can be used to make personal notes on, for distribution to students,
-a personal guide during your talk, etcetera.
-\begin{description}
-\item\DescribeOption{nohandoutpagebreaks}\option{nohandoutpagebreaks}\\
-By default, the handout mode produces a document with two slides per
-page. If you want to fit more slides on a page, specify this option
-in the |\documentclass| command and \pf{powerdot} will let \LaTeX\
-decide on the places to insert a page break, namely when a page is
-full.
-\item\DescribeOption{nohandoutframes}\option{nohandoutframes}\\
-In handout mode, each slide is contained in a frame by default. This option turns the frames off.
-\end{description}
-\end{description}
-
-\DescribeOption{paper} This option has three possible values. The
-preset value is |screen|.
-\begin{description}
-\item\option{paper=screen}\\
-This is a special format with screen optimized ratio (4/3). The
-actual page dimensions will be 8.25 inch by 11 inch. This paper format
-is not available for print or handout mode. In these modes, \pf{powerdot}
-will switch to a4 paper and put a warning that it did this in the
-log file of your presentation.
-\item\option{paper=a4paper}\\
-A4 paper will be used for the presentation or handout.
-\item\option{paper=letterpaper}\\
-Letter size paper will be used.
-\item\option{paper=smartboard}\\
-smartboard size will be used (\verb|papersize={900pt,1440pt}|).
-\end{description}
-Some important information with respect to paper size, compiling and
-viewing presentations is available in section~\ref{sec:compiling}.
-
-\DescribeOption{orient} This controls the orientation of the
-presentation. The preset value is |landscape|.
-\begin{description}
-\item\option{orient=landscape}\\
-The presentation will be in landscape format. This value is not
-available in handout mode. In that mode, \pf{powerdot} will switch
-to portrait orientation and will warn you about this in the log
-file.
-\item\option{orient=portrait}\\ This produces slides in portrait
-format. Notice that not all styles support portrait orientation. Please
-refer to section~\ref{sec:styles} for information about which styles
-do support the portrait orientation.
-\end{description}
-
-\DescribeOption{display} This controls the production of slides and
-notes. The preset value is |slides|.
-\begin{description}
-\item\option{display=slides}\\
-This will only typeset the slides in your presentation.
-\item\option{display=slidesnotes}\\
-This will typeset both the slides and the notes in your
-presentation. See also section~\ref{sec:notes} for more information
-about notes.
-\item\option{display=notes}\\
-This will typeset the notes only.
-\end{description}
-
-Here are some more options to control the output.
-\begin{description}
-\item\DescribeOption{size}\option{size}\\
-This is the size of the normal text font in points. Possible values
-are 8pt, 9pt, 10pt, 11pt, 12pt, 14pt, 17pt and 20pt and the preset
-value is 11pt.\footnote{Note that sizes other than 10pt, 11pt and
-12pt are non-standard and it is assumed that you have the
-\pf{extsizes} bundle \cite{extsizes} installed, which provides these
-sizes.}
-\item\DescribeOption{style}\option{style}\\
-This controls the style to be loaded for the presentation. By
-default, the \pf{default} style will be loaded. For more styles, see
-section~\ref{sec:styles}.
-\item\DescribeOption{fleqn}\option{fleqn}\\
-This option makes equations flushed left. It does the same as the
-equally named option for the article class.
-\item\DescribeOption{leqno}\option{leqno}\\
-Put equation numbers at the left. Also the same as in the article
-class.
-\item\DescribeOption{nopsheader}\option{nopsheader}\\
-By default, \pf{powerdot} will write a postscript command to the ps
-file to make sure that post processors like ps2pdf know which paper
-to use without the need to specify it on the command line. See also
-section~\ref{sec:compiling}. If you experience problems with post
-processing or printing or you want to specify the paper size in the
-post processing steps yourself, use this option.
-\item\DescribeOption{hlentries}\option{hlentries}\\
-This highlights table of contents entries when the entry matches
-with the current slide and its preset value is |true|. See also
-section~\ref{sec:structure}. If you don't want highlighting of table
-of contents entries (for instance in print mode), use
-|hlentries=false|.
-\item\DescribeOption{hlsections}\option{hlsections}\\
-This highlights table of contents sections when the section matches
-with the current section in the presentation and is preset to |false|.
-See also section~\ref{sec:structure}. Specifying this
-option turns highlighting of sections on. This could be useful when
-you are using a style that implements a split table of contents.
-\item\DescribeOption{pauseslide}\option{pauseslide}\\
-This option inserts an empty slide (black by default) in the presentation on page 1 and
-will automatically advance to page 2 when opening the presentation
-in a PDF viewer like Acrobat (Reader). The option also inserts a
-link behind every slide or section title that brings you to the
-pause slide when clicked. When you click anywhere in the pause
-slide, you will go back to the originating slide. This option can be
-used to temporarily pause a presentation, for instance, to do a
-proof on the black board. You can use a different color than black
-by specifying it after the option, for instance, |pauseslide=white|.
-\item\DescribeOptions{clock}\option{clock}\\
-This displays a small digital clock on slides which you can use to
-check the time left for your presentation.
-\end{description}
-
-Here is an example of a |\documentclass| command.
-\begin{example}
- \documentclass[
- size=12pt,
- paper=screen,
- mode=present,
- display=slidesnotes,
- style=tycja,
- nohandoutpagebreaks,
- pauseslide,
- fleqn
- ]{powerdot}
-\end{example}
-This example sets up a presentation in \pf{tycja} style, with a black
-slide, normal size 12 points and flushed left equations.
-\begin{example}
- \documentclass[
- size=12pt,
- paper=letterpaper,
- mode=handout,
- display=slidesnotes,
- style=tycja,
- nohandoutpagebreaks,
- pauseslide,
- fleqn
- ]{powerdot}
-\end{example}
-Changing the |paper| and |mode| options, now produces a handout with
-possibly more than two slides per page due to the |nohandoutpagebreaks|
-option.
-
-\subsection{Setup options}\label{sec:pdsetup}
-\DescribeMacro{\pdsetup}
-There are several extra options that can help customizing your
-presentation. These options are not available via the
-|\documentclass| command. This has a technical reason.\footnote{The
-interested reader is referred to the section about the \pf{xkvltxp}
-package in the \pf{xkeyval} package documentation \cite{xkeyval}.}
-We distinguish two types of options. Options that can only be set
-globally (acting for the entire presentation) using the |\pdsetup|
-command and options that can be accessed both globally (via
-|\pdsetup|) and locally (via slide environments, see section~\ref{sec:slides}).
-
-\subsubsection{Global options}\label{sec:gopts}
-This section describes options that can only be used globally in the
-preamble of your presentation via the |\pdsetup| command.
-\begin{description}
-\item\DescribeOption{palette}\option{palette}\\
-This specifies the palette to be used. A palette is a set of colors
-defined by a style. To find out which palettes are defined by each
-style, see section~\ref{sec:styles}.
-\item\DescribeOption{theslide}\option{theslide}\\
-This option controls how the slide number appears on the slide. This
-is preset to the value |\arabic{slide}~/~\pageref*{lastslide}|,
-which could appear like |5/22|. Notice that the |\arabic{slide}|
-typesets the number of the current slide and that
-|\pageref*{lastslide}| typesets the number of the last
-slide.\footnote{We use the starred version of \cs{pageref} which is
-defined by \pf{hyperref} and does not create a link to the page that
-it is referring to.}
-\item\DescribeOption{thenote}\option{thenote}\\
-This is similar to the |theslide| option, but typesets the slide
-numbers of notes. The preset value is
-|note~\arabic{note}~of~slide~\arabic{slide}| and |\arabic{note}|
-here typesets the number of the current note that goes with the
-current slide. This could appear like |note 2 of slide 7|.
-\item\DescribeOption{counters}\option{counters}\\
-The |counters| option lists counters that you might want to protect
-on overlays. As material on overlays (see
-section~\ref{sec:overlays}) is processed multiple times, also
-\LaTeX\ counters, like the |equation| counter, might be increased
-too often. To avoid that your equations get different numbers on
-every overlay, use this option. The |equation|, |table|, |figure|,
-|footnote| and |mpfootnote| counters are already protected for you.
-If you use extra counters, for instance for theorems, list them in
-this option. Example:
-\begin{example}
- counters={theorem,lemma}
-\end{example}
-\item\DescribeOption{list}\option{list}\\
-This option takes a list of options that will be passed on to the
-\pf{enumitem} package that controls the layout of lists created by
-the |enumerate| and |itemize| environments. Example:
-\begin{example}
- list={labelsep=1em,leftmargin=*,itemsep=0pt,topsep=5pt,parsep=0pt}
-\end{example}
-See for more information on controlling the layout of lists the
-\pf{enumitem} package \cite{enumitem}.
-\item\DescribeOptions{enumerate,itemize}\option{enumerate,itemize}\\
-As the |list| option, but only control |enumerate| and |itemize|
-environments respectively.
-\item\DescribeOption{clockformat}\option{clockformat}\\
-This option specifies the format of the clock. The format is set using
-Acrobat's |util.printd| function.\footnote{For a complete listing of
-allowable formats, consult the \textit{Acrobat JavaScript Scripting
-Reference}\cite{javascript}.} The default value is |HH:MM:ss|, which
-shows a 00-23 hour, 00-59 minute, 00-59 second clock. Example:
-\begin{example}
-clockformat=h:MM tt
-\end{example}
-The above setting will display a 1-12 hour, 00-59 minute, am/pm clock.
-That is, the clock might show |5:53 pm|.
-\item\DescribeOption{clockrefresh}\option{clockrefresh}\\
-This option should be a number which specifies how often
-the clock is refreshed in milliseconds. The default behavior is to refresh
-the clock every second. Thus, the default value is 1000. Notice, if the
-|clockformat| is such that seconds are not shown, then it makes no sense
-to update that clock every second. A corresponding example:
-\begin{example}
-clockrefresh=60000
-\end{example}
-The interpretation of this is that the clock will be updated every minute.
-\end{description}
-
-\subsubsection{Global and local options}\label{sec:glopts}
-This section describes options that can be used both globally via
-|\pdsetup| and locally via slide environments (see section~\ref{sec:slides}).
-\begin{description}
-\item\DescribeOptions{lf,cf,rf}\option{lf,cf,rf}\\
-This determines the content of the left, center and right footers.
-These are preset to empty.
-\item\DescribeOption{trans}\option{trans}\\
-This option sets the default transition effect to be used in the
-presentation. These transition effects only work after compiling the
-presentation to PDF format. See also section~\ref{sec:compiling}.
-The following transition effects are supported: |Split|, |Blinds|,
-|Box|, |Wipe|, |Dissolve|, |Glitter| and |Replace|. When you are using
-a viewer that understands PDF 1.5, you can also use |Fly|, |Push|,
-|Cover|, |Uncover| or |Fade|. It is important to notice that most
-viewers are case sensitive, so, for instance, |box| will not work.
-
-The preset effect is |Replace| which just replaces one slide with
-another when browsing the slides. Note that some PDF viewers (like
-Acrobat Reader 5 and higher) only produce the transition effect in
-full screen mode. If you want to use a custom transition effect that
-is not listed in the list above (for instance, a wipe effect with a
-custom wipe direction), then that is possible. However,
-\pf{powerdot} will put a warning in your log file that the effect
-that you have chosen, might not work in the PDF viewer. Here is an
-example that does work.
-\begin{example}
- trans=Wipe /Di 0
-\end{example}
-In Acrobat (Reader), this wipes from left to right instead of the
-default top to bottom. For more information, see a PDF Reference
-Manual.
-\item\DescribeOption{method}\option{method}\\
-This option can be used when a slide contains special material that
-does not get treated in the `usual' way by \LaTeX. Verbatim material
-is an example of this. Possible values are |normal| (the preset value),
-|direct| and |file|. We will come back to this option in detail in
-section~\ref{sec:verbatim}.
-\item\DescribeOptions{logohook,logopos,logocmd}\option{logohook,logopos,logocmd}\\
-If |logopos| is specified, a logo defined by the value of the
-|logocmd| option will be put on slides. The position can be
-specified relative to the width and height of the slide. |{0,0}| is
-the lower left corner of the paper and |{\slidewidth,\slideheight}|
-is the upper right corner. For positioning the logo, the |\rput|
-command of \pf{pstricks} \cite{PSTricksWeb,PSTricks} is used. This
-command also allows to specify the point of the logo that should be
-positioned there. This point can be entered via the |logohook|
-option and can take the values |tl|, |t|, |tr|, |r|, |Br|, |br|,
-|b|, |bl|, |Bl|, |l|, |B| and |c|. For more information about
-|\rput|, consult the \pf{pstricks} documentation. Here is an example
-that integrates the flower of the \pf{default} style into the
-\pf{husky} style.
-\begin{example}
- \documentclass[style=husky]{powerdot}
- \pdsetup{
- logohook=t,
- logopos={.088\slidewidth,.99\slideheight},
- logocmd={\includegraphics[height=.08\slideheight]{powerdot-default.ps}}
- }
- \begin{document}
- ...
- \end{document}
-\end{example}
-The preset value for |logohook| is |tl|.
-\end{description}
-
-A special feature of \pf{powerdot}, which can be used to make
-presentations come alive, is the use of random dots. These dots will
-be placed anywhere on your slides and use the colors defined by the
-palette that you use. Overlays will carry the same dots. This
-feature uses |random.tex| \cite{random}. Several options are
-available to control the appearance of the random dots.
-\begin{description}
-\item\DescribeOption{randomdots}\option{randomdots}\\
-By default, random dots are turned off. If this option is set to
-|true|, random dots will be generated. |false| will turn off the
-feature. When no value is submitted to the option, |true| will be
-used.
-\item\DescribeOptions{dmindots,dmaxdots}\option{dmindots,dmaxdots}\\
-The number of dots per slide is also random. These options set the
-minimum and maximum dots per slide. Preset values are |5| and |40|,
-respectively.
-\item\DescribeOptions{dminsize,dmaxsize}\option{dminsize,dmaxsize}\\
-The minimum and maximum radius of the dots. Preset values are |5pt|
-and |40pt|, respectively.
-\item\DescribeOptions{dminwidth,dmaxwidth,dminheight,dmaxheight}
-\option{dminwidth,dmaxwidth,dminheight,dmaxheight}\\
-These options determine the area on the slide that can be used for
-the random dots. These values are preset such that dots go anywhere
-on the slide, but you might want to adjust these such that, for
-instance, dots can only appear in the text area. The preset values
-are |0pt|, |\slidewidth|, |0pt|, |\slideheight|.
-
-Here is an example that allows dots in a smaller rectangle on the
-slide.
-\begin{example}
- \pdsetup{
- dminwidth=.1\slidewidth,dmaxwidth=.9\slidewidth,
- dminheight=.2\slideheight,dmaxheight=.8\slideheight
- }
-\end{example}
-\item\DescribeOption{dbright}\option{dbright}\\
-This option can be used to adjust the brightness of the dots. The
-number should be an integer between -100 and 100. If the number is
-negative, the color will be adjusted towards black, with -100 giving
-black. If the number is positive, the color will be adjusted towards
-white, with 100 giving white. With a light background, you may want
-to choose |bright| to be positive. With a dark background, you may
-want to set it negative. The preset value is |60|, meaning a mixture
-of 40\% of the original color and 60\% white.
-\item\DescribeOption{dprop}\option{dprop}\\
-This option is used for passing extra parameters to the |\psdot|
-command, which creates the random dots. You could, for instance,
-change the style of the dots or the line width. See for more
-information about |\psdot| the \pf{pstricks} documentation
-\cite{PSTricksWeb,PSTricks}. \pf{powerdot} defines two extra dot
-styles that can be used for the random dots. These styles are
-|ocircle| (open circle) and |osquare| (open square).
-\end{description}
-
-Here are two examples for the use of random dots.
-\begin{example}
- \pdsetup{
- randomdots,dminwidth=.2\slidewidth
- }
-\end{example}
-This turns on random dots and doesn't use the left 20\% of the slide
-for placing random dots.
-\begin{example}
- \pdsetup{
- randomdots,dprop={dotstyle=ocircle,linewidth=.5pt},
- dminsize=500pt,dmaxsize=600pt,dmindots=2,dmaxdots=5
- }
-\end{example}
-This example puts at most 5 big circles on slides. These circles do
-not fit on the slides and you will only see parts of them in the
-shape of curves.
-
-\subsubsection{\cs{pdsetup} example}
-Here is an example of a |\pdsetup| command that one could use to set up
-the presentation.
-\begin{example}
- \pdsetup{
- lf=My first presentation,
- rf=For some conference,
- trans=Wipe,
- theslide=\arabic{slide},
- randomdots,dmaxdots=80
- }
-\end{example}
-This sets the left and right footers and will initialize the
-transition effect to |Wipe|. Further, slide numbers will not include
-the number of the last slide, but only the number of the current
-slide. Finally, slides will be covered with at most 80 random dots.
-
-A small note is necessary with respect to the appearance of footers.
-The slide number (controlled by the |theslide| option) will be added
-to a footer. Most styles add it too the right footer. If both the
-footer and the slide number are non empty, |~--~| will be inserted
-in between them to separate them. Styles might modify this default
-behavior however.
-
-\section{Making slides}\label{sec:slides}
-\subsection{The title slide}\label{sec:titleslide}
-\DescribeMacro{\title}
-\DescribeMacro{\author}
-\DescribeMacro{\and}
-\DescribeMacro{\date}
-\DescribeMacro{\maketitle}
-The title slide is created by the |\maketitle| command.
-\begin{command}
- `\cs{maketitle}\oarg{options}'
-\end{command}
-Its use is the same as in the standard \LaTeX\ document classes. The
-optional argument \meta{options} can contain any option from
-section~\ref{sec:glopts}. Specifying such an option in the
-|\maketitle| command will only have an effect on the title slide and
-not on other slides. See an example below.
-\begin{example}
- \documentclass{powerdot}
- \title{Title}
- \author{You \and me}
- \date{October 7, 2010}
- \begin{document}
- \maketitle
- ...
- \end{document}
-\end{example}
-The |author|, |title| and |date| declarations provide the text to be
-used when making a title page. The design of the title page is
-specific to the style in use. Notice the use of |\and| for
-separating multiple authors. See a \LaTeX\ manual \cite{companion}
-for more information on commands such as |\title| and |\author|.
-
-\subsection{Other slides}\label{sec:otherslides}
-\DescribeEnv{slide} The centerpiece of every presentation is the
-slide. In \pf{powerdot}, the content of each slide is placed in a
-|slide| environment.
-\begin{command}
- `\cs{begin}\texttt{\{slide\}}\oarg{options}\marg{slide title}'
- `\meta{body}'
- `\cs{end}\texttt{\{slide\}}'
-\end{command}
-
-In section~\ref{sec:overlays} we'll see how to give some life to the
-slides, but for now, let's look at a simple example.
-\begin{example}
- \begin{slide}{First slide}
- Hello World.
- \end{slide}
-\end{example}
-The slide environment has one required argument, namely the slide
-title. When a slide is created, the slide title is used to create an
-entry in the table of contents and in the list of bookmarks. The
-table of contents is a listing of the slides and section titles in
-the presentation that appears on each slide.
-
-The table of contents is clickable (when the presentation is
-compiled into PDF) and serves as a nice way to jump from location to
-location within the presentation. The bookmark list is only present
-when compilation is taken all the way to the PDF file format. It
-also serves as a table of contents, but this list does not appear on
-\textit{any} of the slides, but in a separate window in a PDF
-viewer. In the example above, the entries in both table contents and
-the list of bookmarks would be titled |First slide|.
-
-The \meta{options} for the |slide| environment can contain any
-option listed in section~\ref{sec:glopts}. Additionally, the
-following options can be used.
-\begin{description}
-\item\DescribeOption{toc}\option{toc}\\
-When specified, the value is used for the entry in the table of
-contents; otherwise, the slide title is used. If |toc=| is
-specified, then no entry is created.
-\item\DescribeOption{bm}\option{bm}\\
-When specified, the value is used for the bookmark entry; otherwise,
-the slide title is used. If |bm=| is specified, then no entry is
-created.
-\end{description}
-
-These optional arguments are especially useful when the title of a
-slide is extremely long or when the title contains \LaTeX\ commands
-that do not render correctly in the bookmarks.\footnote{The
-bookmarking procedure uses \cs{pdfstringdef} from the \pf{hyperref}
-package, and it can process accented characters such as \cs{"i}.}
-When specifying entries, be sure to hide special characters `|,|'
-and `|=|' between curly brackets `|{|' and `|}|'. Let's look at an
-example that uses these optional arguments.
-\begin{example}
- \begin{slide}[toc=,bm={LaTeX, i*i=-1}]{\color{red}\LaTeX, $i^2=-1$}
- My slide contents.
- \end{slide}
-\end{example}
-
-In this example, the slide title will appear as {\color{red}\LaTeX,
-$i^2=-1$}. This text will not render correctly in a bookmark entry.
-An attempt is made to correct this, but often, the correction does
-not produce an equivalent text. This particular title would be
-rendered in the bookmark list as |redLaTeX, i2=-1|. On the other
-hand, the manually specified bookmark entry is rendered as:
-|LaTeX, i*i=-1|. Notice, no entry is created in the table of contents,
-because of the use of |toc=|.
-
-In addition to the |slide| environment, each individual style can
-define its own environments. Many styles have a |wideslide|
-environment. The idea is that one might have information that does
-not fit nicely on a slide with a table of contents listed, as this
-consumes some space. In such cases, it is preferable to use a slide
-that does not list the table of contents. The |wideslide|
-environment provides this functionality and has more space for the
-actual slide content. See section~\ref{sec:styles} for information
-on the various environments provided by the styles.
-
-\section{Overlays}\label{sec:overlays}
-It is often the case that you don't want all the information on the
-slide to appear at once. Rather, the information should appear one
-item at a time. In \pf{powerdot}, this is achieved with overlays.
-Each slide can be comprised of many overlays, and the overlays are
-displayed one at a time.
-
-\subsection{The \cs{pause} command}\label{sec:pause}
-\DescribeMacro{\pause} The easiest way to display information
-sequentially is to use the |\pause| command.
-\begin{command}
- `\cs{pause}\oarg{number}'
-\end{command}
-Below is a simple example:
-\begin{example}
- \begin{slide}{Simple overlay}
- power\pause dot
- \end{slide}
-\end{example}
-The slide's information is displayed and continues until the
-|\pause| command is encountered. No further output within the same
-slide is displayed until the click of the mouse or the touch of the
-keyboard. Then, the content will continue to display until all the
-information is displayed or until another |\pause| command is
-encountered. In this example, |power| is displayed on the first
-overlay, and |powerdot| is the displayed on the second overlay. The
-|\pause| command is often used within the |itemize| and |enumerate|
-environments. For example,
-\begin{example}
- \begin{slide}{Multiple pauses}
- power\pause dot \pause
- \begin{itemize}
- \item Let me pause\ldots \pause
- \item \ldots while I talk \pause and chew bubble gum. \pause
- \item Perhaps you'll be persuaded.
- \item Perhaps not.
- \end{itemize}
- \end{slide}
-\end{example}
-Since |\pause| was used before the |itemize| environment, no item
-will appear until the third overlay. Then, each item will be
-displayed one at a time, each on their own overlay. More information
-on using lists will follow in the next section.
-
-The optional argument of the |\pause| command specifies the number
-of overlays to pause. An example usage is:
-\begin{example}
- \begin{slide}{Pause longer}
- \begin{itemize}
- \item A \pause
- \item B \pause[2]
- \item C
- \end{itemize}
- \end{slide}
-\end{example}
-In the example above, item |C| will appear on the fourth overlay.
-The usefulness of this option will become more apparent in the next
-section; so we will revisit a similar example at that time.
-
-\subsection{List environments}\label{sec:lists}
-The list environments, |itemize| and |enumerate|, have special
-treatments in \pf{powerdot}. They have an optional argument that
-will be taken care off by the \pf{enumitem} package (see
-\cite{enumitem}). \pf{powerdot} supplies an extra key for this
-optional argument. In the examples that follow, features will be
-described using the |itemize| environment but they also apply to the
-|enumerate| environment.
-
-Here is the typical usage of the |itemize| environment:
-\begin{example}
- \begin{slide}{Basic itemize}
- \begin{itemize}
- \item A \pause
- \item B \pause
- \item C
- \end{itemize}
- \end{slide}
-\end{example}
-The display is simple, each item appears one at a time with each
-overlay.
-
-\DescribeOption{type}
-Suppose we wanted every item to show, but we only wanted one item to
-appear `active' at once. This can be accomplished via the |type|
-option for the |itemize| environment. The preset value is |0|.
-\begin{example}
- \begin{slide}{Type 1 itemize}
- \begin{itemize}[type=1]
- \item A \pause
- \item B \pause
- \item C
- \end{itemize}
- \end{slide}
-\end{example}
-Now, every item will be displayed in the \emph{inactive
-color}\index{inactive color|usage} (which is defined by the style
-that you use), and the item's font color will become the active one
-on the overlay that it would normally appear on. The default
-behavior is given by |type=0|. It is still possible to pass
-optional arguments to \pf{enumitem} via the second optional argument:
-
-\begin{example}
- \begin{slide}{Type 1 itemize}
- \begin{enumerate}[type=1][label=\romani*)]
- \item A \pause
- \item B \pause
- \item C
- \end{enumerate}
- \end{slide}
-\end{example}
-Take care, that this must always be the second optional argument!
-It is possible to leave the first one empty, which is valid only for \pf{powerdot}.
-
-
-Lists can also be nested to create complicated structures. When a
-list is nested, it inherits the setting of the |type| option from
-the `parent' list, but that can be overruled by specifying the
-|type| option in the optional argument of the nested list. We
-present here one example, but many more can be created by nesting
-lists of different types in different ways.
-\begin{example}
- \begin{slide}{Nested lists}
- \begin{itemize}
- \item A\pause
- \begin{itemize}[type=1]
- \item B\pause
- \end{itemize}
- \item C
- \end{itemize}
- \end{slide}
-\end{example}
-This displays |A| and |B| on the first overlay, but |B| is inactive.
-On overlay 2, |B| will become active and on overlay 3, |C| will
-become visible.
-
-\subsection{The \cs{item} command}
-\DescribeMacro{\item}
-The |\item| command has an extra \emph{optional} argument in
-\pf{powerdot} which allows for creating overlays in a more flexible
-way then |\pause| provides.
-\begin{command}
- `\cs{item}\oarg{label}\larg{overlays}'
-\end{command}
-This optional argument should contain an overlay specification
-stating on which overlays you want the item to appear. This
-specification is a comma separated list where each item can used the
-notation as in table \ref{tab:item}.
-\begin{table}[htb]\centering
-\begin{tabular}{d}
-Syntax&Meaning\\\hline
-\texttt{x}&Only overlay \texttt{x}\\
-\texttt{-x}&All overlays up to and including \texttt{x}\\
-\texttt{x-}&All overlays from \texttt{x}, including \texttt{x}\\
-\texttt{x-y}&All overlays from \texttt{x} to \texttt{y},
-including \texttt{x} and \texttt{y}\\
-\end{tabular}
-\caption{\cs{item} and \cs{onslide} notation}\label{tab:item}
-\end{table}
-The \meta{label} argument is the standard optional argument for
-|\item| in \LaTeX. A \LaTeX\ manual \cite{companion} can tell you
-more about this argument.
-
-Here is an example.
-\begin{example}
- \begin{slide}{Active itemize}
- \begin{itemize}[type=1]
- \item<1> A
- \item<2> B
- \item<3> C
- \end{itemize}
- \end{slide}
-\end{example}
-Here we have said that |A| should only be active on overlay 1, |B|
-should only be active on overlay 2, and |C| should only be active on
-overlay 3. Again, when the item is not active, it appears in the
-inactive color because of |type=1|.
-
-If |type=0| is specified and if each item is given an overlay
-option, then each item will appear only when it is active. When the
-item is not active, then it will not show on the slide at all. More
-examples demonstrating the syntax for \meta{overlays} will be
-discussed in the next section.
-
-\subsection{The \cs{onslide} command}\label{sec:onslide}
-\DescribeMacro{\onslide} Overlays can also be achieved using the
-|\onslide| command.
-\begin{command}
- `\cs{onslide}\marg{overlays}\marg{text}'
-\end{command}
-This command takes an \meta{overlays} specification as first
-argument and the \meta{text} to apply it to as second argument. The
-\meta{overlays} on which the text will appear are specified as a
-comma separated list with syntax as in table \ref{tab:item}. We
-start off with a simple example.
-\begin{example}
- \begin{slide}{Simple onslide}
- \onslide{1,2}{power}\onslide{2}{dot}
- \end{slide}
-\end{example}
-We have instructed |power| to appear on overlays one and two, and
-|dot| to appear only on overlay two. As you might guess, this
-example has the same output as our first |\pause| example. Yet, it
-is clearly the case that our syntax is more complicated. However,
-this slight ``complication'' also allows for much more flexibility.
-
-\DescribeMacro{\onslide+}Consider the above example with the
-following modifications:
-\begin{example}
- \begin{slide}{Simple onslide+}
- \texttt{onslide }: \onslide{1}{power}\onslide{2}{dot}\\
- \texttt{onslide+}: \onslide+{1}{power}\onslide+{2}{dot}
- \end{slide}
-\end{example}
-The |\onslide+| command displays its content in a different manner
-altogether. Now, |dot| appears on every overlay, but it is in
-inactive color\index{inactive color|usage} and matches the normal
-font color \textit{only} on overlay two. This is comparable to the
-|type=1| behavior for lists (see section~\ref{sec:lists}).
-
-When executing this example, we will also notice that the |\onslide|
-command does hide material, but still reserves the right amount of
-space for it: on overlay 2, the |dot|s appear right above each
-other. The next command does not reserve space.
-
-\DescribeMacro{\onslide*} Instead of hiding and reserving space
-(|\onslide|) or putting \meta{text} in the inactive color
-(|\onslide+|) when the overlay doesn't match \meta{overlays}, this
-command just eats the material altogether. To understand the
-differences, consider the following example:
-\begin{example}
- \begin{slide}{Simple onslide*}
- \texttt{onslide }: \onslide{1}{power}\onslide{2}{dot}\\
- \texttt{onslide+}: \onslide+{1}{power}\onslide+{2}{dot}\\
- \texttt{onslide*}: \onslide*{1}{power}\onslide*{2}{dot}
- \end{slide}
-\end{example}
-The output of the first two lines, we are already familiar with. The
-third line displays |power| on overlay 1 and |dot| on overlay 2, but
-no space for |power| is reserved on overlay 2. Hence |dot| will
-start on the cursor position that |power| started on overlay 1 and
-it is not aligned below the other two |dots|.
-
-We finish with an example of the syntax that is possible with
-|\item| and |\onslide|. Remember that these commands take a comma
-separated list for the \meta{overlays} specification and that each
-element can used the syntax as explained in table \ref{tab:item}.
-The various variations are demonstrated in the example below.
-\begin{example}
- \begin{slide}{Lists}
- \onslide{10}{on overlay 10 only}\par
- \onslide{-5}{on every overlay before and including overlay 5}\par
- \onslide{5-}{on every overlay after and including overlay 5}\par
- \onslide{2-5}{on overlays 2 through 5, inclusive}\par
- \onslide{-3,5-7,9-}{on every overlay except overlays 4 and 8}
- \end{slide}
-\end{example}
-
-\subsection{Relative overlays}
-Sometimes it is a pain to keep track of when an item should appear
-or become active. You might, for example, just care that some text
-appears on the overlay \textit{after} some other item. This
-functionality is provided through the use of relative overlays which
-should not be used outside list environments that use |\item|. Let's
-consider a simple, illuminating example.
-\begin{example}
- \begin{slide}{Relative overlays}
- \begin{itemize}
- \item A \pause
- \item B \onslide{+1}{(visible 1 overlay after B)}\pause
- \item C \onslide{+2-}{(appears 2 overlays after C, visible until the end)}
- \pause
- \item D \onslide{+1-6}{(appears 1 overlay after D, visible until overlay 6)}
- \pause
- \item E \pause
- \item F \pause
- \item G \onslide{+1-+3}{(appears 1 overlay after G for 3 overlays)}\pause
- \item H \pause
- \item I \pause
- \item J \pause
- \item K
- \End{itemize}
- \end{slide}
-\end{example}
-As you can see, we still use |\onslide|. The only change is with the
-syntax of the list of overlays. Now, we can specify a `|+|' symbol
-in the list. In its simplest usage, |\onslide{+1}| will make text
-display one overlay after the overlay it would \textit{normally}
-appear on. You can still use the syntax in table \ref{tab:item}.
-These are demonstrated in the above example. Notice,
-|\onslide{+1-6}| means that the text will appear one overlay after
-the overlay it would normally appear on and that the text should
-remain shown until overlay seven. To make text appear for a range of
-relative overlays, see the final demonstration in the above example.
-
-\section{Presentation structure}\label{sec:structure}
-\subsection{Making sections}\label{sec:section}
-\DescribeMacro{\section}
-This section describes the |\section| command which provides a way
-to structure a presentation.
-\begin{command}
- `\cs{section}\oarg{options}\marg{section title}'
-\end{command}
-This command will produce a slide with \meta{section title} on it
-and will also use this text to create sections in the table of
-contents and in the bookmarks list. There are several \meta{options}
-to control its output.
-
-\DescribeOption{tocsection} This option controls the creation of a
-section in the table of contents. The preset value is |true|.
-\begin{description}
-\item\option{tocsection=true}\\
-This does create a section in the table of contents. This means that
-all following slides, until the next section, will be nested under
-this section.
-\item\option{tocsection=false}\\
-This does not create a section in the table of contents and hence
-the section will be listed as an ordinary slide.
-\item\option{tocsection=hidden}\\
-This does create a section in the table of contents, but this is
-only visible when you view a slide that is part of this section.
-This could be used to append a section to the presentation which you
-can discuss if there is some extra time.
-\end{description}
-
-\DescribeOption{slide} This option controls whether the |\section|
-command creates a slide. The preset value is |true|.
-\begin{description}
-\item\option{slide=true}\\
-A slide is created.
-\item\option{slide=false}\\
-No slide will be created. If also |tocsection| is |false|, the
-|\section| command doesn't do anything. If it does create a table of
-contents section (|tocsection=| |true| or |hidden|), its link will
-point to the first slide in the section as the section itself
-doesn't have a slide.
-\end{description}
-
-\DescribeOption{template} This option can be used to make the
-section slide with another template. By default, a normal |slide|
-environment is used to create the section slide, but if a style
-offers other templates that could be used for this purpose (for
-instance, the |wideslide| environment), then you can use this option
-to select that template. See section~\ref{sec:styles} for an
-overview of the available templates with every style.
-
-Finally, all options available to normal slides are available to
-slides created by |\section| as well (see section~\ref{sec:slides}).
-However, when the section does make a |tocsection|, |toc=| or |bm=|
-won't remove the table of contents entry or the bookmark
-respectively.
-
-\subsection{Making an overview}\label{sec:tableofcontents}
-\DescribeMacro{\tableofcontents}
-This command creates an overview of your presentation and can only
-be used on a slide.
-\begin{command}
- `\cs{tableofcontents}\oarg{options}'
-\end{command}
-There are several \meta{options} to control the output of this
-command.
-
-\DescribeOption{type}
-This option controls whether certain material (depending on the
-input in the |content| option below) will be hidden or displayed in
-the inactive color\index{inactive color|usage}. The preset value is
-|0|. Compare with the |type| option for list environments
-(section~\ref{sec:lists}).
-
-\begin{description}
-\item\option{type=0}\\
-When material is not of the requested type as specified in the
-|content| option, it will be hidden.
-\item\option{type=1}\\
-As |type=0|, but instead of hiding material, it will be typeset in
-the inactive color.
-\end{description}
-
-\DescribeOption{content}
-The |content| option controls which elements will be included in the
-overview. The preset value is |all|. The description below assumes
-that |type=0| was chosen, but the alternative text for |type=1| can
-easily be deduced.
-
-\begin{description}
-\item\option{content=all}\\
-This will display a full overview of your presentation including all
-sections and slides, except the slides in hidden sections (see
-section~\ref{sec:section}).
-\item\option{content=sections}\\
-This displays only the sections in the presentation.
-\item\option{content=currentsection}\\
-This displays the current section only.
-\item\option{content=future}\\
-This displays all content starting from the current slide.
-\item\option{content=futuresections}\\
-This displays all sections, starting from the current section.
-\end{description}
-
-We finish this section with a small example that will demonstrate
-how you can make a presentation that contains an overall overview of
-sections in the presentation, giving a general idea of the content,
-and per section a detailed overview of the slides in that section.
-\begin{example}
- \begin{slide}[toc=,bm=]{Overview}
- \tableofcontents[content=sections]
- \end{slide}
- \section{First section}
- \begin{slide}[toc=,bm=]{Overview of the first section}
- \tableofcontents[content=currentsection,type=1]
- \end{slide}
- \begin{slide}{Some slide}
- \end{slide}
- \section{Second section}
- ...
-\end{example}
-
-\section{Miscellaneous}
-\subsection{Notes}\label{sec:notes}
-\DescribeEnv{note}
-The |note| environment can be used to make personal notes that
-accompany a slide. You can control displaying notes using the
-|display| option (see section~\ref{sec:classopts}). Here is an
-example.
-\begin{example}
- \begin{slide}{Chewing gum}
- ...
- \end{slide}
- \begin{note}{Reminder for chewing gum}
- Don't forget to mention that chewing gum is sticky.
- \end{note}
-\end{example}
-
-\subsection{Empty slides}\label{sec:emptyslides}
-\DescribeEnv{emptyslide}
-The |emptyslide| environment creates a totally empty slide. The text
-box on the slide can be used for special things like displaying
-photos. This allows for creating a dia show. Example:
-\begin{example}
- \begin{emptyslide}{}
- \centering
- \vspace{\stretch{1}}
- \includegraphics[height=0.8\slideheight]{me_chewing_gum.eps}
- \vspace{\stretch{1}}
- \end{emptyslide}
-\end{example}
-The |\includegraphics| command is defined by the \pf{graphicx}
-package \cite{graphics}. The |\stretch| command is used to
-vertically center the picture. Both commands are described in your
-favorite \LaTeX\ manual, for instance \cite{companion}. Note that
-you can use the lengths |\slideheight| and |\slidewidth| to scale
-pictures to fit nicely on the slide.
-
-\subsection{Bibliography slide}\label{sec:bib}
-\DescribeEnv{thebibliography}
-\pf{powerdot} redefines the standard \pf{article}
-|thebibliography| environment to suppress the creation of a section
-heading and running headers. All other properties are maintained.
-You can do either of the next two (depending whether you are
-using BiB\TeX\ or not):\\
-\begin{minipage}[t]{.49\linewidth}
-\begin{example}
- \begin{slide}{Slide}
- \cite{someone}
- \end{slide}
-\begin{slide}{References}
- \begin{thebibliography}{1}
- \bibitem{someone} Article of someone.
- \end{thebibliography}
- \end{slide}
-\end{example}
-\end{minipage}\hfill
-\begin{minipage}[t]{.49\linewidth}
-\begin{example}
- \begin{slide}{Slide}
- \cite{someone}
- \end{slide}
- \begin{slide}{References}
- \bibliographystyle{plain}
- \bibliography{YourBib}
- \end{slide}
-\end{example}
-\end{minipage}
-
-In case you have a big reference list that you want to spread over
-multiple slides, have a look at the packages \pf{natbib} and
-\pf{bibentry} \cite{natbib}. Using both packages allows you to do:
-\begin{example}
- \begin{slide}{References (1)}
- \bibliographystyle{plain}
- \nobibliography{YourBib}
- \bibentry{someone1}
- \bibentry{someone2}
- \end{slide}
- \begin{slide}{References (2)}
- \bibentry{someone3}
- \end{slide}
-\end{example}
-Have a look at your favorite \LaTeX\ manual for more information
-about citations and bibliographies.
-
-\subsection{Verbatim on slides}\label{sec:verbatim}\DescribeOption{verbatim}
-\pf{powerdot} has three different methods of processing slides, from
-which two have mainly been developed to make the inclusion of
-verbatim content\footnote{And other content that needs catcode
-changes when processing.} on slides easier. These methods can be
-accessed by the |method| key which is available in slide
-environments and the |\pdsetup| command (see
-section~\ref{sec:glopts}).
-\begin{description}
-\item\option{method=normal}\\
-This is the preset method for processing slides. It is fast and
-allows for overlays, but it does not allow for
-verbatim.\footnote{Except when it has been saved in a box outside
-the slide.}
-\item\option{method=direct}\\
-This method is also fast, but does not allow for overlays. Overlays
-will silently be disabled. However, it does allow for verbatim
-content on slides.
-\item\option{method=file}\\
-This method uses a temporary file to export the slide body to and
-read it back in. This method does allow for verbatim content and
-overlays, but could be slow when many slides use this method because
-the filesystem is used.
-\end{description}
-
-Below is an example demonstrating the use of all three different
-methods of slide processing.
-\begin{example}
- \documentclass{powerdot}
- \usepackage{listings}
- \lstnewenvironment{code}{
- \lstset{frame=single,escapeinside=`',
- backgroundcolor=\color{yellow!20},
- basicstyle=\footnotesize\ttfamily}
- }{}
- \begin{document}
- \begin{slide}{Slide 1}
- Normal \pause content.
- \end{slide}
- \begin{slide}[method=direct]{Slide 2}
- Steps 1 and 2:
- \begin{code}
- compute a;`\pause'
- compute b;
- \end{code}
- \end{slide}
- \begin{slide}[method=file]{Slide 3}
- Steps 1 and 2:
- \begin{code}
- compute a;`\pause'
- compute b;
- \end{code}
- \end{slide}
- \end{document}
-\end{example}
-The first slide shows the default behavior for normal content. It
-produces two overlays. The second slide does not produce overlays,
-despite the use of the |\pause| command. This command has been
-disabled by choosing the |direct| method to process the verbatim
-content. The third slide has the same body as the second slide, but
-now does create two overlays, because the method using a temporary
-file has been chosen. Notice that we used |\pause| inside the listing,
-but that it can also be used outside the listing.
-
-\subsection{The \cs{twocolumn} command}\label{sec:twocolumn}
-\DescribeMacro{\twocolumn}
-The |\twocolumn| macro allows to split content into two columns.
-\begin{command}
- `\cs{twocolumn}\oarg{options}\marg{left}\marg{right}'
-\end{command}
-This typesets \meta{left} and \meta{right} in two columns. The
-dimensions of those columns can be controlled by \meta{options}.
-Below are the available options.
-\begin{description}
-\item\DescribeOption{lineheight}\option{lineheight}\\
-If |lineheight| is specified, a line of the specified height will be
-created using |\psline| in between the two columns. Example:
-|lineheight=6cm|.
-\item\DescribeOption{lineprop}\option{lineprop}\\
-Any \pf{pstricks} declaration to specify the line properties. Example:
-\begin{example}
- lineprop={linestyle=dotted,linewidth=3pt}
-\end{example}
-\item\DescribeOptions{lfrheight,lfrprop}\option{lfrheight,lfrprop}\\
-The first creates a frame of the specified height around the left
-column. The second is as |lineprop|, but for the left frame.
-\item\DescribeOptions{rfrheight,rfrprop}\option{rfrheight,rfrprop}\\
-As |lfrheight| and |lfrprop|, but for the right frame.
-\item\DescribeOptions{lcolwidth,rcolwidth}\option{lcolwidth,rcolwidth}\\
-Width of the left and right columns. Both are preset to: |0.47\linewidth|.
-\item\DescribeOption{frsep}\option{frsep}\\
-Space between text and the frames. Preset: |1.5mm|.
-\item\DescribeOption{colsep}\option{colsep}\\
-Space between the two columns. Preset: |0.06\linewidth|.
-\item\DescribeOption{topsep}\option{topsep}\\
-The extra space (additional to |\baselineskip|) between text above
-the columns and the text within the columns. Preset: |0cm|.
-\item\DescribeOption{bottomsep}\option{bottomsep}\\
-Idem for the bottom of the columns. Preset: |0cm|.
-\item\DescribeOption{indent}\option{indent}\\
-Horizontal indent left to the left column. Preset: |0cm|.
-\end{description}
-The dimensions described above are represented graphically in
-figure \ref{fig:twocolumndim}.
-\begin{figure}[htb]
-\centering
-\begin{pspicture}(0,.5)(13,10.5)
-\psline(0,0.5)(0,10)
-\rput[tl](.05,9.95){Top}
-\psframe[dimen=middle](1,9)(7,2)
-\psline{C-C}(8.5,9)(11,9)
-\psline{C-C}(8.5,2)(8.5,9)
-\psline{C-C}(8.5,2)(11,2)
-\qdisk(1.7,8.3){.1cm}
-\psset{linestyle=dashed}
-\psline{C-C}(1.7,8.3)(6.3,8.3)
-\psline{C-C}(1.7,8.3)(1.7,3)
-\psline{C-C}(6.3,5)(6.3,8.3)
-\psline{C-C}(11,9)(12,9)
-\psline{C-C}(11,2)(12,2)
-\psline{C-C}(11,7)(12,7)
-\psline{C-C}(9.2,8.3)(12,8.3)
-\psline{C-C}(9.2,8.3)(9.2,3)
-\rput[tl](1.75,8.25){Left column text}
-\rput[tl](9.25,8.25){Right column text}
-\rput[tl](.05,1){Bottom}
-\psset{linestyle=dotted,dotsep=2pt}
-\psline(0,8.3)(1.7,8.3)
-\psline(0,9.6)(1,9.6)
-\psline(0,2)(1,2)
-\psline(0,1.1)(1,1.1)
-\psset{linestyle=solid}
-\psline{<->}(.2,8.33)(.2,9.57)
-\psline{<->}(4,8.33)(4,8.97)
-\psline{<->}(1.73,7)(6.27,7)
-\psline{<->}(1.03,6.5)(1.67,6.5)
-\psline{<->}(0.03,5.5)(1.67,5.5)
-\psline{<->}(6.33,7.4)(9.17,7.4)
-\psline{<->}(8.53,6.5)(9.17,6.5)
-\psline{<->}(6.33,6.5)(6.97,6.5)
-\psline{<->}(10.7,8.33)(10.7,8.97)
-\psline{<->}(7.3,8.97)(7.3,2.03)
-\psline{<->}(.2,1.13)(.2,1.97)
-\psline{->}(1.7,9.3)(1.7,8.45)
-\psline{<-}(9.23,7)(11,7)
-\cput(4,6.6){\small 1}
-\cput(11.1,6.6){\small 2}
-\cput(8,7){\small 3}
-\cput(7.7,3){\small 4}
-\cput(4.4,8.65){\small 5}
-\cput(1.35,6.1){\small 5}
-\cput(8.85,6.1){\small 5}
-\cput(11.1,8.65){\small 5}
-\cput(6.65,6.1){\small 5}
-\cput(0.6,8.95){\small 6}
-\cput(0.6,5.1){\small 7}
-\cput(0.6,1.55){\small 8}
-\cput(1.7,9.6){\small 9}
-\end{pspicture}
-\begin{tabular}{c p{4cm}cl}
-\multicolumn{4}{c}{Meaning of the labels}\\\hline
-1&|lcolwidth|&5&|frsep|\\
-2&|rcolwidth|&6&|topsep|\\
-3&|colsep|&7&|indent|\\
-4&|lfrheight|, |rfrheight|,&8&|bottomsep|\\
-&|lineheight|&9&Reference point
-\end{tabular}
-\caption{Two-column dimensions.}\label{fig:twocolumndim}
-\end{figure}
-Important to notice is that the |\twocolumn| macro uses the current
-cursor position as the reference point to position the first line of
-text of the left column (see also figure \ref{fig:twocolumndim}). This
-means that optional frames can extend to the text on the previous
-line. Use for instance |topsep=0.3cm| in that case to add extra
-space between the two lines of text. The preset value of |topsep|
-is based on the situation that there is no text on top of the two
-columns. In that case, it is best to locate the first line of text
-of the left column at the same spot as text that is not created by
-|\twocolumn| on other slides. The setting |topsep=0cm| does exactly
-this. However, with a combination of |topsep| and |indent| you can
-change this behavior and position the first line of text of the left
-column anywhere you want.
-
-The |\twocolumn| macro computes the height of the construction to
-position text below the construction correctly. The computation is
-done by taking the maximum height of |lfrheight|, |rfrheight|,
-|lineheight| (if specified) and the left and right column content.
-Hence when frames nor a line is requested, |bottomsep| is the
-vertical space between the lowest line of text in the columns and
-the text below the columns (additional to |\baselineskip|). Here is
-an example.
-\begin{example}
- \begin{slide}{Two columns}
- Here are two columns.
- \twocolumn[
- lfrprop={linestyle=dotted,linewidth=3pt},
- lfrheight=4cm,rfrheight=5cm,lineheight=3cm,topsep=0.3cm
- ]{left}{right}
- Those were two columns.
- \end{slide}
-\end{example}
-Note that the use of the \pf{xkeyval} commands |\savevalue| and
-|\usevalue| \index{savevalue=\verb!*+\savevalue+|usage}
-\index{usevalue=\verb!*+\usevalue+|usage} could be handy here, for
-instance for copying the properties of the left frame to the right
-frame. This avoids typing them twice and avoids making errors
-resulting in different frames. See an example below.
-\begin{example}
- \twocolumn[
- \savevalue{lfrheight}=3cm,
- \savevalue{lfrprop}={
- linestyle=dotted,framearc=.2,linewidth=3pt},
- rfrheight=\usevalue{lfrheight},
- rfrprop=\usevalue{lfrprop}
- ]{left}{right}
-\end{example}
-See the \pf{xkeyval} documentation \cite{xkeyval} for more
-information about |\savevalue| and |\usevalue|.
-
-\section{Available styles}\label{sec:styles}
-\pf{powerdot} comes with a number of styles which are listed in the
-overview below. The characteristics of each style are described
-shortly and a sample of a title slide and a normal slide is provided
-for each style. Styles support the |wideslide| environment, have a
-table of contents on the left part of the paper in landscape
-orientation and on the bottom part in portrait orientation and
-support portrait orientation unless states otherwise.
-\begin{description}
-\item\pf{default}\\
-This style provides six different palettes. A flower in the top left
-corner decorates the slides for all palettes. The default palette is
-\texttt{blue} which has as main colors light blue and white. You can
-see an example of that palette below. Other available palettes are
-\texttt{red}, \texttt{green}, \texttt{yellow}, \texttt{brown} and
-\texttt{purple}.\\
-\styleexample{default}
-\item\pf{simple}\\
-This is a simple style in black and white. This style could be
-useful if you want to print your slides.\\
-\styleexample{simple}
-\item\pf{tycja}\\
-This style is set in shades of yellow and dark blue. The table of
-contents on slides is on the right side of the paper in landscape
-orientation and on the bottom part in portrait.\\
-\styleexample{tycja}
-\item\pf{ikeda}\\
-This style uses dark shades of red and blue and a light text color.
-It has nice patterns on the slide for decoration.\\
-\styleexample{ikeda}
-\item\pf{fyma}\\
-This style was originally created by Laurent Jacques for
-\pf{prosper}. Based on that style, he created a version for
-\pf{HA-prosper} with extended features. With his kind permission,
-this style has been converted by Shun'ichi J. Amano for
-\pf{powerdot}. The style has an elegant design with a light blue and
-white gradient background in the default \texttt{blue} palette.
-Other available palettes are \texttt{green}, \texttt{gray},
-\texttt{brown} and \texttt{orange}. It has special templates for
-sections on slides and sections on wide slides. Below is a sample of
-the blue palette.\\
-\styleexample{fyma}
-\item\pf{ciment}\\
-This style was originally created by Mathieu Goutelle for
-\pf{prosper} and \pf{HA-prosper}. With his kind permission, this style
-has been converted for \pf{powerdot}. The style has a background
-that is hatched with light gray horizontal lines. Titles and table
-of contents highlighting are done with dark red.\\
-\styleexample{ciment}
-\item\pf{elcolors}\\
-This is a style using light shades of the elementary colors red,
-blue and yellow.\\
-\styleexample{elcolors}
-\item\pf{aggie}\\
-This style was created by Jack Stalnaker for \pf{HA-prosper} and he
-has converted this style for \pf{powerdot}. The style uses dark red
-and light brown colors.\\
-\styleexample{aggie}
-\item\pf{husky}\\
-This style is created by Jack Stalnaker and has a background of
-light gray sun beams combined with dark red highlights.\\
-\styleexample{husky}
-\item\pf{sailor}\\
-This style is contributed by Mael Hill\'ereau and supplies five
-different palettes: \texttt{Sea} (the default), \texttt{River},
-\texttt{Wine}, \texttt{Chocolate} and \texttt{Cocktail}. Below is a
-sample of the palette \texttt{Sea}.\\
-\styleexample{sailor}
-\item\pf{upen}\\
-This style has a nice dark blue background and text in yellow. It is
-contributed by Piskala Upendran.\\
-\styleexample{upen}
-\item\pf{bframe}\\
-The \pf{bframe} style has blue frames on the slide in which text is
-positioned. The style is contributed by Piskala Upendran.\\
-\styleexample{bframe}
-\item\pf{horatio}\\
-The \pf{horatio} style has been contributed by Michael Lundholm and
-is a more conservative blue style.\\
-\styleexample{horatio}
-\item\pf{paintings}\\
-This is a simple style without a table of contents on slides. It has
-been contributed by Thomas Koepsell and provides 10 different
-palettes. The colors used in the palettes are drawn from famous
-paintings.\footnote{The style defines a color \texttt{pdcolor7}
-which is not used in the style but comes from the same painting and
-complements the other colors. It can be used, for example, to
-highlight text against the main background color.} If you are
-interested, open the style file to read which paintings have been
-used. The available palettes are: \texttt{Syndics} (the default),
-\texttt{Skater}, \texttt{GoldenGate}, \texttt{Lamentation},
-\texttt{HolyWood}, \texttt{Europa}, \texttt{Moitessier},
-\texttt{MayThird}, \texttt{PearlEarring} and \texttt{Charon} (all
-case sensitive). Below is a sample of the \texttt{Syndics}
-palette.\\
-\styleexample{paintings}
-\item\pf{klope}\\
-The \pf{klope} style implements a horizontal table of contents that
-only lists the sections. The style is available in the following
-palettes: \texttt{Spring}, \texttt{PastelFlower}, \texttt{BlueWater}
-and \texttt{BlackWhite}. The \texttt{Spring} palette is the default
-and you can see a sample of that below.\\
-\styleexample{klope}
-\item\pf{jefka}\\
-The \pf{jefka} style comes with four palettes: \texttt{brown} (the
-default), \texttt{seagreen}, \texttt{blue} and \texttt{white}. Below
-you see a sample of the \texttt{brown} palette.\\
-\styleexample{jefka}
-\item\pf{pazik}\\
-This style is available in two palettes: \texttt{red} and
-\texttt{brown}. Below is a sample of the default \texttt{red}
-palette.\\
-\styleexample{pazik}
-\end{description}
-
-\section{Compiling your presentation}\label{sec:compiling}
-\subsection{Dependencies}\label{sec:dependencies}
-In table \ref{tab:dependencies} is a list of packages that
-\pf{powerdot} uses to perform specific tasks. Dependencies of
-packages in this table are not listed. In the table, `required'
-means that you should have a version \emph{at least} as new as
-listed and `tested' means that \pf{powerdot} was tested with this
-version, but that it could equally well work with an older or newer
-version than the one listed in the table. So, when trying to solve
-an error, first concentrate on solving version issues for the
-`required' packages. To find out which version of a package you are
-currently using, put |\listfiles| on the first line of your
-document, run it with \LaTeX, open the |.log| file and read the file
-list (see a \LaTeX\ manual for more information). If you need to
-update a package, you can get it from CTAN \cite{CTAN}.
-\begin{table}[htb]
-\centering
-\begin{tabular}{e}
-Package/file & Version & Date & Required/tested\\\hline
-\pf{xkeyval} \cite{xkeyval} & 2.5c & 2005/07/10 & required\\
-\texttt{pstricks.sty} \cite{PSTricksWeb,PSTricks} & 0.2l & 2004/05/12 & required\\
-\pf{xcolor} \cite{xcolor} & 1.11 & 2004/05/09 & required\\
-\pf{enumitem} \cite{enumitem} & 1.0 & 2004/07/19 & required\\
-\pf{article} class & 1.4f & 2004/02/16 & tested\\
-\pf{geometry} \cite{geometry} & 5.x & 2010/10/07 & tested\\
-\pf{hyperref} \cite{hyperref} & 6.74m & 2003/11/30 & tested\\
-\pf{graphicx} \cite{graphics} & 1.0f & 1999/02/16 & tested\\
-\pf{verbatim} & 1.5q & 2003/08/22 & tested
-\end{tabular}
-\caption{Dependencies}\label{tab:dependencies}
-\end{table}
-
-\subsection{Creating and viewing output}\label{sec:creation}
-To compile your presentation, run it with \LaTeX. The DVI that is
-produced this way can be viewed with MiK\TeX's DVI viewer
-YAP.\footnote{Unless you are using \pf{pstricks-add} which distorts
-the coordinate system in DVI.} Unfortunately, xdvi and kdvi (kile)
-do not support all PostScript specials and hence these will display
-the presentation incorrectly. If your DVI viewer does support
-this, make sure that your DVI display settings match that of the
-presentation. In case you are using the |screen| paper, you should
-set the DVI display setting to using the letter paper format. If
-your DVI viewer allows for custom paper formats, use 8.25 inch by 11
-inch.
-
-Note that certain things that are produced with PostScript or PDF
-techniques will not work in a DVI viewer. Examples are hiding of
-material via postscript layers (as is done, for instance, by
-|\pause|, see section~\ref{sec:overlays}) and hyperlinks, for
-instance in the table of contents.
-
-If you want to produce a postscript document, run dvips over the DVI
-\emph{without any particular command line options related to
-orientation or paper size}. \pf{powerdot} will write information to
-the DVI file that helps dvips and ps2pdf (ghostscript) to create a
-proper document. If you have some reason that this does not work for
-you and you want to specify the paper and orientation yourself, you
-should use the |nopsheader| option that is described in
-section~\ref{sec:setup}. The PostScript document could, for
-instance, be used to put multiple slides on a page using the |psnup|
-utility.
-
-To create a PDF document for your presentation, run ps2pdf over the
-PS file created with dvips. Also here, you can \emph{leave out any
-command line arguments related to paper size or orientation}. If
-this is problematic for you somehow, use the |nopsheader| option as
-before and specify the paper and orientation at each intermediate
-step yourself.
-
-\section{Creating your own style}\label{sec:writestyle}
-\subsection{General information}
-Writing or customizing \pf{powerdot} styles is simple. If you want
-to modify a style or build a new one, locate the style that you want
-to use as basis in your \TeX\ tree (styles are named as
-|powerdot-<style_name>.sty|), copy that and rename it as to avoid
-license\footnote{The \LaTeX\ Public Project License requires
-renaming files when modifying them, see
-\url{http://www.latex-project.org/lppl}.} or naming conflicts. You
-might want to install the new style in your local \TeX\ tree to be
-able to access it from any place on your hard drive. See your
-\LaTeX\ distribution for more information.
-
-Once that has been taken care of, we can start creating the style.
-We strongly recommend to study a style file (for example,
-|powerdot-default.sty|) while reading the remainder of this section
-as it provides good examples for the content of this section.
-
-A style has several components. We describe these components below.
-\begin{description}
-\item\textbf{Identification and packages}\\
-This identifies the package in the log of a presentation and loads
-all required packages. The \pf{default} style contains something like:
-\begin{example}
- \NeedsTeXFormat{LaTeX2e}[1995/12/01]
- \ProvidesPackage{powerdot-default}[2005/10/09 v1.2 default style (HA)]
- \RequirePackage{pifont}
-\end{example}
-See for more information about these commands a \LaTeX\ manual, for
-instance \cite{companion}.
-\item\textbf{Palette or color definitions}\\
-This section contains the definitions of palettes or colors that you
-want to use in the style. \pf{powerdot} uses \pf{xcolor} (via
-\pf{pstricks}). Hence, for more information about colors, see the
-\pf{xcolor} documentation. We will discuss palettes in more detail
-in section~\ref{sec:defpals}.
-\item\textbf{Template definitions}\\
-We will come back to this in sections~\ref{sec:deftemps}
-to~\ref{sec:defbg}.
-\item\textbf{Custom declarations}\\
-These can include anything that you want to be part of the style.
-The \pf{default} style, for instance, includes definitions for the labels
-in list environments like |itemize| and some initializations for
-lists in general (done with |\pdsetup|, see
-section~\ref{sec:pdsetup}). This part could also include some
-customizations as described in section~\ref{sec:specialtemps}.
-\item\textbf{Font initializations}\\
-This initializes font definitions (which can be done by
-loading a package like \pf{helvet}).
-\end{description}
-
-\subsection{Defining palettes}\label{sec:defpals}
-We will be defining templates formally in
-section~\ref{sec:deftemps}. For now, it's enough to have the general
-idea that a template controls the design of a slide. Palettes are
-sets of colors that color a template or design. A palette does not
-change the overall design of a template.
-
-\DescribeMacro{\pddefinepalettes}
-The following command can be used to define palettes for your style.
-\begin{command}
- `\cs{pddefinepalettes}\marg{name1}\marg{cmds1}\dots'
-\end{command}
-This macro takes \emph{any} even number of mandatory arguments with
-a minimum of two. For every \meta{name}, a set of \meta{commands}
-can be given which define the palette with name \meta{name}. These
-commands can define colors with names |pdcolor1|, |pdcolor2|,
-etcetera. These colors can be used when designing the template (see
-section~\ref{sec:deftemps}). |pdcolor1| will always be used as text
-color.
-
-The user can access these palettes via the |palette| key for the
-|\pdsetup| command (see section~\ref{sec:pdsetup}). If the user does
-not specify a palette, the first palette defined when compiling the
-presentation, will be used. Here is an example for defining 2
-palettes.
-\begin{example}
- \pddefinepalettes{reds}{
- \definecolor{pdcolor1}{rgb}{1,0,0}
- \definecolor{pdcolor2}{rgb}{1,.1,0}
- \definecolor{pdcolor3}{rgb}{1,.2,0}
- }{greens}{
- \definecolor{pdcolor1}{rgb}{0,1,0}
- \definecolor{pdcolor2}{rgb}{.1,1,0}
- \definecolor{pdcolor3}{rgb}{.2,1,0}
- }
-\end{example}
-In this example, the |reds| palette is the default one. For more
-information about |\definecolor|, see the documentation of the
-\pf{xcolor} package \cite{xcolor}.
-
-Notice that it is not necessary to use the names |pdcolor2|,
-|pdcolor3| etcetera as color names. But if these colors are defined,
-\pf{powerdot} will use them, for instance, in the random dots
-feature (see section~\ref{sec:glopts}). The flexibility adds extra
-possibilities in setting up templates and palettes. See for an
-example of its use, the \pf{klope} style.
-
-\subsection{Defining templates}\label{sec:deftemps}
-We start off with a definition of what a template is. A template is
-a collection of settings for slide components together with custom
-definitions, which controls the visual appearance of a slide. A
-style can contain multiple templates.
-
-\begin{command}
- `\cs{pddefinetemplate}\oarg{basis}\marg{name}\marg{options}\marg{commands}'
-\end{command}
-\DescribeMacro{\pddefinetemplate}
-This defines the environment \meta{name} to produce a slide with
-characteristics determined by \meta{basis}, \meta{options} and
-\meta{commands}. We will discuss these elements in more detail
-in the coming sections.
-
-If you want to create several templates that differ only slightly
-from each other, define a \meta{basis} template, and then use it to
-define other templates. All \meta{options} and \meta{commands} for
-the new template \meta{name} will be appended to the existing list
-of \meta{options} and \meta{commands} from the \meta{basis}
-template.
-
-Make sure you choose a \emph{proper} name for the template, and
-avoid redefining existing templates or environments. \pf{powerdot}
-defines |pauseslide|, |note| and |emptyslide| internally, so you
-shouldn't use these names unless you know what you're doing.
-Furthermore, each style needs to define at least the templates
-|slide| and |titleslide|. The |titleslide| environment will be used
-to create the title slide and |slide| will (by default) also be used
-to create section slides. Titles and sections are a bit special in
-the way they use the \meta{options} and will be discussed in more
-detail in section~\ref{sec:specialtemps}.
-
-\subsection{Controlling setup}
-\DescribeOption{ifsetup}
-The \meta{options} (keys) are described in the following sections.
-You can control how these options apply to the various setups by
-using the |ifsetup| key. Any key appearing before the first
-|ifsetup| declaration in \meta{options} will apply to every possible
-setup. Once the |ifsetup| key is used, then all subsequent key
-declarations will apply \textit{only} to the setups declared in the
-|ifsetup| key. The |ifsetup| key can be used multiple times.
-
-By possible setups, we mean the allowed values of the |mode|,
-|paper|, |orient|, and |display| keys that are described in
-section~\ref{sec:classopts}. If a value (or values!) for any of
-these four keys is not specified in a |ifsetup| declaration, then
-all subsequent key declarations will apply to any layout of that
-type. Consider the following as an example.
-\begin{example}[numbers=left,numberstyle=\tiny\ttfamily,
- escapeinside=`',numbersep=1em,xleftmargin=1em]
- ...
- textpos={.2\slidewidth,.3\slideheight},
- ifsetup={portrait,screen},
- textpos={.3\slidewidth,.2\slideheight}
- ...
- ifsetup=landscape,
- ...
- ifsetup,
- ...
-\end{example}
-Assuming there was no |ifsetup| declaration before the first
-|textpos| declaration, this first |textpos| will apply to every
-possible setup. However, for the screen format in portrait
-orientation, the next |textpos| declaration will be used. In fact,
-all declarations that appear until we switch to the next |ifsetup|
-(which specifies all paper sorts and only landscape orientation)
-will be used in the portrait screen layout. All keys after the next
-|ifsetup| declaration will be used in landscape orientation,
-\emph{with any paper, mode and display}. If, after declaring some
-specializations, you want to switch back to settings that apply to
-all possible setups, set |ifsetup| to empty as is done in the
-example. All subsequent declarations will then again be applied
-under any setup.
-
-The following command is a stand-alone implementation of the
-mechanism described above. It allows you to control the setup
-outside the \meta{options} argument of the |\pddefinetemplate|
-command.
-\begin{command}
- `\cs{pdifsetup}\marg{desired}\marg{true}\marg{false}'
-\end{command}
-\DescribeMacro{\pdifsetup}
-This macro executes \meta{true} when the setup that the user chose
-matches with the \meta{desired} setup, \meta{false} in all other cases.
-For instance, if the user has chosen landscape, then
-\begin{example}
- \pdifsetup{landscape}{yes}{no}
-\end{example}
-will typeset |yes|. If the user would have chosen portrait instead,
-then |no| would have been typeset.
-
-This macro can be used to check setup requests from the user and,
-for instance, generate an error if a certain setup is not supported
-by your style. \pf{powerdot} provides one predefined error message
-which can be used in one of the first lines of your style.
-\begin{command}
- `\cs{pd@noportrait}'
-\end{command}
-\DescribeMacro{\pd@noportrait}
-This macro generates an error when the user requests portrait
-orientation. Notice that the handout mode only works in portrait
-orientation. This macro takes that into account and doesn't generate
-an error in the case that the user requested a handout.
-
-\subsection{Main components}\label{sec:maincomps}
-The \meta{options} control several key components of a slide. Every
-component has several properties. A key that can be used in the
-\meta{options} argument is the name of the component postfixed by
-its property that you want to control.
-
-The components |title|, |text|, |toc|, |stoc| and |ntoc| have
-properties |hook|, |pos|, |width| and |font|. Additionally, the
-|text| component has a |height| property. The components |lf|, |cf| and
-|rf| have properties |hook|, |pos|, |temp| and |font|. Hence,
-examples of valid keys are |titlefont|, |tocpos| and |lftemp|. All
-components and properties will be discussed below.
-
-Here is an overview of the components that can be controlled from
-the \meta{options} argument in |\pddefinetemplate|.
-\begin{description}
-\item\DescribeOption{title-}\option{title-}\\
-The slide title.
-\item\DescribeOption{text-}\option{text-}\\
-The main text box on the slide.
-\item\DescribeOption{toc-}\option{toc-}\\
-The (full) table of contents on a slide containing sections and
-slides.
-\item\DescribeOption{stoc-}\option{stoc-}\\
-This is a table of contents containing only the sections. See also
-|ntoc| below.
-\item\DescribeOption{ntoc-}\option{ntoc-}\\
-This is a table of contents containing only the entries for the
-active section. Together with |stoc|, this can be used to create a
-split table of contents. In a particular template, one would usually
-have a |toc|, a combination of |stoc| and |ntoc| or no table of
-contents at all.
-\item\DescribeOptions{lf-,cf-,rf-}\option{lf-,cf-,rf-}\\
-The left, center and right footers.
-\end{description}
-
-Notice that all positioning of components described above will be
-done with |\rput| from \pf{pstricks} \cite{PSTricksWeb,PSTricks}
-internally. See the \pf{pstricks} documentation for more information
-about this command. It should also be noted that all components
-(except |lf|, |cf| and |rf|) put their content in a |minipage|
-environment.
-
-Now we list all properties of the components listed above and
-describe what they mean. Remember that keys are formed by combining
-a component name and a property.
-
-\begin{description}
-\item\DescribeOption{-hook}\option{-hook}\\
-This option defines the |\rput| hook that will be used when
-positioning the item. This can be |tl|, |t|, |tr|, |r|, |Br|, |br|,
-|b|, |bl|, |Bl|, |l|, |B| and |c|. See the \pf{pstricks}
-documentation for more information.
-\item\DescribeOption{-pos}\option{-pos}\\
-This defines the position of the |hook| on the paper. The lower left
-corner of the paper is given by the point |{0,0}| and the upper right
-corner by the point |{\slidewidth,\slideheight}|. So if you want to
-position the main text box at 20\% from the left edge and 30\% from
-the top edge of the paper, you have to do the following.
-\begin{example}
- textpos={.2\slidewidth,.7\slideheight}
-\end{example}
-If the position of any component has not been specified, this
-component will not be placed on the slide. This gives an opportunity
-to design slides without footers or table of contents, for instance.
-\item\DescribeOption{-width}\option{-width}\\
-The width of the component. All component positioned by
-\pf{powerdot} will be put in a surrounding |minipage| environment.
-The |width| property determines the width of the |minipage|. Example:
-\begin{example}
- textwidth=.7\slidewidth
-\end{example}
-This property does not exist for the |lf|, |cf| and |rf| components.
-\item\DescribeOption{-height}\option{-height}\\
-This option is only available for the |text| component. In other
-words, for this property, there is only one key, namely
-|textheight|. This can be used to specify the height of the
-|minipage| used for the main text. This does not imply that users
-are restricted to this length or that \pf{powerdot} does automatic
-slide breaking. This height is only used for vertical alignments of
-material, for instance by footnotes. The preset value is
-|\slideheight|.
-\item\DescribeOption{-font}\option{-font}\\
-This will be inserted just before the text that is about to be
-typeset. This can be used to declare deviations from the main text
-font and color. It can be a font declaration, like
-|\large\bfseries|, but can also contain other things like
-|\color{red}| or |\raggedright|.
-\item\DescribeOption{-temp}\option{-temp}\\
-This property is only available for the footers (|lf|, |cf| and |rf|) and
-can be used to change the template of the footers. This means that
-you can, for instance, add content to the footer, besides the
-content specified by the user. The default declaration by
-\pf{powerdot} is the following.
-\begin{example}
- rftemp=\pd@@rf\ifx\pd@@rf\@empty
- \else\ifx\theslide\@empty\else\ -- \fi\fi\theslide
-\end{example}
-Here |\pd@@rf| will contain the content of the right footer defined
-by the user via the |\pdsetup| command. Similarly, |\pd@@lf|
-contains the content of the left footer. The above declaration
-checks whether the footer and |\theslide| are both non-empty and if
-so, it inserts | -- | to separate both.
-\item\DescribeOption{-orient}\option{-orient}\\
-This property is only available for the |toc|, |stoc| and |ntoc|
-components. This property can be |h| or |v| and determines the
-orientation of the table of contents. The preset is |v|. See
-also section~\ref{sec:slidetoc} for more information about the
-construction of the table of contents.
-\end{description}
-
-\subsection{Slide toc}\label{sec:slidetoc}
-The small table of contents that is placed on slides can be
-controlled by four macros and several options.
-
-\DescribeMacro{\pd@tocslide}
-\DescribeMacro{\pd@tocsection}
-These macros take one argument. When building the table of contents,
-\pf{powerdot} first passes the content through |\pd@tocslide| or
-|\pd@tocsection|, depending on the type of entry that it is building
-at that moment. You could, for instance, do
-\begin{example}
- \def\pd@tocslide#1{$\bullet$\ #1}
- \def\pd@tocsection#1{#1}
-\end{example}
-which will prefix all normal entries (not the sections) with a
-bullet. By default, these two macros are defined to just pass on
-their argument.
-
-\DescribeMacro{\pd@tocdisplay}
-\DescribeMacro{\pd@tochighlight}
-These two macros also take one argument. After processing an entry
-with the command |\pd@tocslide| or |\pd@tocsection|, \pf{powerdot}
-continues building the entry by passing it through |\pd@tocdisplay|,
-when the entry needs to be displayed only, or |\pd@tochighlight|,
-when the entry needs to be highlighted. These macros are a little
-more involved and take care of putting the content in the proper
-font and color in a |minipage|. Further, |\pd@tochighlight| also
-puts a box around the item.
-
-Notice, that by default, both the separate table of contents entries
-as well as the table of contents as a whole are typeset in
-|minipage| environments by these macros, in case the table of
-contents is vertical. The |-width| properties then determines the
-width of the table of contents and, together with |tocsecindent| and
-|tocslideindent| (see below) the width of the individual entries. If
-it is horizontal, only the separate entries will be in |minipage|s
-and the table of contents itself not and the |-width| properties
-determine only the width of the individual entries (together with
-|tocsecindent| and |tocslideindent|).
-
-Several aspects of the process of generating the table of contents
-can be controlled via the keys that are available in the
-|\pddefinetemplate| command that will be described below. If these
-keys do not provide enough handles to do what you want, you might
-need to have a look at the two macros in the source and decide to
-rewrite them in your style as to fit your needs. An example can be
-found in the \pf{fyma} style.
-
-\begin{description}
-\item\DescribeOption{tocfrsep}\option{tocfrsep}\\
-This length is the distance between the box around the content
-created by the |minipage| and the highlight frame box created by
-|\pd@tochighlight|. Preset: |0.5mm|.
-\item\DescribeOption{tocsecsep}\option{tocsecsep}\\
-The distance inserted before a section (unless it is the
-first element in the table of contents). Preset: |2ex|.
-Notice that if the orientation of the table of contents is set to
-vertical, this length creates a vertical skip, otherwise, it creates
-a horizontal skip.
-\item\DescribeOption{tocslidesep}\option{tocslidesep}\\
-The distance inserted before other entries (unless it is the
-first element in the table of contents). Preset: |0ex|. Like
-|tocsecsep|, the effect of this length depends on the orientation of
-the table of contents.
-\item\DescribeOption{tocsecindent}\option{tocsecindent}\\
-The horizontal space left to a section entry. Preset: |0pt|.
-\item\DescribeOption{tocslideindent}\option{tocslideindent}\\
-The horizontal space left to a slide entry. The horizontal skip will
-not be inserted left to slide entries that appear before the first
-section. Preset: |0pt|.
-\item\DescribeOption{tocsecm}\option{tocsecm}\\
-This is inserted just before typesetting a section. This can be used
-to mark a section, for instance with a line as in the \pf{default}
-style. Preset: empty.
-\item\DescribeOption{toctcolor}\option{toctcolor}\\
-This is the text color used for non-highlighted elements in the
-table of contents. Preset: |black|.
-\item\DescribeOption{tochltcolor}\option{tochltcolor}\\
-This is the text color used for highlighted elements in the table of
-contents. Preset: |white|.
-\item\DescribeOption{tochlcolor}\option{tochlcolor}\\
-This is the color used for the frame behind highlighted elements.
-Preset: |black|.
-\end{description}
-
-\subsection{Miscellaneous options}\label{sec:miscoptions}
-There are some options that fall outside of the scope of the previous
-sections. These will be discussed here.
-
-\begin{description}
-\item\DescribeOption{iacolor}\option{iacolor}\\
-The |iacolor| option can be used to specify the color that is used
-for inactive things, produced for instance by |\onslide|, |\pause|
-(see section~\ref{sec:overlays}) and |\tableofcontents| (see
-section~\ref{sec:tableofcontents}). As \pf{xcolor} is used by
-\pf{powerdot}, one can use special notation here, like
-\begin{example}
- iacolor=black!20
-\end{example}
-The preset value for this key is |lightgray|.
-\end{description}
-
-The following options control the digital clock (see
-section~\ref{sec:classopts}). The clock is a form text field with
-dynamic content, driven by a javascript via \pf{hyperref} text
-fields. Some options for the clock work similarly as for, for
-instance, the title component, but there are also special options.
-\begin{description}
-\item\DescribeOptions{clockhook,clockpos}\option{clockhook,clockpos}\\
-These work in the same way as the |-hook| and |-pos| properties
-discussed in section~\ref{sec:maincomps}. The preset value of
-|clockhook| is |tr|.
-\item\DescribeOptions{clockwidth,clockheight}\option{clockwidth,clockheight}\\
-These control the width and height of the text field containing the
-clock. Preset values come from \pf{hyperref} and are |3cm| and
-|\baselineskip|, respectively.
-\item\DescribeOption{clockcharsize}\option{clockcharsize}\\
-The size of characters of the clock. Preset: |14pt|.
-\item\DescribeOption{clockalign}\option{clockalign}\\
-The alignment of the clock in the text field. |0| is left-aligned,
-|1| is centered and |2| is right aligned. Preset is |2|.
-\item\DescribeOption{clockcolor}\option{clockcolor}\\
-This determines the text color of the clock. The value should be a
-named color. The preset value is |black|.
-\end{description}
-
-\subsection{Template presets}
-Below, we have copied the preset setting for the keys described
-above. These will be used if you didn't supply other input for these
-keys in a particular template. If the preset value meets your
-needs, you don't have to specify it again in your style.
-\begin{example}
- titlehook=Bl,titlepos=,titlewidth=\slidewidth,
- titlefont=\raggedright,texthook=tl,textpos=,
- textwidth=\slidewidth,textfont=\raggedright,
- textheight=\slideheight,
- tochook=tl,tocpos=,tocwidth=.2\slidewidth,
- tocfont=\tiny\raggedright,
- stochook=tl,stocpos=,stocwidth=.2\slidewidth,
- stocfont=\tiny\raggedright,
- ntochook=tl,ntocpos=,ntocwidth=.2\slidewidth,
- ntocfont=\tiny\raggedright,
- tocorient=v,stocorient=v,ntocorient=v,
- tocfrsep=.5mm,tocsecsep=2ex,tocslidesep=0ex,
- tocsecm=,toctcolor=black,tochlcolor=black,tochltcolor=white,
- tocsecindent=0pt,tocslideindent=0pt,
- lfhook=Bl,lfpos=,lffont=\scriptsize,lftemp=\pd@@lf,
- cfhook=B,cfpos=,cffont=\scriptsize,cftemp=\pd@@cf,
- rfhook=Br,rfpos=,rffont=\scriptsize,rftemp=\pd@@rf\ifx\pd@@rf
- \@empty\else\ifx\theslide\@empty\else\ -- \fi\fi\theslide,
- iacolor=lightgray,
- clockhook=tr,clockpos=,clockwidth=3cm,clockheight=\baselineskip,
- clockcharsize=14pt,clockalign=2,clockcolor=black
-\end{example}
-
-\subsection{The background}\label{sec:defbg}
-This leaves only one argument of the |\pddefinetemplate| macro
-undiscussed. This is the \meta{commands} argument. This argument can
-contain any code that you want to execute \textit{after} setting the
-options and \textit{before} building the slide components like the
-slide title, main text, and footers. This argument is designed to
-contain declarations that will build the background of a template
-using, for instance, \pf{pstricks}, but it can also hold other
-commands you might need for building your template.
-
-Important to notice is that these commands may not create \TeX\
-material as that might destroy the construction of the slide. So, if
-you want to place the word `Hello' in the bottom left corner of the
-slide, don't type `Hello', but make its width, height and depth
-equal to zero, for instance by using \pf{pstricks}' |\rput|.
-\begin{example}
- \rput[bl](0,0){Hello}
-\end{example}
-
-\subsection{Title slide, titles and sections}\label{sec:specialtemps}
-As mentioned before, the style that you write needs to define at
-least the templates |slide| and |titleslide|. The latter treats some
-of the keys in a special way. Besides, a section slide is also done
-in a special way.
-
-The title slide (made with |\maketitle|) puts the title with
-author(s) and date in the main text box. This means that you have to
-supply a position for the main text box (|textpos|). It will use the
-main text font for the text (together with declarations in the
-|textfont| key) for the author(s) and the date. But it will use the
-declarations in |titlefont| for the title of the presentation. This
-is done so that title and author(s) form a coherent block and to
-make sure that long titles can push down the author(s) instead of
-overwriting it.
-
-\DescribeMacro{\pd@slidetitle}
-The |\pd@slidetitle| macro is used to typeset the slide title on
-slides. This macro is comparable to for instance |\pd@tocslide|. The
-macro takes one argument which is the slide title in the right font
-and formatting. By default, this macro just passes on the content
-for typesetting, but you could redefine this macro so do something
-with its input prior to typesetting it. An example is in the
-\pf{fyma} style which underlines the title after putting it in a
-|minipage| to support multi line titles.
-
-\DescribeMacros{\pd@title,\pd@sectiontitle}
-These macros are similar to |\pd@slidetitle| and typeset the title
-on the title slide and the title on section slides respectively. By
-default, these also pass there argument (which is the presentation
-title or section title), but these can be redefined to do something
-with the input prior to typesetting it, just as |\pd@slidetitle|.
-
-\DescribeOptions{sectemp,widesectemp}
-The |\section| command uses (by default) the |slide| environment and
-puts the section title in the title box with font |titlefont|. If
-you want to change the default use of the |slide| environment for
-sections to, for instance, the |sectionslide| environment or any
-other especially designed section template, change the section
-template preset in your style, using
-\begin{example}
- \setkeys[pd]{section}{sectemp=sectionslide}
-\end{example}
-This means that if the user asks for |template=slide| in the
-|\section| command, the |sectionslide| environment will be used
-silently. To avoid surprises, |sectionslide| should preferably be
-based on the |slide| environment.
-
-A similar option is available in case the user asks for
-|template=wideslide|. One could for instance do the following.
-\begin{example}
- \setkeys[pd]{section}{widesectemp=sectionwideslide}
-\end{example}
-Whenever the user requests a |wideslide| to be used for a
-|\section|, instead, the |sectionwideslide| environment will be
-used. Other input to the |template| key by the user does not get a
-special treatment.
-
-Notice that these keys are available in the |section| family of keys
-and that you cannot use them in the |\pddefinetemplate| command.
-
-\subsection{Testing the style}\label{sec:styletest}
-\pf{powerdot} has a test file that should test most of the style.
-This test file can be produced by running \LaTeX\ over
-|powerdot.dtx|. This generates |powerdot-styletest.tex| which will
-help you with the testing job. Feel free to contact us when you
-would like to contribute your style to \pf{powerdot}. See also
-section~\ref{sec:questions}.
-
-\section{Using \LyX\ for presentations}\label{sec:lyx}
-\LyX\ \cite{LyXWeb} is a WYSIWYM (What You See Is What You Mean)
-document processor based on \LaTeX. It supports standard \LaTeX\
-classes but needs special files, called layout files, in order to
-support non-standard classes such as \pf{powerdot}.
-
-To start using \LyX\ for \pf{powerdot} presentations, copy the
-layout file |powerdot.layout| to the \LyX\ layout directory. You can
-find this file in the doc tree of your \LaTeX\ installation:
-\url{texmf/doc/latex/powerdot}. If you can't find it there, download
-it from \url{CTAN:/macros/latex/contrib/powerdot}. Once that is
-done, reconfigure \LyX\ (\texttt{Edit\LyXarrow Reconfigure} and
-restart \LyX\ afterwards). Now you can use the \pf{powerdot}
-document class as any other supported class. Go to
-\texttt{Layout\LyXarrow Document} and select \texttt{powerdot
-presentation} as document class. For more information, see the \LyX\
-documentation, which is accessible from the |Help| menu.
-
-\subsection{How to use the layout}
-The \pf{powerdot} \LyX\ layout provides some environments\footnote{Don't
-confuse these with \LaTeX\ environments.} which can be used in \LyX.
-Some of these environments (for instance |Title| or |Itemize|) are
-natural to use since they exist also in the standard document
-classes such as \pf{article}. For more information on these standard
-environments, see the \LyX\ documentation.
-
-This section will explain how to use the \pf{powerdot} specific
-environments |Slide|, |WideSlide|, |EmptySlide| and |Note|. These
-environments correspond to the \pf{powerdot} environments |slide|,
-|emptyslide|, |wideslide| and |note|.
-
-We start with a simple example. The following \LaTeX\ code
-\begin{example}
- \begin{slide}{Slide title}
- Slide content.
- \end{slide}
-\end{example}
-can be obtained using the following \LyX\ environments. The right
-column represents the text typed into the \LyX\ window and the left
-column represents the environment applied to this text).
-\begin{example}
- Slide Slide title
- Standard Slide content.
- EndSlide
-\end{example}
-Some remarks concerning this example.
-\begin{itemize}[leftmargin=0pt,itemsep=0pt,parsep=0pt]
-\item You can use the environment menu (under the menu bar, top-left
-corner) to change the environment applied to text.
-\item The slide title should be typed on the line of the |Slide|
-environment.
-\item |EndSlide| finishes the slide and its line is left blank.
-\end{itemize}
-
-In the \LyX\ window, the |Slide| environment (that is, the slide
-title) is displayed in magenta, the |WideSlide| style in green, the
-|EmptySlide| style in cyan and the |Note| style in red and hence
-these are easily identifiable.
-
-Here is another example.
-\begin{example}
- \begin{slide}{First slide title}
- The first slide.
- \end{slide}
- \begin{note}{First note title}
- The first note, concerning slide 1.
- \end{note}
- \begin{slide}{Second slide title}
- The second slide.
- \end{slide}
-\end{example}
-This can be done in \LyX\ in the following way.
-\begin{example}
- Slide First slide title
- Standard The first slide.
- Note First note title
- Standard The first note, concerning slide 1.
- Slide Second slide title
- Standard The second slide.
- EndSlide
-\end{example}
-This example demonstrates that it is often sufficient to insert the
-|EndSlide| style after the last slide or note only. Only when you
-want certain material not to be part of a slide, you need to finish
-the preceding slide manually using the |EndSlide| style. Example:
-\begin{example}
- Slide First slide title
- Standard The first slide.
- EndSlide
- [ERT box with some material]
- Slide Second slide title
- ...
-\end{example}
-
-Options can be passed to slide environments by using
-\texttt{Insert\LyXarrow Short title} in front of the slide title.
-The following example uses the |direct| method (see
-section~\ref{sec:verbatim}) in the short title argument (delimited by
-square brackets) to allow for a |lstlisting| environment (defined by
-the \pf{listings} package) within the slide content.
-\begin{example}
- Slide [method=direct]Example of LaTeX source code
- Standard Here's the \HelloWorld command:
- [ERT box:
- \lstset{language=[LaTeX]TeX}
- \begin{lstlisting}
- \newcommand{\HelloWorld}{Hello World!}
- \end{lstlisting}
- ]
- EndSlide
-\end{example}
-Note that you are not obliged to use a |verbatim| environment to
-type the |\HelloWord| text into the \LyX\ window because \LyX\
-directly supports standard verbatim.\footnote{\LyX\ translates
-special characters into their corresponding \LaTeX\ command. For
-instance, the backslash character is translated into
-\cs{textbackslash{}}. Resulting, the font is not the same as in true
-verbatim and you might want to change that via the
-\texttt{Layout\LyXarrow Character} dialog.} Consequently, the use of
-the slide processing methods |direct| and |file| is not necessary
-when you need standard verbatim, but it is necessary when doing more
-advanced things, like in the example above.
-
-\subsection{Support of syntax}
-This section lists options, commands and environments that are
-supported through the \LyX\ interface directly, without using an ERT
-box (\TeX-mode).
-
-All class options (see section~\ref{sec:classopts}) are supported
-via the \texttt{Layout\LyXarrow Document} dialog (|Layout| pane).
-Options for the |\pdsetup| command (see section~\ref{sec:setup})
-should be specified in the |Preamble| pane of the
-\texttt{Layout\LyXarrow Document} dialog.
-
-Table \ref{tab:lyxcommands} lists the \pf{powerdot} commands that
-are supported in \LyX.
-\begin{table}[htb]
-\centering
-\begin{tabular}{f}
-Command & Method in \LyX\\\hline
-\cs{title} & Use \texttt{Title} environment.\\
-\cs{author} & Use \texttt{Author} environment.\\
-\cs{date} & Use \texttt{Date} environment.\\
-\cs{maketitle} & Managed directly by \LyX.\\
-\cs{section} & Use the \texttt{Section} environment. Options to this
-command (see section~\ref{sec:section}) can be specified using
-\texttt{Insert\LyXarrow Short title} in front of the section title.\\
-\cs{tableofcontents} & Use \texttt{Insert\LyXarrow Lists \&
-TOC\LyXarrow Table of contents}. You will need an ERT box if you
-want to use the optional argument, see below.
-\end{tabular}
-\caption{Supported \pf{powerdot} commands in \LyX}\label{tab:lyxcommands}
-\end{table}
-Table \ref{tab:lyxenvs} lists the \pf{powerdot} environments that,
-besides the earlier discussed |slide|, |wideslide|, |note| and
-|emptyslide| environments, are supported in \LyX.
-\begin{table}[htb]
-\centering
-\begin{tabular}{f}
-Environment & Method in \LyX\\\hline
-\texttt{itemize} & Use \texttt{Itemize} and \texttt{ItemizeType1}
-environments. The latter will create a list with |type=1| (see
-section~\ref{sec:lists}).\\
-\texttt{enumerate} & Use \texttt{Enumerate} and
-\texttt{EnumerateType1} environments.\\
-\texttt{thebibliography} & Use \texttt{Bibliography} environment.
-\end{tabular}
-\caption{Supported \pf{powerdot} environments in \LyX}\label{tab:lyxenvs}
-\end{table}
-Table \ref{tab:lyxERT} lists commands that can only be done by using
-an ERT box (via \texttt{Insert\LyXarrow TeX}).
-\begin{table}[ht]
-\centering
-\begin{tabular}{f}
-Command & Method in \LyX\\\hline
-\cs{and} & Within \texttt{Author} environment.\\
-\cs{pause} & \\
-\cs{item} & An ERT box is only required for the optional argument,
-not mandatory for overlays specifications.\\
-\cs{onslide} & And the versions \cs{onslide+} and \cs{onslide*}.\\
-\cs{twocolumn} & \\
-\cs{tableofcontents} & Only when using the optional argument.
-\end{tabular}
-\caption{\pf{powerdot} commands needing an ERT box in \LyX}\label{tab:lyxERT}
-\end{table}
-Note that you may use the clipboard in order to repeat often used
-commands like |\pause|. Finally, table \ref{tab:lyxadd} lists
-additional commands and environments that are supported by the layout.
-\begin{table}[htb]
-\centering
-\begin{tabular}{f}
-Env./Command & Method in \LyX\\\hline
-\texttt{quote} & Use \texttt{Quote} environment.\\
-\texttt{quotation} & Use \texttt{Quotation} environment.\\
-\texttt{verse} & Use \texttt{Verse} environment.\\
-\cs{caption} & Use \texttt{Caption} environment within standard
-float environments.
-\end{tabular}
-\caption{Additional environments for \LyX}\label{tab:lyxadd}
-\end{table}
-
-\subsection{Compiling with \LyX}
-First of all, make sure that you have also read
-section~\ref{sec:compiling}. Then, in order to get a proper
-PostScript or PDF file, you have to set your \LyX\ document
-properties depending on which paper and orientation you want. When
-your \LyX\ document is open, go to the \texttt{Layout\LyXarrow
-Document} dialog. In the \texttt{Layout} pane, put the |nopsheader|,
-|orient| and |paper| keys as class options (see
-section~\ref{sec:classopts} for a description). Then, go to the
-|Paper| pane and select corresponding paper size and orientation
-(you may choose |letter| paper in the case you set |paper=screen| in
-the class options). Finally, go to the |View| (or
-\texttt{File\LyXarrow Export}) menu and select your output
-(PostScript or PDF).
-
-\subsection{Extending the layout}
-If you have created a custom style (see section~\ref{sec:writestyle})
-which defines custom templates, you may want to extend the layout
-file\footnote{The LPPL dictates to rename a file if you modify it as
-to avoid confusion.} so that these templates are also supported in
-\LyX. The explanation below assumes that you have defined a template
-called |sunnyslide|.
-
-To support this new template in \LyX, you have to use the following
-command.
-\begin{command}
- `\cs{pddefinelyxtemplate}\meta{cs}\marg{template}'
-\end{command}
-\DescribeMacro{\pddefinelyxtemplate}
-This will define the control sequence \meta{cs} such that it will
-create a slide with template \meta{template} (which has been defined
-using |\pddefinetemplate|. This new control sequence can be used in
-the layout file as follows.
-\begin{example}
- # SunnySlide environment definition
- Style SunnySlide
- CopyStyle Slide
- LatexName lyxend\lyxsunnyslide
- Font
- Color Yellow
- EndFont
- Preamble
- \pddefinelyxtemplate\lyxsunnyslide{sunnyslide}
- EndPreamble
- End
-\end{example}
-Note that you must begin the |LatexName| field with |lyxend|. The
-definition of the \LyX\ template has been inserted in between
-|Preamble| and |EndPreamble| which assures that the new \LyX\
-environment will work in every presentation. After modifying the
-layout file, don't forget to restart \LyX. See for more information
-about creating \LyX\ environments, the documentation of \LyX\ in the
-|Help| menu.
-
-\section{Questions}\label{sec:questions}
-\subsection{Frequently Asked Questions}\label{sec:FAQ}
-This section is devoted to Frequently Asked Questions. Please read
-it carefully; your problem might be solved by this section.
-\begin{itemize}[leftmargin=0pt]
-\question
-Does \pf{powerdot} have example files? Where can I find them?
-\answer
-\pf{powerdot} comes with several examples that should be in the doc
-tree of your \LaTeX\ installation. More precisely:
-\url{texmf/doc/latex/powerdot}. If you can't find them there,
-download them from \url{CTAN:/macros/latex/contrib/powerdot}
-\cite{CTAN}.
-\question I'm getting errors or unexpected output when compiling
-the simplest example!
-\answer Did you read section~\ref{sec:compiling}?
-\question I made a typo in the slide code, ran the file, got an
-error, corrected the typo and reran, but now get an error that
-doesn't go away.
-\answer Remove the |.bm| and |.toc| files and try again.
-\question |\pause| does not work in the |align|\footnote{There are
-several environments doing similar things as \texttt{align}. Another
-example is the \texttt{split} environment, but more (often from the
-\pf{amsmath} package) can cause similar trouble for \cs{pause}.}
-environment.
-\answer |align| does several tricky things, which make it impossible
-to use |\pause|. Use |\onslide| instead. See
-section~\ref{sec:onslide}.
-\question My \pf{pstricks} nodes appear on all overlays. Also: color
-doesn't seem to work with |\onslide|.
-\answer Some PostScript tricks like nodes and color do not work with
-|\onslide|. Use |\onslide*| instead. See an example below.
-\begin{example}
- \documentclass{powerdot}
- \usepackage{pst-node}
- \begin{document}
- \begin{slide}{Color}
- \onslide*{2}{\cnode(0,-5pt){2pt}{A}}
- This is {\onslide*{2-}{\color{red}} red} text.
- \onslide*{2}{\cnode(0,-5pt){2pt}{B}}
- \onslide{2}{\ncline{A}{B}}
- \end{slide}
- \end{document}
-\end{example}
-\question Do I need to edit style files to change a style a bit?
-\answer No, you do not need to edit any style file. You can change
-any part of a certain style using the |\pddefinetemplate| and
-|\pddefinepalettes| commands. Here is an example that removes the
-left and right footers from the \pf{default} style, places the slide
-number in the center footer and adds another palette.
-\begin{example}
- \documentclass{powerdot}
- \pddefinetemplate[slide]{slide}{
- lfpos=,rfpos=,cftemp=\theslide
- }{}
- \pddefinepalettes{mypalette}{
- \definecolor{pdcolor1}{rgb}{.27,.31,.44}
- \definecolor{pdcolor2}{rgb}{.85,.85,.92}
- \definecolor{pdcolor3}{rgb}{.8,.75,.98}
- }
- \pdsetup{palette=mypalette}
- \begin{document}
- \begin{slide}{Title}
- \end{slide}
- \end{document}
-\end{example}
-See section~\ref{sec:writestyle} for more information about these
-two commands.
-\question Can I contribute to this project?
-\answer
-Certainly. If you find bugs\footnote{Make sure that you confirm that
-the bug is really caused by \pf{powerdot} and not by another package
-that you use.} or typos, please send a message to the mailinglist
-(see section~\ref{sec:mailinglist}). If you have developed your own
-style that is distinct from existing styles and would like to see it
-included in \pf{powerdot}, please inform us by private e-mail and we
-will consider your contribution. Notice that included contributions
-will fall under the overall \pf{powerdot} license and copyright
-notice, but that your name will be included in the documentation
-when you make a contribution. This is done to guarantee that we can
-adapt files if maintenance is needed.
-\end{itemize}
-
-If your question has not been answered at this point, advance to the
-next section to read where to find more answers.
-
-\subsection{Mailinglist}\label{sec:mailinglist}
-\pf{powerdot} has a mailinglist from \url{freelists.org} and has its
-website here:
-\begin{center}
-\url{http://www.freelists.org/list/powerdot}
-\end{center}
-There is a link to `List Archive'. Please search this archive before
-posting a question. Your problem might already have been solved in
-the past.
-
-If that is not the case, use the box on the page to type your e-mail
-address, choose the action `Subscribe' and click `Go!'. Then follow
-the instructions that arrive to you by e-mail. At a certain moment,
-you can login for the first time using an authorization code sent to
-you by e-mail. After logging in, you can create a password for
-future sessions using the `Main Menu' button. The other buttons
-provide you some info and options for your account.
-
-When you are all set, you can write to the list by sending an e-mail
-to
-\begin{center}
-\url{powerdot [at] freelists [dot] org}
-\end{center}
-
-When writing to the list, please keep in mind the following very
-important issues.
-\begin{enumerate}[leftmargin=0pt,itemsep=0pt,parsep=0pt]
-\item We are volunteers!
-\item Keep your questions related to \pf{powerdot}.
-\item Always supply a \emph{minimal} example demonstrating your
-problem.
-\item Don't send big files over the list.
-\end{enumerate}
-
-We hope you will enjoy this service.
-
-\section{Source code documentation}\label{sec:source}
-In case you want regenerate the package files from the source or
-want to have a look at the source code description, locate
-|powerdot.dtx|, search in the file for |\OnlyDescription| and remove
-that and do
-\begin{example}
- latex powerdot.tex
- latex powerdot.tex
- bibtex powerdot
- makeindex -s gglo.ist -o powerdot.gls powerdot.glo
- makeindex -s gind.ist -o powerdot.ind powerdot.idx
- latex powerdot.tex
- latex powerdot.tex
-\end{example}
-
-
-\section{Implementation}\label{sec:imple}
-\subsection{General construction}
-This section explains the general idea of the class, how paper
-dimensions are chosen and how slides are created. We start with the
-paper.
-
-This class uses the same idea as \pf{prosper} and \pf{HA-prosper},
-namely that we create a background with \pf{pstricks} and position
-text on it using |\rput| and some |minipage| environments. This is
-easier than writing a dedicated output routine that can handle all
-the material, but doesn't break pages when we don't want that. So,
-when starting to write the class, we first investigated how to deal
-with landscape slides and paper dimensions.
-
-The job of making landscape slides can be done using \pf{geometry}.
-The paper dimension was more of a problem. As \LaTeX\ doesn't have
-the huge fonts that we need for presentations, we need to scale the
-usual fonts somehow. This could be done by using unusual paper
-dimensions (as \pf{beamer} does) and hence relying on ps2pdf to cut
-off all the redundant material. But this doesn't produce a usable
-DVI or PS file. Instead, it was chosen to use DVI magnification. The
-entire slide is magnified by a factor of 2 and only the top left
-quarter of the paper is used (but you will never notice that due to
-the magnification). As we already decided to place all material in
-|minipage|s using |\rput|, we didn't need the page anymore and it
-was easiest to use \pf{geometry} to just remove the page margins
-altogether so that the bottom left corner would be |(0,0)| and the
-top right corner |(\slidewidth,\slideheight)|.
-
-One extra remark on the paper type is necessary. We found that most
-common configurations of dvips use the |A4size| code when A4
-dimensions are found. This code doesn't write an explicit PostScript
-paper command in the PS document and hence programs using this PS
-(like ps2pdf) don't know what paper to use and revert to the
-default, which is letter paper in most cases. This, of course, is
-something that we don't want and hence, \pf{powerdot} will write
-these commands to the PS itself as to guarantee proper post
-processing of the PS.
-
-Now that we made the decisions on how to create proper DVI, PS and
-PDF output, the next task was to create an easy interface to
-overlays. To avoid counting the overlays as is necessary with
-\pf{prosper}, we implemented a system that first collects the entire
-body of an environment in a macro which can be reused multiple
-times. During execution of the body, the overlay commands like
-|\onslide| will keep a record of the biggest number that they find
-and that is the number of overlays to produce. Getting the body of
-the environment is done by collecting all material up to the next
-|\end| occurrence. If that control sequence has the proper argument
-(namely the slide that we started with), then we stop scanning and
-start processing the slide. With normal use, you will not notice
-this, but when doing special tricks like hiding |\end{slide}| in a
-macro, the process will fail as it relies on finding |\end{slide}|
-in the input stream without doing expansions. Often a work around
-can be found though. Have a look for instance at how |\section|
-creates a slide.
-
-The next task was to provide a simple way to create templates. As
-the class is based on the idea of having a background with some
-material spread out over it, the template system follows this idea.
-One argument can be used to create the background, the other
-argument controls, via keys and options, several properties of the
-material that should be placed. By adding an |ifsetup| key, full
-control could be gained over the design of the template in every
-possible setup chosen by the user.
-
-The final task for the class was to fill in all the `details'. All
-the mechanisms were present, but sometimes they should not be
-active. For instance, overlays should not be created in handout
-mode. Other things to add to the class were counter protection on
-overlays, handles to the layout of the slide number, footnotes, a
-bibliography environment, empty slides, etcetera.
-
-We hope that this section has made clear a little bit what you will
-be seeing when reading the next section with coding and why we chose
-to do it this way.
-
-\bibliographystyle{plain}
-\bibliography{powerdot}
-
-\section*{Acknowledgements}
-The authors are grateful to Mael Hill\'ereau for contributing the
-\LyX\ layout file and description. Further, we like to thank all
-style contributors (see section~\ref{sec:styles}). Moreover, we wish
-to thank everyone who contributed to this package in any other
-way.\\[1em]
-\hspace*{\stretch{1}}
-\begin{minipage}{.9\linewidth}
-Ramon van den Akker, Pavel \v C\'i\v zek, Darren Dale, Hans Marius
-Eikseth, Morten H\o gholm, Andr\'as Horv\'ath, Laurent Jacques, Akira
-Kakuto, Uwe Kern, Kyanh, Theo Stewart, Don P. Story and Herbert Vo\ss.
-\end{minipage}
-\hspace*{\stretch{1}}\\[1em]
-We hope not to have forgotten anyone.
-
-\PrintChangesX\PrintIndexX
-
-\end{document}
-