diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/texpower/fulldemo.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/texpower/fulldemo.tex | 164 |
1 files changed, 58 insertions, 106 deletions
diff --git a/Master/texmf-dist/doc/latex/texpower/fulldemo.tex b/Master/texmf-dist/doc/latex/texpower/fulldemo.tex index fac601aa535..a599c3fcc34 100644 --- a/Master/texmf-dist/doc/latex/texpower/fulldemo.tex +++ b/Master/texmf-dist/doc/latex/texpower/fulldemo.tex @@ -4,7 +4,7 @@ %% %% The original source files were: %% -%% texpower-doc.dtx (with options: `fulldemo') +%% texpower-doc.dtx (with options: `version,fulldemo') %% texpower-doc.dtx (with options: `picexample-src') %% texpower-doc.dtx (with options: `tabexample-src') %% texpower-doc.dtx (with options: `mathexample-src') @@ -17,6 +17,7 @@ %% -------------------------------------------------------------- %% TeXPower bundle - dynamic online presentations with LaTeX %% Copyright (C) 1999-2004 Stephan Lehmke +%% Copyright (C) 2003-2005 Hans Fredrik Nordhaug %% %% This program is free software; you can redistribute it and/or %% modify it under the terms of the GNU General Public License @@ -33,50 +34,10 @@ %% given in the file `00readme.txt'. %% \ProvidesFile{fulldemo.tex}% - [2004/07/27 TeXPower full demo and manual] -%----------------------------------------------------------------------------------------------------------------- -% File: fulldemo.tex -% -% Demo & Manual for the package texpower.sty (pre-alpha release). -% -% This file can be compiled with pdfLaTeX or (standard) LaTeX. When using standard LaTeX, the dvi file produced should -% be processed with -% -% dvips -Ppdf fulldemo -% -% afterwards processing the resulting ps file with -% -% distill fulldemo.ps -% -% (The syntax is for a unix system with tetex 1.0 and distiller 3. Modify appropriately for other configurations.) -% -% The resulting pdf file is meant for presenting `interactively' with Adobe Acrobat Reader. -% -%----------------------------------------------------------------------------------------------------------------- -% Autor: Stephan Lehmke <Stephan.Lehmke@cs.uni-dortmund.de> -% -% v0.0.1 Oct 26, 1999: seven examples completed; parts of inline documentation -% -% v0.0.2 Feb 18, 2000: inline documentation of examples completed -% -% v0.0.3 Mar 1, 2000: added examples for \pause and page transitions; Documentation section started -% -% v0.0.4 Mar 10, 2000: Documentation for the first pre-alpha release completed -% -% v0.0.5 Mar 20, 2000: Documentation split into several files to reduce compilation problems; tested with pdflatex -% -% v0.0.6 May 2, 2000: Some small changes in preparation of the update to TeXpower v0.0.7. -% -% v0.0.7 May 24, 2000: Some small changes in preparation of the update to TeXpower v0.0.8. -% -% v0.0.8 Aug 29, 2000: Added backgroundstyle command for the update to TeXpower v0.0.9. -% - - -%----------------------------------------------------------------------------------------------------------------- + [2005/04/07 TeXPower full demo and manual] -% Version info -\def\tpversion{v0.0.9d of May 15, 2003 (alpha)} +% Version info used in titles +\def\tpversion{v0.2 of April 8, 2005} % Enable all color emphasis and highlighting options; use a light background and slifonts. @@ -102,6 +63,7 @@ {% Yes. % PsTricks is used for creating the picture example. + \usepackage[noxcolor]{pstricks} \usepackage{pstcol} \usepackage{pst-node} @@ -181,12 +143,12 @@ \newslide \minisec{Disclaimer} - This is a \emph{alpha} release of the \TeX Power bundle. + This is still work inprogress. During the subsequent error correction and extension of the functionality, the syntax and implementation of the macros described here are liable to change. - The transformation to the dtx format is also not completed. + Even though we are using dtx-files, these are still not fully documented dtx-files. \newslide @@ -272,13 +234,9 @@ % \newcommand{\tabend}{\\\hline}% - \stepwise - {% - \hrule height 0pt\relax% This is neccessary to avoid a glitch in vertical spacing. Don't ask me why. I'll try to get - % this right until the first alpha version. + \liststepwise{% \begin{center} - \step - {% + \step{% \begin{tabular}{|l|l|l|} \hline They can & be built & line by line% @@ -323,7 +281,7 @@ % frame is reduced. \setlength{\highlightboxsep}{1pt}% % - \begin{align} + \begin{align*} \lefteqn {% \min @@ -451,7 +409,7 @@ \right) \right) } - \end{align} + \end{align*} }% \newslide % @@ -772,44 +730,11 @@ Instead of displaying incrementally, we can just `flip through' some items by hi \addtocontents{toc}{\protect\clearpage} -% -%----------------------------------------------------------------------------------------------------------------- -% -% Documentation of the TeXPower bundle. -% -% Autor: Stephan Lehmke <Stephan.Lehmke@cs.uni-dortmund.de> -% -% v0.0.1 Mar 20, 2000: First version for the pre-alpha release of TeXPower. -% -% v0.0.2 Mar 29, 2000: Added `usage and basic options' section. -% -% v0.0.3 Apr 04, 2000: Added `Color Emphasis and Highlighting' section. -% -% v0.0.4 Apr 12, 2000: A lot of small additions in preparation of the update to TeXpower v0.0.7. -% -% v0.0.5 May 31, 2000: Updated for TeXpower v0.0.8. -% -% v0.0.6 Jun 09, 2000: Some updates for TeXpower v0.0.8b. -% -% v0.0.6a Jun 13, 2000: Some updates for TeXpower v0.0.8c. -% -% v0.0.6b Jun 23, 2000: Some updates for TeXpower v0.0.8e. -% -% v0.0.6c Jul 25, 2000: Some updates for TeXpower v0.0.8g. Colors section rewritten for new color management kernel. -% -% v0.0.7 May 15, 2003: Added index and updates for TeXpower v0.0.9d. -% -% v0.0.8 July 27, 2004: Added the "Miscellaneous commands" section. Moved the tpslifonts doc into tpslifonts.dtx. -% -%----------------------------------------------------------------------------------------------------------------- -% -\def\docversion{v0.0.8 of July 27, 2004} -\def\tpversion{v0.1b of July 27, 2004} \makeslidetitle {% Documentation% - \thanks{Documentation \docversion\ for \TeX Power \tpversion\ (alpha).}% + \thanks{Documentation for \TeX Power \tpversion .}% }% The \TeX Power bundle contains style and class files for creating dynamic online presentations with \LaTeX. @@ -841,9 +766,6 @@ The other, more sophisticated examples demonstrate the expressive power of the \code{texpower} package. Look at the commented code of these examples to find out how to achieve special effects and create your own presentation effects with \TeX Power. -For the first \emph{alpha} release, this documentation will be completed. For the first \emph{beta} release, when the -code is a little more stable, the \code{texpower} package will be made into a properly documented \code{.dtx} file. - \newslide %----------------------------------------------------------------------------------------------------------------- @@ -904,11 +826,22 @@ This way, not only `visible' page contents will be duplicated, but also some `in side effects. For instance, a \macroname{section} command creates a whatsit for writing the table of contents entry. Duplicating this -whatsit will also duplicate the toc entry. +whatsit will also duplicate the toc entry. So, whatsit items effecting file access are inhibited when duplicating page +material. \newslide -So, whatsit items effecting file access are inhibited when duplicating page material. +The current version of \code{texpower} is a little smarter when handling whatsits. Some commands (related to writing to +files and hyperlinks) are made stepwise-aware. This means that links can point to the actual subpage where the +anchor is and not to the last (sub)page of an incremental page. However, if you want the old behaviour just use +\begin{description} +\item[\present{option: \code{oldfiltering}}]\indexpckopt{texpower}{oldfiltering} switches on the old + (pre 0.2) very aggressive/robust filtering of whatsits. +\end{description} +The \code{oldfiltering} can be turned on and off inside the document using \macroname{oldfilteringon/off}. This command is +useful if \code{texpower} isn't smart enough... + +\newslide A second type of whatsits is created by \TeX's \macroname{special} command which is used for instance for color management. Some drivers, like \code{dvips} and \code{textures}, use a color stack which is controlled by @@ -991,6 +924,10 @@ There are some boolean registers provided and set automatically by \code{texpowe \subsection{Miscellaneous commands}\label{Sec:MiscCmd} Some important commands that don't fit in the latter sections: \begin{description} +\item[\present{\macroname{oldfilteringon}}]\indexmacro{oldfilteringon} + reverts to the old (pre v0.2) aggressive/robust filtering of whatsits. +\item[\present{\macroname{oldfilteringoff}}]\indexmacro{oldfilteringoff} + turns on the new better treatment of whatsits. \item[\present{\commandapp{currentpagevalue}{\carg{value}}}]\indexmacro{currentpagevalue} sets how to find the number of the current page, \commandapp{value}{page} is default. Used to name the hyper target on the first subpage of every page. Also used in the @@ -1003,6 +940,17 @@ Some important commands that don't fit in the latter sections: \newslide +\subsection{Page Anchors}\label{Sec:PageAnch} + +For each physical page \TeX Power (when in display mode) makes a number of subpages - this is +the dynamics. For convenience \TeX Power defines an anchor to the first subpage of physical page n, +\code{firstpage.n}\indexcode{firstpage.n}. The standard page anchor for physical page n, +\code{page.n}\indexcode{page.n}, points to the last subpage of physical page n. If you want to +link to any other subpage just insert a \macroname{hyperlink} in the standard way assuming you haven't +turned on the old filtering (\ref{Sec:Dupl}). + +\newslide + \subsection{Dependencies on other packages} \code{textpower} always loads the packages \code{ifthen} and \code{calc}, as the extended command syntax provided by these is indispensable for the macros to work. They are in the \code{base} and \code{tools} area of the \LaTeX{} @@ -1043,8 +991,8 @@ The following packages are neccessary for certain features of \code{texpower}: \subsection{What else is part of the \TeX Power bundle?} Besides the package \code{texpower} (which is described here), there are four more packages, \code{tpslifonts}, \code{fixseminar}, \code{automata} and -\code{tplists}, and one document class, -\code{powersem}, in the \TeX Power bundle which so far have no documentation +\code{tplists}, and one document class, \code{powersem}, in the \TeX Power bundle. +Except for \code{tpslifonts} and \code{tplists} these files have no documentation of their own. They will be described in this section until they are turned into \code{dtx} files producing their own documentation. @@ -1161,7 +1109,7 @@ automata are supported so far. \minisec{The package \code{tplists}}\indexfile{tplists}{package} Experimental package providing easy dynamic lists. Currently there are stepped, flipped and dimmed versions of itemize and enumerate (and corresponding lists from the \code{eqlist} and \code{paralist} package). For more information -and an example read the start of the file \code{tplists.sty}. +and an example, compile (and then read) the file \code{tplists.dtx}. \newslide @@ -1260,8 +1208,8 @@ and an example read the start of the file \code{tplists.sty}. \emph{completely} into \carg{contents}, where \macroname{step} can be used freely (see \nameref{Sec:Ex}). \item As \carg{contents} is read as a macro argument, constructs involving \concept{catcode} changes (like - \macroname{verb} or language switches) won't work in \carg{contents}. Using a suggestion by \name{Ross - Moore}, I hope to remedy this until the \emph{alpha} release. + \macroname{verb} or language switches) won't work in \carg{contents} \textbf{unless} you use the + \code{fragilesteps} environment (\ref{Sec:fragilesteps}). \newslide @@ -1285,13 +1233,19 @@ and an example read the start of the file \code{tplists.sty}. Commands accessing toc files and such (like \macroname{section}) are taken care of by the whatsit suppression mechanism (compare section \ref{Sec:Dupl}). + \end{enumerate} - Labels and hyperlinks work sort of (giving a lot of warnings though). + \newslide - I will try to remedy remaining problems until the first \emph{alpha} release. - \end{enumerate} + \subsection{\code{fragilesteps} environment}\label{Sec:fragilesteps}% - \newslide + The \code{fragilesteps}\indexcode{fragilesteps} environment is a wrapper around \macroname{stepwise} + that makes it possible to use verbatim. The code for this environment is based on similar code from beamer - an + excellent presentation class written by Till Tantau - thanks! Using the \code{fragilesteps} environment + enables the use of the \code{listings} package to display code line by line. There are some examples in + \code{verbexample.tex}. + + \newslide \subsection{\macroname{boxedsteps} and \macroname{nonboxedsteps}}\label{Sec:boxedsteps}% By default, \carg{stepcontents} belonging to a \macroname{step} which is not yet `active' are ignored altogether. This @@ -1338,10 +1292,8 @@ and an example read the start of the file \code{tplists.sty}. \subsection{Custom versions of \macroname{stepwise}}% Sometimes, it might happen that vertical spacing is different on every page of a sequence generated by - \macroname{stepwise}, making lines `wobble'. - - This is caused by interactions between different ways vertical spacing is added to the page. Hopefully, problems - caused this way can be reduced until the first \emph{alpha} release. + \macroname{stepwise}, making lines `wobble'. This is usually fixed if you use \macroname{liststepwise} or + \macroname{parstepwise} (described below) in stead of \macroname{stepwise}. \newslide |