summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex')
-rw-r--r--Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex308
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: