diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex | 308 |
1 files changed, 308 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex new file mode 100644 index 00000000000..a8cd3595ca5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex @@ -0,0 +1,308 @@ +% $Header: /cvsroot/latex-beamer/latex-beamer/doc/beamerug-compatibility.tex,v 1.11 2005/05/09 12:41:15 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. + +\subsection{Compatibility with Other Packages and Classes} + +When using certain packages or classes together with the |beamer| +class, extra options or precautions may be necessary. + +\begin{package}{{AlDraTex}} + Graphics created using AlDraTex must be treated like verbatim + text. The reason is that DraTex fiddles with catcodes and spaces + much like verbatim does. So, in order to insert a picture, either + add the |fragile| option to the frame or use the + |\defverbatim| command to create a box containing the picture. +\end{package} + +\begin{package}{{alltt}} + Text in an |alltt| environment must be treated like verbatim + text. So add the |fragile| option to frames containing this + environment or use |\defverbatim|. +\end{package} + +\begin{package}{{amsthm}} + This package is automatically loaded since \beamer\ uses it for + typesetting theorems. If you do not wish it to be loaded, which can + be necessary especially in |article| mode if the package is + incompatible with the document class, you can use the class option + |noamsthm| to suppress its loading. See + Section~\ref{section-theorems} for more details. +\end{package} + +\begin{package}{{babel}|[|\declare{|french|}|]|} + When using the |french| style, certain features that clash with the + functionality of the \beamer\ class will be turned off. For example, + enumerations are still produced the way the theme dictates, not the + way the |french| style does. +\end{package} + +\begin{package}{{babel}|[|\declare{|spanish|}|]|} + \beamernote + When using the |spanish| style, certain features that clash with the + functionality of the \beamer\ class will be turned off. In particular, + the special behaviour of the pointed brackets |<| and |>| is + deactivated. + + \articlenote + To make the characters |<| and |>| active in |article| mode, pass + the option |activeospeccharacters| to the package + |beamerbasearticle|. This will lead to + problems with overlay specifications. +\end{package} + +\begin{package}{{color}} + \beamernote + The |color| package is automatically loaded by |beamer.cls|. This + makes it impossible to pass options to |color| in the preamble of + your document in the normal manner. To pass a \meta{list of options} + to |color|, you can use the following class option: + + \begin{classoption}{color={\normalfont\meta{list of options}}} + Causes the \meta{list of options} to be passed on to the |color| + package. If the \meta{list of options} contains more than one + option you must enclose it in curly brackets. + \end{classoption} + + \articlenote + The |color| package is not loaded automatically if + |beamerarticle| is loaded with the |noxcolor| option. +\end{package} + +\begin{package}{{colortbl}} + \beamernote + With newer versions of |xcolor.sty|, you need to pass the option + |table| to |xcolor.sty| if you wish to use |colortbl|. See the notes + on |xcolor| below, on how to do this. +\end{package} + +\begin{package}{{CJK}} + \beamernote + When using the |CJK| package for using Asian fonts, you must use the + class option \declare{|CJK|}. See |beamerexample4.tex| for an + example. +\end{package} + +\begin{package}{{deluxetable}} + \beamernote + The caption generation facilities of |deluxetable| are + deactivated. Instead, the caption template is used. +\end{package} + +\begin{package}{{DraTex}} + See |AlDraTex|. +\end{package} + +\begin{package}{{enumerate}} + \articlenote + This package is loaded automatically in the |presentation| modes, but not + in the |article| mode. If you use its features, you have to load the + package ``by hand'' in the |article| mode. +\end{package} + +\begin{class}{{foils}} + If you wish to emulate the |foils| class using \beamer, please see + Section~\ref{section-foiltex}. +\end{class} + +\begin{package}{{fontenc}|[|\declare{|T1|}|]|} + Use this option only with fonts that have outline fonts available in + the T1 encoding like Times or the |lmodern| fonts. In a standard + installation the standard Computer Modern fonts (the fonts Donald + Knuth originally designed and which are used by default) are + \emph{not} available in the T1 encoding. Using this option with + them will result in very poor rendering of your presentation when + viewed with \pdf\ viewer applications like Acrobat or |xpdf|. To use + the Computer Modern fonts with the T1 encoding, use the package + |lmodern|. See also Section~\ref{section-font-encoding}. +\end{package} + +\begin{package}{{fourier}} + The package switches to a T1~encoding, but it does not redefine all + fonts such that outline fonts (non-bitmapped fonts) are used by + default. For example, the sans-serif text and the typewriter text + are not replaced. To use outline fonts for these, write + |\usepackage{lmodern}| \emph{before} including the |fourier| + package. +\end{package} + +\begin{package}{{HA-prosper}} + You cannot use this package with \beamer. However, you might try to + use the package |beamerprosper| instead, see + Section~\ref{section-prosper}. +\end{package} + +\begin{package}{{hyperref}} + \beamernote + The |hyperref| package is automatically loaded by |beamer.cls| and + certain options are setup. In order pass additional options to + |hyperref| or to override options, you can use the following class + option: + + \begin{classoption}{hyperref={\normalfont\meta{list of options}}} + Causes the \meta{list of options} to be passed on to the |hyperref| + package. + + \example |\documentclass[hyperref={bookmarks=false}]{beamer}| + \end{classoption} + + Alternatively, you can also use the |\hypersetup| command. + + \articlenote + In the |article| version, you must include |hyperref| manually if + you want to use it. It is not included automatically. +\end{package} + +\begin{package}{{inputenc}|[|\declare{|utf8|}|]|} + \beamernote + When using Unicode, you may wish to use one of the following class + options: + \begin{classoption}{ucs} + Loads the package |ucs| and passes the correct Unicode options to + |hyperref|. Also, it preloads the Unicode code pages zero and + one. + \end{classoption} + + \begin{classoption}{utf8} + Same as the option |ucs|, but also sets the input encoding to + |utf8|. You could also use the option |ucs| and say + |\usepackage[utf8]{inputenc}| in the preamble. + \end{classoption} + + If you use a Unicode character outside the first two code pages + (which includes the Latin alphabet and the extended Latin alphabet) + in a section or subsection heading, you have to use the command + |\PreloadUnicodePage{|\meta{code page}|}| to give |ucs| a chance to + preload these code pages. You will know that a character has not + been preloaded, if you get a message like ``Please insert into + preamble.'' The code page of a character is given by the unicode + number of the character divided by 256. +\end{package} + +\begin{package}{{listings}} + \beamernote + Note that you must treat |lstlisting| environments exactly the same + way as you would treat |verbatim| environments. When using + |\defverbatim| that contains a colored |lstlisting|, use the + |colored| option of |\defverbatim|. +\end{package} + +\begin{package}{{msc}} + \beamernote + Since this packages uses |pstricks| internally, everything that + applies to pstricks also applies to |msc|. +\end{package} + +\begin{package}{{musixtex}} + When using MusiX\TeX\ to typeset musical scores, your document must + be compiled with |pdfelatex| or |elatex| instead of |pdflatex| or + |latex|. + + Inside a |music| environment, the |\pause| is redefined to match + MusiX\TeX's definition (a rest during one quarter of a whole). You can + use the |\beamerpause| command to create overlays in this + environment. +\end{package} + +\begin{package}{{pdfpages}} + Commands like |\includepdf| only work \emph{outside} frames as they + produce pages ``by themselves.'' You may also wish to say +\begin{verbatim} +\setbeamercolor{background canvas}{bg=} +\end{verbatim} + when you use such a command since the background (even a white + background) will otherwise be printed over the image you try to include. + + \example +\begin{verbatim} +\begin{document} +\begin{frame} + \titlepage +\end{frame} + +{ + \setbeamercolor{background canvas}{bg=} + \includepdf{somepdfimages.pdf} +} + +\begin{frame} + A normal frame. +\end{frame} +\end{document} +\end{verbatim} +\end{package} + +\begin{package}{{\normalfont\meta{professional font package}}} + \beamernote + If you use a professional font package, \beamer's internal + redefinition of how variables are typeset may interfere with the + font package's superior way of typesetting them. In this case, you + should use the class option |professionalfont| to suppress any font + substitution. See Section~\ref{section-substition} for details. +\end{package} + +\begin{class}{{prosper}} + If you wish to (partly) emulate the |prosper| class using \beamer, + please see Section~\ref{section-prosper}. +\end{class} + +\begin{package}{{pstricks}} + You should add the option |xcolor=pst| to make |xcolor| aware of the + fact that you are using |pstricks|. +\end{package} + +\begin{class}{{seminar}} + If you wish to emulate the |seminar| class using \beamer, please see + Section~\ref{section-seminar}. +\end{class} + +\begin{package}{{texpower}} + You cannot use this package with \beamer. However, you might try to + use the package |beamertexpower| instead, see + Section~\ref{section-texpower}. +\end{package} + +\begin{package}{{textpos}} + \beamernote + \beamer\ automatically installs a white background behind + everything, unless you install a different background + template. Because of this, you must use the |overlay| option when + using |textpos|, so that it will place boxes \emph{before} + everything. Alternatively, you can install an empty background + template, but this may result in an incorrect display in certain + situtations with older versions of the Acrobat Reader. +\end{package} + +\begin{package}{{ucs}} + See |\usepackage[utf8]{inputenc}|. +\end{package} + + +\begin{package}{{xcolor}} + \beamernote + The |xcolor| package is automatically loaded by |beamer.cls|. The + same applies as to |color|. + + \begin{classoption}{xcolor={\normalfont\meta{list of options}}} + Causes the \meta{list of options} to be passed on to the |xcolor| + package. + \end{classoption} + + When using \beamer\ together with the |pstricks| package, be sure to + pass the |xcolor=pst| option to \beamer\ (and hence to |xcolor|). + + \articlenote + The |color| package is not loaded automatically if + |beamerarticle| is loaded with the |noxcolor| option. +\end{package} + + + + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: "beameruserguide" +%%% End: |