summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/powerdot
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-01-08 00:45:56 +0000
committerKarl Berry <karl@freefriends.org>2011-01-08 00:45:56 +0000
commitabd5bdf3fcf83a33374db38d5d1851e59eab3796 (patch)
tree6e115938b4e06d98b73f6f29c86d6053d85480ae /Master/texmf-dist/doc/latex/powerdot
parent0c064f70cbb4e75660441c4d0da7b0374beb4537 (diff)
powerdot (6jan11)
git-svn-id: svn://tug.org/texlive/trunk@20970 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/powerdot')
-rw-r--r--Master/texmf-dist/doc/latex/powerdot/README4
-rwxr-xr-xMaster/texmf-dist/doc/latex/powerdot/RunSlideDoc25
-rw-r--r--Master/texmf-dist/doc/latex/powerdot/powerdot.bib9
-rw-r--r--Master/texmf-dist/doc/latex/powerdot/powerdot.pdfbin533164 -> 544353 bytes
-rw-r--r--Master/texmf-dist/doc/latex/powerdot/powerdot.tex97
5 files changed, 101 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/latex/powerdot/README b/Master/texmf-dist/doc/latex/powerdot/README
index ef1214af8d1..aba6aa31a17 100644
--- a/Master/texmf-dist/doc/latex/powerdot/README
+++ b/Master/texmf-dist/doc/latex/powerdot/README
@@ -1,4 +1,4 @@
-powerdot v1.4d
+powerdot v1.4e
--------------
powerdot is a presentation class for LaTeX that allows for the quick
@@ -33,7 +33,7 @@ powerdot into your LaTeX distribution
License
-------
-Copyright (C) 2005-2010 Hendri Adriaens and Christopher Ellison
+Copyright (C) 2005-2011 Hendri Adriaens and Christopher Ellison
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
diff --git a/Master/texmf-dist/doc/latex/powerdot/RunSlideDoc b/Master/texmf-dist/doc/latex/powerdot/RunSlideDoc
new file mode 100755
index 00000000000..c7bfd8db135
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/powerdot/RunSlideDoc
@@ -0,0 +1,25 @@
+#!/bin/bash
+# To generate style examples, do
+# (after extracting powerdot-styleexample.tex):
+# Do this for all available styles (replace `default' by any
+# other style name) to generate .001 and .002 files which
+# will be included by the documentation.
+
+latex powerdotSlide.tex
+latex powerdotSlide.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
+dvips powerdotSlide.dvi
+ps2pdf powerdotSlide.ps
+
+rm *.aux *.log *.i?? *.g?? *.toc *.dvi *.blg *.ps *.bm *.bbl
+rm powerdot-styleexample-*
+
+
+# If you also want to generate the source code documentation,
+# remove \OnlyDescription from the preamble of powerdot.dtx
+# prior to compiling the source.
+#
diff --git a/Master/texmf-dist/doc/latex/powerdot/powerdot.bib b/Master/texmf-dist/doc/latex/powerdot/powerdot.bib
index c62cec7a975..c32474f8672 100644
--- a/Master/texmf-dist/doc/latex/powerdot/powerdot.bib
+++ b/Master/texmf-dist/doc/latex/powerdot/powerdot.bib
@@ -50,7 +50,7 @@
@MISC{PSTricksWeb,
author = {Herbert Vo\ss},
title = {\pf{PSTricks} website},
- howpublished = {\url{http://pstricks.tug.org}}
+ howpublished = {\url{http://tug.org/pstricks/}}
}
@MISC{xkeyval,
@@ -130,6 +130,13 @@
title = {{\LyX\ website}},
howpublished = {\url{http://www.lyx.org}}
}
+
+@MISC{javascript,
+ author = {Adobe Solutions Network},
+ title = {{Acrobat JavaScript Scripting Reference}},
+ howpublished = {\url{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/AcroJS.pdf}}
+}
+
\endinput
%%
%% End of file `powerdot.bib'.
diff --git a/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf b/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf
index 8ddfc20bbf4..a7de4d5ca11 100644
--- a/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf
+++ b/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/powerdot/powerdot.tex b/Master/texmf-dist/doc/latex/powerdot/powerdot.tex
index 7b1a02bee08..ac398e67f0c 100644
--- a/Master/texmf-dist/doc/latex/powerdot/powerdot.tex
+++ b/Master/texmf-dist/doc/latex/powerdot/powerdot.tex
@@ -2,7 +2,8 @@
%% Copyright (C) 2005-2010 Hendri Adriaens and Christopher Ellison
%% ---------------------------------------------------------------
%%
-%% Version 1.4d prepared by Herbert Voss
+%% Version 1.4e 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
@@ -21,7 +22,7 @@
\usepackage{xcolor}
\usepackage{enumitem}
\usepackage{graphicx}
-\usepackage{pst-char}
+\usepackage{pst-text}
\usepackage{listings}
\usepackage{array}
\usepackage{xkeyval}
@@ -164,8 +165,8 @@
}{\textbf{No example files found for style \pf{#1}.}}%
}
-\def\fileversion{v1.4b}
-\def\filedate{2010/10/07}
+\def\fileversion{v1.4e}
+\def\filedate{2010/12/18}
\changes{v1.0}{2005/09/04}{Initial release}
\changes{v1.1}{2005/09/19}{Fixed some small bugs}
@@ -203,16 +204,27 @@
\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 }{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}{2012/12/03}{fixed missleading comment header of powerdot.cls (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)}
+
+
+
+
\begin{document}
@@ -344,12 +356,14 @@ 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\option{nopagebreaks}\\
+\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}
@@ -435,15 +449,16 @@ 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{blackslide}\option{blackslide}\\
-This option inserts a black slide in the presentation on page 1 and
+\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
-black slide when clicked. When you click anywhere in the black
+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.
+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.
@@ -457,8 +472,8 @@ Here is an example of a |\documentclass| command.
mode=present,
display=slidesnotes,
style=tycja,
- nopagebreaks,
- blackslide,
+ nohandoutpagebreaks,
+ pauseslide,
fleqn
]{powerdot}
\end{example}
@@ -471,13 +486,13 @@ slide, normal size 12 points and flushed left equations.
mode=handout,
display=slidesnotes,
style=tycja,
- nopagebreaks,
- blackslide,
+ 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 |nopagebreaks|
+possibly more than two slides per page due to the |nohandoutpagebreaks|
option.
\subsection{Setup options}\label{sec:pdsetup}
@@ -540,6 +555,27 @@ See for more information on controlling the layout of lists the
\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}
@@ -651,7 +687,7 @@ 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.
+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,
@@ -668,7 +704,7 @@ Here are two examples for the use of random dots.
randomdots,dminwidth=.2\slidewidth
}
\end{example}
-This turns on random dots and doesn't use the left 20\ of the slide
+This turns on random dots and doesn't use the left 20\% of the slide
for placing random dots.
\begin{example}
\pdsetup{
@@ -1265,7 +1301,7 @@ using BiB\TeX\ or not):\\
\begin{slide}{Slide}
\cite{someone}
\end{slide}
- \begin{slide}{References}
+\begin{slide}{References}
\begin{thebibliography}{1}
\bibitem{someone} Article of someone.
\end{thebibliography}
@@ -1826,7 +1862,7 @@ template.
Make sure you choose a \emph{proper} name for the template, and
avoid redefining existing templates or environments. \pf{powerdot}
-defines |blackslide|, |note| and |emptyslide| internally, so you
+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
@@ -1964,7 +2000,7 @@ documentation for more information.
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
+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}
@@ -2644,16 +2680,15 @@ 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.dtx
- latex powerdot.dtx
+ 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.dtx
- latex powerdot.dtx
+ latex powerdot.tex
+ latex powerdot.tex
\end{example}
-\StopEventually{}
\section{Implementation}\label{sec:imple}
\subsection{General construction}