summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/beamer/doc/beamerug-installation.tex
blob: 9c75b37c3f3a37bff3908157dcc8bee89957ca58 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
% Copyright 2007 by Till Tantau
%
% This file may be distributed and/or modified
%
% 1. under the LaTeX Project Public License and/or
% 2. under the GNU Free Documentation License.
%
% See the file doc/licenses/LICENSE for more details.

% $Header: /cvsroot/latex-beamer/latex-beamer/doc/beamerug-installation.tex,v 1.12 2007/01/28 20:48:21 tantau Exp $

\section{Installation}

\label{section-installation}

There are different ways of installing the \beamer\ class, depending
on your installation and needs. When installing the class, you may
need to install some other packages as well as described below. Before
installing, you may wish to review the licenses under
which the class is distributed, see Section~\ref{section-license}.

Fortunately, most likely your system will already have \beamer\
preinstalled, so you can skip this section.


\subsection{Versions and Dependencies}

This documentation is part of version \version\ of the \beamer\
class. \beamer\ needs a reasonably recent version of several standard
packages to run and also the following versions of two special
packages (later versions should work, but not necessarily): 
\begin{itemize}
\item
  |pgf.sty| version \pgfversion,
\item
  |xcolor.sty| version \xcolorversion.
\end{itemize}

If you use |pdflatex| or |lyx|, which are optional, you need
\begin{itemize}
\item
  |lyx| version 1.3.3. Other versions might work.
\item
  |pdflatex| version 0.14 or higher. Earlier versions do not work. 
\end{itemize}



\subsection{Installation of Prebundled Packages}

I do not create or manage prebundled packages of \beamer, but,
fortunately, nice other people do. I cannot give detailed instructions
on how to install these packages, since I do not manage them, but I
\emph{can} tell you were to find them and I can tell you what these
nice people told me on how to install them. If you have a problem with
installing, you might wish to have a look at the Debian page or MikTeX
page first.


\subsubsection{Debian}

The command ``|aptitude install latex-beamer|'' should do the
trick. If necessary, the packages |pgf| and |latex-xcolor| will be
automatically installed. Sit back and relax. In detail, the following
packages are installed: 
\begin{verbatim}
http://packages.debian.org/latex-beamer
http://packages.debian.org/pgf
http://packages.debian.org/latex-xcolor
\end{verbatim}


\subsubsection{MiKTeX}

For MiK\TeX, use the update wizard to install the (latest versions of
the) packages called |latex-beamer|, |pgf|, and |xcolor|. 




\subsection{Installation in a texmf Tree}

If, for whatever reason, you do not wish to use a prebundled package,
the ``right'' way to install \beamer\ is to put it in a so-called
|texmf| tree. In the following, I explain how to do this.

Obtain the latest source version (ending |.tar.gz| or |.zip|) of the \beamer\
package from
\begin{verbatim}
http://sourceforge.net/projects/latex-beamer/
\end{verbatim}
(most likely, you have already done this). Next, you also need the
\textsc{pgf} package and the \textsc{xcolor} packages, 
which you need to install separately (see their installation
instructions). 

The package contains a bunch of files; |beamer.cls| is one of
these files and happens to be the most important one. You now need to
put these files in an appropriate |texmf| tree. 

When you ask \TeX\ to use a certain class or package, it usually looks
for the necessary files in so-called |texmf| trees. These trees
are simply huge directories that contain these files. By default,
\TeX\ looks for files in three different |texmf| trees:
\begin{itemize}
\item
  The root |texmf| tree, which is usually located at
  |/usr/share/texmf/|, |c:\texmf\|, or\\
  |c:\Program Files\TeXLive\texmf\|.
\item
  The local  |texmf| tree, which is usually located at
  |/usr/local/share/texmf/|, |c:\localtexmf\|, or\\
  |c:\Program Files\TeXLive\texmf-local\|.
\item
  Your personal  |texmf| tree, which is usually located in your home
  directory at |~/texmf/| or |~/Library/texmf/|.   
\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 |texmf| directory you have chosen, create
the sub-sub-sub-directory
\begin{verbatim}
texmf/tex/latex/beamer 
\end{verbatim} 
and place all files of the package in this directory.

Finally, you need to rebuild \TeX's filename database. This done by
running the command  |texhash| or |mktexlsr| (they are
the same). In MiK\TeX, there is a menu option to do this.

\lyxnote
For usage of the \beamer\ class with \LyX, you have to do all of the
above. You also have to make \LyX\ aware of the file
|beamer.layout|. This file is \emph{not part of the beamer package}
since it is updated and managed by the \LyX\ development team. This
means that in reasonbaly up-to-date \LyX\ versions this file will
already be installed and nothing needs to be done. 

\vskip1em
For a more detailed explanation of the standard installation process
of packages, you might wish to consult
\href{http://www.ctan.org/installationadvice/}{|http://www.ctan.org/installationadvice/|}.
However, note that the \beamer\ package does not come with a
|.ins| file (simply skip that part).




\subsection{Updating the Installation}

To update your installation from a previous version, simply replace
everything in the directory
\begin{verbatim}
texmf/tex/latex/beamer
\end{verbatim}
with the files of the new version. The easiest way to do this is to
first delete the old version and then proceed as described above.


\subsection{Testing the Installation}

To test your installation, copy the file
|generic-ornate-15min-45min.en.tex| from the directory
\begin{verbatim}
beamer/solutions/generic-talks
\end{verbatim}
to some place where you usually
create presentations. Then run the command |pdflatex| several times on
the file and check whether the resulting \textsc{pdf} file looks
correct. If so, you are all set. 

\lyxnote
To test the \LyX\ installation, create a new file from the
template |generic-ornate-15min-45min.en.lyx|, which is located in the directory
|beamer/solutions/generic-talks|.


\input{beamerug-compatibility}

%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "beameruserguide"
%%% End: