diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex | 386 |
1 files changed, 386 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex new file mode 100644 index 00000000000..aa220ff6a84 --- /dev/null +++ b/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex @@ -0,0 +1,386 @@ +% $Header: /cvsroot/latex-beamer/latex-beamer/doc/beamerug-workflow.tex,v 1.10 2004/12/09 22:31:18 tantau Exp $ + +% Copyright 2003, 2004 by Till Tantau <tantau@users.sourceforge.net>. +% +% This program can be redistributed and/or modified under the terms +% of the GNU Public License, version 2. + +\section{Workflow For Creating a Beamer Presentation} + +\label{section-workflow} + +This section presents a possible workflow for creating a \beamer\ +presentation and possibly a handout to go along with it. Technical +questions are addressed, like which programs to call with +which parameters. + + + +\subsection{Step One: Setup the Files} + +\beamernote +It is advisable that you create a folder for each +presentation. Even though your presentation will usually reside in a +single file, \TeX\ produces so many extra files that things can easily +get very confusing otherwise. The folder's name should ideally start +with the date of your talk in ISO format (like 2003-12-25 for a +Christmas talk), followed by some reminder text of what the talk is +all about. Putting the date at the front in this format causes your +presentation folders to be listed nicely when you have several of them +residing in one directory. If you use an extra directory for each +presentation, you can call your main file |main.tex|. + +To create an initial |main.tex| file for your talk, copy an +existing file from the |beamer/solutions| directory and adapt it to +your needs. A list of possible \beamer\ solutions that contain +templates for presentation \TeX-files can be found below. + +If you wish your talk to reside in the same file as some different, +non-presentation article version of your text, it is advisable to +setup a more elaborate file scheme. See +Section~\ref{section-article-version-workflow} for details. + +\lyxnote +You can either open a new file and then select |beamer| as the +document class or you say ``New from template'' and then use a +template from the directory |beamer/solutions|. + + + + +\subsection{Step Two: Structure Your Presentation} + +The next step is to fill the presentation file with |\section| and +|\subsection| to create a preliminary outline. You'll find some hints +on how to create a good outline in +Section~\ref{section-structure-guidelines}. + +Put |\section| and |\subsection| commands into +the (more or less empty) main file. Do not create any frames until you +have a first working version of a possible table of contents. +The file might look like this: + +\begin{verbatim} +\documentclass{beamer} +%% This is the file main.tex + +\usetheme{Berlin} + +\title{Example Presentation Created with the Beamer Package} +\author{Till Tantau} +\date{\today} + +\begin{document} + +\begin{frame} + \titlepage +\end{frame} + + +\section*{Outline} +\begin{frame} + \tableofcontents +\end{frame} + +\section{Introduction} +\subsection{Overview of the Beamer Class} +\subsection{Overview of Similar Classes} + +\section{Usage} +\subsection{...} +\subsection{...} + +\section{Examples} +\subsection{...} +\subsection{...} + +\begin{frame} +\end{frame} % to enforce entries in the table of contents + +\end{document} +\end{verbatim} + +The empty frame at the end (which should be deleted later) ensures +that the sections and subsections are actually part of the table of +contents. This frame is necessary since a |\section| or |\subsection| +command following the last page of a document has no effect. + + + +\subsection{Step Three: Creating a PDF or PostScript File} + +\beamernote +Once a first version of the structure is finished, you should try to +create a first PDF or PostScript file of your (still empty) talk to +ensure that everything is working properly. This file +will only contain the title page and the table of contents. +\lyxnote +Use ``View'' to check whether the presentation compiles fine. Note +that you must put the table of contents inside a frame, but that the +title page is created automatically. + + +\subsubsection{Creating PDF} + +\beamernote +To create a |PDF| version of this file, run the program +|pdflatex| on |main.tex| at least twice. Your need to run it twice, so +that \TeX\ can create the table of contents. (It may even be necessary +to run it more often since all sorts of auxiliary files are +created.) In the following example, the greater-than-sign is the prompt. + +\begin{verbatim} +> pdflatex main.tex + ... lots of output ... +> pdflatex main.tex + ... lots of output ... +\end{verbatim} + +You can next use a program like the Acrobat Reader or |xpdf| +to view the resulting presentation. + +\begin{verbatim} +> acroread main.pdf +\end{verbatim} + + +\lyxnote +Choose ``View pdf'' to view your presentation. + + +\subsubsection{Creating PostScript} +\label{section-postscript} + +\beamernote +To create a PostScript version, you should first ascertain that the +\textsc{hyperref} package (which is automatically loaded by the +\beamer\ class) uses the option |dvips| or some compatible +option, see the documentation of the \textsc{hyperref} package for +details. Whether this is the case depends on the contents of your +local |hyperref.cfg| file. You can enforce the usage of this +option by passing |dvips| or a compatible option to the +\beamer\ class (write |\documentclass[dvips]{beamer}|), which +will pass this option on to the \textsc{hyperref} package. + +You can then run |latex| twice, followed by |dvips|. + +\begin{verbatim} +> latex main.tex + ... lots of output ... +> latex main.tex + ... lots of output ... +> dvips -P pdf main.dvi +\end{verbatim} + +The option (|-P pdf|) tells |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. + +You can convert a PostScript file to a pdf file using + +\begin{verbatim} +> ps2pdf main.ps main.pdf +\end{verbatim} + +\lyxnote +Use ``View Postscript'' to view the PostScript version. + + + + +\subsubsection{Ways of Improving Compilation Speed} +\label{section-speedup} + +While working on your presentation, it may sometimes be useful to +\TeX\ your |.tex| file quickly and have the presentation contain only +the most important information. This is especially true if you have a +slow machine. In this case, you can do several things to speedup the +compilation. First, you can use the |draft| class option. + +\begin{classoption}{draft} + Causes the headlines, footlines, and sidebars to be replaced by + gray rectangles (their sizes are still computed, though). Many + other packages, including |pgf| and |hyperref|, also ``speedup'' + when this option is given. +\end{classoption} + +Second, you can use the following command: + +\begin{command}{{\includeonlyframes}\marg{frame label list}} + This command behaves a little bit like the |\includeonly| command: + Only the frames mentioned in the list are included. All other frames + are suppressed. Nevertheless, the section and subsection commands + are still executed, so that you still have the correct navigation + bars. By labeling the current frame as, say, |current| and then + saying |\includeonlyframes{current}|, you can work on a single frame + quickly. + + The \meta{frame label list} is a comma-separated list (without + spaces) of the names of frames that have been labeled. To label a + frame, you must pass the option |label=|\meta{name} to the |\frame| + command or |frame| environment. + + \example +\begin{verbatim} +\includeonlyframes{example1,example3} + +\frame[label=example1] +{This frame will be included. } + +\frame[label=example2] +{This frame will not be included. } + +\frame{This frame will not be included.} + +\againframe{example1} % Will be included +\end{verbatim} +\end{command} + + + +\subsection{Step Four: Create Frames} + +Once the table of contents looks satisfactory, start creating frames +for your presentation by adding |frame| environments. You'll find +guidelines on what to put on a frame in +Section~\ref{section-frame-guidelines}. + +\lyxnote +To create a frame, use the style ``BeginFrame''. The frame title +is given on the line of this style. The frame ends automatically with +the start of the next frame, with a section or subsection command, and +with an empty line in the style ``EndFrame''. Note that the last frame +of your presentation must be ended using ``EndFrame'' and that the +last frame before the appendix must be ended this way. + + + + + +\subsection{Step Five: Test Your Presentation} + +\emph{Always} test your presentation. For this, you should +vocalize or subvocalize your talk in a quiet environment. Typically, +this will show that your talk is too long. You should then remove +parts of the presentation, such that it fits into the allotted time +slot. Do \emph{not} attempt to talk faster in order to squeeze the +talk into the given amount of time. You are almost sure to loose your +audience this way. + +Do not try to create the ``perfect'' presentation immediately. Rather, +test and retest the talk and modify it as needed. + + + + +\subsection{Step Six: Create a Handout} + +\subsubsection{Creating the Handout} + +Once your talk is fixed, you can create a handout, if this seems +appropriate. For this, you can use the class option |handout| as +explained in Section~\ref{handout}. Typically, you might wish +to put several handout slides on one page, see below on how to do +this easily. + +You may also wish to create an article version of your talk. An +``article version'' of your presentation is a normal \TeX\ text +typeset using, for example, the document class |article| or perhaps +|llncs| or a similar document class. The \beamer\ class offers +facilities to have this version coexist with your presentation version +in one file and to share code. Also, you can include slides of your +presentation as figures in your article version. Details on how to +setup the article version can be found in +Section~\ref{section-article}. + +\lyxnote +Creating an article version is not really possible in \LyX. You +can \emph{try}, but I would not advise it. + + +\subsubsection{Printing the Handout} +\label{section-printing-version} + +The easiest way to print a presentation is to user the Acrobat Reader +with the option ``expand small pages to paper size'' form the printer +dialog enabled. This is necessary, because slides are only 128mm times +96mm. + +For the PostScript version and for printing multiple slides on a +single page this simple approach does not work. In such cases you can +use the |pgfpages| package, which works directly both with |pdflatex| +and |latex| plus |dvips|. Note however \emph{that this package + destroys hyperlinks}. This is due to fundamental flaws in the +\pdf-specification and not likely to change. + +The |pgfpages| can do all sorts of tricks with pages. The most +important one for printing \beamer\ slides is the following command: + +\begin{verbatim} +\usepackage{pgfpages} +\pgfpagelayout{resize}[a4paper,border shrink=5mm,landscape] +\end{verbatim} + +This says ``Resize all pages to landscape A4 pages, no what their +original size was, but shrink the pages by 5mm, so that there is a bit +of a border around everything.'' Naturally, instead of |a4paper| you +can also use |letterpaper| or any of the other standard paper +sizes. For further options and details see the documentation of +|pgfpages|. + +The second thing you might wish to do is to put several slides on a +single page. This can be done as follows: + +\begin{verbatim} +\usepackage{pgfpages} +\pgfpagelayout{2 on 1}[a4paper,border shrink=5mm] +\end{verbatim} + +This says ``Put two pages on one page and then resize everything so +that it fits on A4 paper.'' Note that this time we do not need +landscape as the resulting page is, after all, not in landscape mode. + +Instead of |2 on 1| you can also use |4 on 1|, but then with +|landscape| once more, and also |8 on 1| and even |16 on 1| to get a +grand (though unreadable) overview. + +If you put several slides on one page and if these slides normally +have a white background, it may be useful to write the following in +your preamble: + +\begin{verbatim} +\mode<handout>{\setbeamercolor{background canvas}{bg=black!5}} +\end{verbatim} + +This will cause the slides of the handout version to have a very +light gray background. This makes it easy to discern the slides' +border if several slides are put on one 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 |-m 1cm| to the options of +%% |psnup|. + +%% To put two or four slides on one page, use |-2|, respectively +%% |-4| instead of |-1| as the first parameter for +%% |psnup|. In this case, you may wish to add the option +%% |-b 1cm| to add a bit of space around the individual slides. The same +%% trick as for the \pdf-version can be used to make the borders of +%% slides more pronounced in the handout version. + + + |