Anonymous avatar Anonymous committed a1bdef9

Added \pictureframe and added better installation instructions.

Comments (0)

Files changed (8)

-Till Tantau <tantau@cs.tu-berlin.de>
+Till Tantau <tantau@users.sourceforge.net>
+2003-10-16 Till Tantau <tantau@cs.tu-berlin.de>
+
+	Version 0.83:
+	- Wrote a better installation procedure.
+
 2003-10-13 Till Tantau <tantau@cs.tu-berlin.de>
 
 	Version 0.82:
 1. Installing the beamer class:
 ------------------------------------------------------------
 
-Put beamer.cls, *.sty, and beamericon* in a directory pointed to by 
-the TEXINPUTS variable. If you have not specified the TEXINPUT
-variable, specify something like ".:" or ".:/home/tex:". Do not forget
-to place a colon at the end (corresponding to an empty path), which
-will include all standard directories.
+For the impatient: 
 
-Alternatively, put the files in a texmf tree, for example at
-texmf/tex/latex/macros/contrib/beamer and run mktexlsr. 
+Put beamer.cls, *.sty, and beamericon* somewhere where TeX can find
+them. Also install the pgf latex package somewhere where TeX can find
+it. 
 
-You will also need the pgf package. 
 
-You can test whether your installation works, by trying to run pdflatex
-on the file beamerexample.tex.
+Long version:
+
+In the user's guide, which you find in the file
+doc/beameruserguide.pdf, you will find a detailed explanation on how
+to install the beamer class.
 
 
 ------------------------------------------------------------
 ------------------------------------------------------------
 
 The beamer class is free software. It is distributed under the LaTeX
-Project Public License, Version 1.2,
-see http://www.ctan.org/tex-archive/macros/latex/base/lppl.txt.
+Project Public License, Version 1.2, 
+see http://www.ctan.org/tex-archive/macros/latex/base/lppl.txt, and
+under the GPL.
 
 
 ------------------------------------------------------------
 3. Bugs, suggestions, contact with the authors
 ------------------------------------------------------------
 
-Currently, please report bugs, suggestions, or new themes to 
-Till Tantau <tantau@cs.tu-berlin.de>. 
+Go to http://sourceforge.net/projects/latex-beamer/ to submit bug
+reports, request new features, etc.
 
 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
 \ProvidesClass{beamer}
-[2003/10/01 v0.8 Class for Typesetting a Beamer Presentation]
+[2003/10/01 v0.83 Class for Typesetting a Beamer Presentation]
 
 % Copyright 2003 by Till Tantau <tantau@cs.tu-berlin.de>.
 %
 
 \newcounter{subsectionslide}[subsection]
 \renewcommand\thesubsectionslide{\@arabic\c@subsectionslide}
+\def\beamer@entrycode{}
+\def\beamer@exitcode{}
 
 \newenvironment{frameslide}[1][1]{%
   {\let\@elt\@restorecounter\@overlaycounterresets}
   \ifnum\serialnumber=1\relax%
   \refstepcounter{subsectionslide}%
   \addtocontents{head}{\protect\headcommand{\protect\slideentry{\thesection}{\thesubsection}{\thesubsectionslide}{\thepage}{\lastsubsection}}}%
-  \fi\vspace*{-\baselineskip}\vfill}%
-  {\vskip0pt plus 1.5fill\clearpage}
+  \fi\beamer@entrycode\vspace*{-\baselineskip}\vfill}%
+  {\beamer@exitcode\vskip0pt plus 1.5fill\clearpage}
 
 \def\frametitle#1{%
   \vskip0pt plus -1fill%
   \setbox\tempbox\vbox\bgroup\leavevmode\afterassignment\@checknoslide\let\@next}
 \def\@checknoslide{%
   \ifcat\bgroup\noexpand\@next%
-  \let\@do\relax%
+  \let\@do\beamer@reseteecodes%
   \else\let\@do\@singletoken\fi%
   \@do}
 
   \dowhat%
   \if@anotherslide
   \advance\@serialnumber by 1\relax
-  \repeat}
+  \repeat\beamer@reseteecodes}
 
 \def\dosingleframe{\begin{frameslide}[1]\bgroup\aftergroup\@endslide\afterassignment\@checkslide\let\@next}
 \def\@checkslide{%
   \let\@do\relax%
   \else\let\@do\@singletoken\fi%
   \@do}
-\def\@endslide{\end{frameslide}}
-\def\@singletoken{\@next\egroup}
+\def\@endslide{\end{frameslide}\beamer@reseteecodes}
+\def\@singletoken{\@next\egroup\beamer@reseteecodes}
 
+\def\beamer@reseteecodes{\gdef\beamer@entrycode{}\gdef\beamer@exitcode{}\pagestyle{navigation}\thispagestyle{navigation}}
+
+\def\pictureframe{%
+  \def\beamer@entrycode{\vspace*{-\headheight}}%
+  \def\beamer@exitcode{\vspace*{-\footheight}\thispagestyle{empty}}\frame}
 
 % Sets dowhat to doif, if \serialnumber is in the specified
 % interval. Example: 5-7,-3,9,11,13- would mean pages
   \let\@evenfoot\@oddfoot}
 \pagestyle{navigation}
 
+%
+% Patch empty page style, so that transitions and navigation still works
+%
+\def\ps@empty{%
+  \let\@mkboth\@gobbletwo%
+  \def\@oddhead{\hyper@pagetransition\hyper@pageduration}
+  \def\@oddfoot{\hypertarget{Navigation\thepage}{}\hfil}
+  \let\@evenhead\@oddhead\let\@evenfoot\@oddfoot}
+
 \long\def\usebackgroundtemplate#1{%
   \def\@backgroundtemplate{#1}}
 
 \def\recalculatefoot{%
     \setbox\tempbox=\hbox{\@foottemplate}%
-    \postemp=\ht\tempbox%
-    \advance\postemp by \dp\tempbox%
-    \advance\postemp by 4pt%
-    \geometry{foot=\the\postemp}}
+    \footheight=\ht\tempbox%
+    \advance\footheight by \dp\tempbox%
+    \advance\footheight by 4pt%
+    \geometry{foot=\the\footheight}}
 \def\recalculatehead{%
   \setbox\tempbox=\hbox{\@headtemplate}%
   \headheight=\ht\tempbox%
 \newdimen\vboxoffset
 \newdimen\postemp
 \newdimen\headheight
+\newdimen\footheight
 
 \def\slideentry#1#2#3#4#5{%
   %section number, subsection number, slide number, page number

Binary file modified.

doc/beamerexample.tex

 % of the LaTeX Project Public License Distributed from CTAN
 % archives in directory macros/latex/base/lppl.txt.
 
-\usepackage{beamerthemebars,beamertemplates}
+\usepackage{beamerthemesplit,beamertemplates}
 \usepackage[english]{babel}
 \usepackage{pgf,pgfarrows,pgfnodes,pgfautomata,pgfheaps,pgfshade}
 \usepackage{amsmath,amssymb}
Add a comment to this file

doc/beameruserguide.pdf

Binary file modified.

doc/beameruserguide.tex

 
 \begin{document}
 
-\title{User's Guide to the Beamer Class, Version 0.81}
+\title{User's Guide to the Beamer Class, Version 0.83\\
+\Large\href{http://latex-beamer.sourceforge.net}{\texttt{http://latex-beamer.sourceforge.net}}}
 \author{Till Tantau\\
-  \texttt{tantau@cs.tu-berlin.de}}
+  \href{mailto:tantau@users.sourceforge.net}{\texttt{tantau@users.sourceforge.net}}}
 
 \maketitle
 
 
 \section{Introduction}
 
+
+\subsection{Overview}
+
 This user's guide explains the functionality of the \beamer\ class.
 It is a \LaTeX\ class that allows you to create a beamer
 presentation. It can also be used to create slides. It behaves
 
 
 
+\subsection{Getting Started: Installation}
+
+To use the beamer class, you just need to put the files of the
+\beamer\ package in a directory that is read by \TeX. To uninstall the
+class, simply remove these files once more. The same is true of the
+\textsc{pgf} package, which you will also need.
+
+
+Unfortunately, there are different ways of making \TeX\ ``aware'' of
+the files in the \beamer\ package. Which way you should choose depends
+on how permanently you intend to use the class.
+
+
+\subsubsection{Installing Debian and Red Hat Packages}
+
+Currently, there are no out-of-the-box Debian or Red Hat packages of
+the beamer class available.
+
+
+
+\subsubsection{Temporary Installation}
+
+If you only wish to install the beamer class for a quick appraisal, do
+the following: Obtain the latest source version (ending
+\texttt{.tar.gz}) of the \beamer\ package from 
+\href{http://sourceforge.net/projects/latex-beamer/}{\texttt{http://sourceforge.net/projects/latex-beamer/}}
+(most likely, you have already done this). Next, you also need the
+\textsc{pgf} package, which can be found, for example, at 
+\href{http://www.ctan.org/tex-archive/graphics/pgf/}{\texttt{http://www.ctan.org/tex-archive/graphics/pgf/}}.
+
+In both cases, the packages contain a bunch of files (for the \beamer\
+class, \texttt{beamer.cls} is one of these files and happens to be the
+most important one, for the \textsc{pgf} package \texttt{pgf.sty} is
+the most important file). 
+Place all files in two directories. For example,
+\texttt{/home/tantau/beamer/} and \texttt{/home/tantau/pgf/} would
+work fine for me. Then setup the environment variable called
+\texttt{TEXINPUTS} to be the following string (how exactly this is
+done  depends on your operating system and shell):
+
+\begin{verbatim}
+.:/home/tantau/beamer:/home/tantau/pgf:
+\end{verbatim}
+
+Naturally, if the \texttt{TEXINPUTS} variable is already defined
+differently, you should \emph{add} the two directories to the list. Do
+not forget to place a colon at the end (corresponding to an empty
+path), which will include all standard directories.
+
+
+
+\subsubsection{Installation in a texmf Tree}
+
+For a more permanent installation, you can place the files of the
+\beamer\ package and of the \textsc{pgf} package (see the previous
+subsection on how to obtain them) in an appropriate \texttt{texmf}
+tree. 
+
+When you ask \TeX\ to use a certain class or package, it usually looks
+for the necessary files in so-called \texttt{texmf} trees. These trees
+are simply huge directories that contain these files. By default,
+\TeX\ looks for files in three different \texttt{texmf} trees:
+\begin{itemize}
+\item
+  The root \texttt{texmf} tree, which is usually located at
+  \texttt{/usr/share/}, \verb!c:\texmf\!, or\\
+  \verb!c:\Program Files\TeXLive\texmf\!.
+\item
+  The local  \texttt{texmf} tree, which is usually located at
+  \texttt{/usr/local/share/}, \verb!c:\localtexmf\!, or\\
+  \verb!c:\Program Files\TeXLive\texmf-local\!.
+\item
+  Your personal  \texttt{texmf} tree, which is located in your home
+  directory.   
+\end{itemize}
+
+You should install the packages either in the local tree or in
+your personal tree, depending on whether you have write access to the
+local tree. Installation in the root tree can cause problems, since an
+update of the whole \TeX\ installation will replace this whole tree.
+
+Inside whatever \texttt{texmf} directory you have chosen, create
+the sub-sub-sub-directories
+\begin{itemize}
+\item
+  \texttt{texmf/tex/latex/beamer} and
+\item
+  \texttt{texmf/tex/latex/pgf}
+\end{itemize}
+and place all files in these two directories.
+
+Finally, you need to rebuild \TeX's filename database. This done by
+running the command  \texttt{texhash} or \texttt{mktexlsr} (they are
+the same). In MikTeX, there is a menu option to do this.
+
+\vskip1em
+For a more detailed explanation of the standard installation process
+of packages, you might wish to consult
+\href{http://www.ctan.org/installationadvice/}{\texttt{http://www.ctan.org/installationadvice/}}.
+However, note that the \beamer\ package does not come with a
+\texttt{.ins} file (simply skip that part).
+
+
+
+\subsection{Testing the Installation}
+
+To test your installation, copy the file \texttt{beamerexample.tex}
+from the documentation subdirectory to some place where you usually
+create presentations. Then run the command \texttt{pdflatex} twice on
+the file and check whether the resulting \texttt{beamerexample.pdf}
+looks correct. If so, you are all set.
+
+
 
 \section{Workflow}
 
 
 
 
-%\subsubsection{Creating PostScript}
-%\label{section-postscript}
-
-%To create a PostScript version of this file, you first need to run
-%\verb!latex! twice, then run \verb!dvips!. 
-
-%\begin{verbatim}
-%> latex main.tex
-%    ... lots of output ...
-%> latex main.tex
-%    ... lots of output ...
-%> dvips -P pdf -T 128mm,96mm main.dvi
-%\end{verbatim}
-
-%The first of the two options (\verb!-P pdf!) tells \verb!dvips! to use
-%Type~1 outline fonts instead of the usual Type~3 bitmap fonts. You may
-%wish to omit this option if there is a problem with it. The second
-%option (\verb!-T 128mm,96mm!) tells  \verb!dvips! that each slide is
-%128mm by 96mm. If you do not specify this option, the slide will be
-%``kind of lost'' on a big blank page.
-
-%If you wish each slide to completely fill a letter-sized page, use the
-%following commands instead:
-
-%\begin{verbatim}
-%> dvips -P pdf -tletter main.dvi -o main.temp.ps
-%> psnup -1 -W128mm -H96mm -pletter main.temp.ps main.ps
-%\end{verbatim}
-
-%For A4-sized paper, use:
-
-%\begin{verbatim}
-%> dvips -P pdf -ta4 main.dvi -o main.temp.ps
-%> psnup -1 -W128mm -H96mm -pa4 main.temp.ps main.ps
-%\end{verbatim}
-
-%In order to create a white margin around the whole page (which is sometimes
-%useful for printing), add the option \verb!-m 1cm! to the options of
-%\verb!psnup!. 
-
-%To put two or four slides on one page, use \verb!-2!, respectively
-%\verb!-4! instead of \verb!-1! as the first parameter for
-%\verb!psnup!. In this case, you may wish to add the option
-%\verb!-b 1cm! to add a bit of space around the individual slides.
-
-%You can convert a PostScript file to a pdf file using
-
-%\begin{verbatim}
-%> ps2pdf main.ps main.pdf
-%\end{verbatim}
-
-
-
 \subsubsection{Creating PostScript}
 \label{section-postscript}
 
 contents of the frame. All of this text that is not tagged by overlay
 specifications is shown on all slides of the frame. 
 
+\Command{frame}
+\Parameters{
+\item
+  optional parameter in square brackets: a specification of slides to
+  be shown, see subsection \ref{subsection-restriction} for details. 
+\item
+  the frame's contents.
+}
+\Example
+\begin{verbatim}
+\frame
+{
+  Some text...
+
+  Some more...
+}
+\end{verbatim}
+
+\Command{pictureframe}
+\Parameters{
+\item
+  optional parameter in square brackets: a specification of slides to
+  be shown, see subsection \ref{subsection-restriction} for details. 
+\item
+  the frame's contents.
+}
+\Description{
+  This command creates a frame that can be used to show a big picture
+  that completely fills the frame. All head and foot lines will be
+  suppressed. 
+  }
+\Example
+\begin{verbatim}
+\pgfdeclareimage{bigimage}{}{9.6cm}{bigimagefilename}
+\pictureframe{\hfill\pgfuseimage{bigimage}\hfill}
+\end{verbatim}
+
+
 
 
 \subsection{Frame Titles}
 
 
 \subsection{Restricting the Slides of a Frame}
+\label{subsection-restriction}
 
 As mentioned above, the number of slides in a frame is automatically
 calculated. If the largest number mentioned in any
   (highest intensity). 
   }
 
+\ClassOption{bigger}
+\Description{
+  Makes all fonts a little bigger, which makes the text more
+  readable. The downside is that less fits onto each frame.
+  }
+
+\ClassOption{smaller}
+\Description{
+  Makes all fonts a little smaller, which allows you to fit more onto
+  frames. Normally, this is not a good idea.
+  }
+
 \ClassOption{sans}
 \Description{
   Use a sans-serif font during the presentation. (Default.)
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.