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
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
|
% \begin{macrocode}
\documentclass[color,table,nolot,nolof]{fithesis3}
\usepackage[english]{babel}
\usepackage{hologo}
\usepackage{fancyvrb}
\usepackage{minted}
\usepackage{ltxcmds}
\usepackage{tabularx}
\usepackage[
backend=biber,
style=numeric,
citestyle=numeric-comp,
sorting=none,
sortlocale=auto
]{biblatex}
\addbibresource{guide.bib}
\usepackage[os=win]{menukeys}
\makeatletter
\thesissetup{
title=A fibeamer user guide for the \thesis@english@facultyName,
TeXtitle=A \textit{fibeamer} user guide\medskip\\\Large for the
\thesis@english@facultyName,
type=bc,
department=Department of Computer Graphics and Design,
programme=Applied Informatics,
field=Typesetting,
titleEn=\thesis@title,
departmentEn=\thesis@department,
programmeEn=\thesis@programme,
fieldEn=\thesis@field,
author=Vít Novotný,
advisor={Doc.\ RNDr.\ Petr Sojka, Ph.D.},
assignment={},
abstract={\textsf{Fibeamer} is a theme for the \textsf{beamer}
\LaTeX{} document class and is intended to be used for the
preparation of thesis defense presentations across the
faculties of the \thesis@english@universityName. This document
describes the installation of the \textsf{fibeamer} theme, its
configuration, and its use.},
keywords={thesis, typesetting, LaTeX},
TeXkeywords={thesis, typesetting, \LaTeX{}},
keywordsEn=\thesis@keywords,
TeXkeywordsEn=\thesis@TeXkeywords,
abstractEn=\thesis@abstract,
faculty=\jobname,
autoLayout=false}
\makeatother
\begin{document}
\makeatletter\thesis@preamble\makeatother
\chapter{Introduction}
To use the \textsf{fibeamer} beamer theme, you can use an online
\LaTeX{} editor, such as Overleaf%
\footnote{Overleaf \textsf{fibeamer} templates are located at
\url{http://www.overleaf.com/gallery/tagged/muni}.},
which allows you to skip the installation described in Section
\ref{sec:install} completely.
%<*fi>
{\makeatletter\newcount\thguide@tl\expandafter\thguide@tl\the
\year\if\month<7\advance\thguide@tl-1\fi\makeatother
Another way to avoid installation is to use any public-access
computer at the \makeatletter\thesis@english@facultyName
\makeatother\ that runs Microsoft Windows. By running
\begin{center}
\makeatletter\menu[,]{Start,Programs,Document Tools,TeXLive%
\the\thguide@tl\ namapovani na T}\makeatother
\end{center} you can mount the faculty \TeX\ Live installation to
drive \verb'T:\'. Consequently, you can either use the command
line to run commands from the \TeX{} distribution by running
\begin{center}
\makeatletter\menu[,]{Start,Programs,Document Tools,TeXLive%
\the\thguide@tl\ CMD}\makeatother
\end{center}
or you can use the graphical \TeX\ editor \TeX Works by running
\begin{center}
\makeatletter\menu[,]{Start,Programs,Document Tools,TeXWorks+%
TeXLive\the\thguide@tl}\makeatother
\end{center}}
Yet another way to avoid installation is to either connect to the
Linux server at \url{aisa.fi.muni.cz} over SSH, or use any
public-access computer at the
\makeatletter\thesis@english@facultyName\makeatother\ that runs
Linux or Mac OS, and load the faculty \TeX\ Live installation by
issuing the \texttt{module add texlive} command on the command
line. If you choose this approach, you can also skip the entire
Section \ref{sec:install}, although a certain degree of
proficiency in working with a Unix operating system is required
compared to the other methods.
%</fi>
\makeatletter
% This macro kerns an icon next to a word.
\def\thguide@iconkern{\kern.2ex}
\makeatother
%<*sci>
\makeatletter
% This macro typesets the URL of a math.muni server.
\def\thguide@server#1{%
\includegraphics[height=.5em]{resources/#1.pdf}%
\thguide@iconkern\url{#1.math.muni.cz}}
\makeatother
Another way to avoid installation is to use the faculty \TeX\ Live
installation by connecting to the Linux server at
\makeatletter\thguide@server{yoda}\makeatother\ or
\makeatletter\thguide@server{vader}\makeatother\ over SSH
(through port 22222) or over the remote desktop
protocol\footnote{
For more information about connecting through the remote
desktop protocol, see
\url{http://www.math.muni.cz/aktuality/347-vzdaleny-pristup-yoda-vader.html}.}
(through port 13556), or to use any public-access computer at the
\makeatletter\thesis@english@facultyName\makeatother\ that runs
Linux. If you choose this approach, you can also skip this entire
section, although a certain degree of proficiency in working with
a Unix operating system is required compared to the first method.
%</sci>
\section{Installation}\label{sec:install}
\subsection{Installing a \TeX{} distribution}
If you decided not to use a public \TeX{} distribution, you will
need to install one locally before proceeding further. A \TeX{}
distribution contains tools and packages that are going to help
you with preparing and typesetting your \LaTeX\ documents.
The two major \TeX{} distributions that you can install are
Mik\TeX\footnote{Mik\TeX\ can be acquired from
\url{http://miktex.org/2.9/setup}.}, which can be used with the
Microsoft Windows operating system, and \TeX\ Live\footnote{%
\TeX\ Live can be acquired from
\url{http://www.tug.org/texlive}.}, which can be installed on
both Unix and Windows operating systems. The advantages of
Mik\TeX\ include refined graphical user interface and the ability
to install new packages on the fly.
Along with Mik\TeX{}, you will also need to install a Perl
interpreter, such as Strawberry Perl\footnote{Strawberry Perl can
be downloaded from \url{http://strawberryperl.com/}.}. \TeX\ Live
installs a Perl interpreter by default.
\subsection{Installing packages}\label{sec:req-packages}
In order to function properly, \textsf{fibeamer} needs the
following packages packages to be installed in your \TeX\
distribution: \textsf{ifthen}, \textsf{ifxetex},
\textsf{ifluatex}, \textsf{lm}, \textsf{carlito}, \textsf{arev},
\textsf{iwona}, \textsf{dejavu}, \textsf{setspace},
\textsf{fontenc}, \textsf{fontspec}, \textsf{beamer},
\textsf{fibeamer}.
{\makeatletter %% A placeholder string macro
\def\thguide@placeholder#1{$\langle$\textit{#1}$\rangle$}
If you performed a full installation of \TeX\ Live, you should
already have all the required packages installed. If you are
using a partial installation of \TeX\ Live, you can use the
\texttt{tlmgr} command-line tool by executing \texttt{tlmgr
install} \thguide@placeholder{pkgname}, where
\thguide@placeholder{pkgname} is the name of the package you wish
to install. In some cases, \TeX\ Live may assign a different name
to a package. To find out the \TeX\ Live name of a package, open
the
\texttt{http://www.ctan.org/pkg/}\thguide@placeholder{pkgname}
webpage in a web browser. It should contain the following text:
\begin{center}
Contained in \TeX\ Live as \thguide@placeholder{texlivename}
\end{center}
where \thguide@placeholder{texlivename} corresponds to the \TeX\
Live name of the package. Use this name instead of
\thguide@placeholder{pkgname} with \texttt{tlmgr}.
Alternatively, you can download the packages manually from
\texttt{http://www.ctan.org\discretionary{/}{/}{/}pkg/}%
\thguide@placeholder{pkgname} and extract them into the
\texttt{texmf/} directory located in your user home directory.
Mind that the packages themselves may depend on other
packages; if you are using a partial installation of \TeX\ Live,
you will have to resolve these dependencies manually by
inspecting the documentation of each package.
If you use Mik\TeX\ and you enabled the \textit{over the air
installation of packages} during the installation, Mik\TeX\ will
automatically download all the required packages, when you first
typeset a \textsf{fibeamer} document. If you didn't enable this
feature, you will need to enter the Mik\TeX\ package manager by
running
\begin{center}
\menu[,]{Start,MikTeX,MikTeX Package Manager (Admin)}
\end{center}
and download the packages manually through the user interface.
In some cases, Mik\TeX\ may assign a different name to a
package. To find out the Mik\TeX\ name of a package, open the
\texttt{http://www.ctan.org\discretionary{/}{/}{/}pkg/}%
\thguide@placeholder{pkgname} webpage in a web browser,
where \thguide@placeholder{pkgname} is the name of the
package you wish to install. It should contain the following
text:
\begin{center}
Contained in Mik\TeX\ as \thguide@placeholder{miktexname}
\end{center}
where \thguide@placeholder{miktexname} corresponds to the
Mik\TeX\ name of the package. If you still can't find the
package, try synchronizing the package database by selecting
\begin{center}
\menu[,]{Repository,Synchronize}
\end{center}
from the menu bar of the Mik\TeX\ package manager. Mind that the
packages themselves may depend on other packages; if you disabled
the over the air installation of packages, you will have to
resolve these dependencies manually by inspecting the
documentation of each package.}
If you wish to use a newer version of \textsf{fibeamer} than the
one that is available in your \TeX\ distribution, you should
download a file named \texttt{fibeamer.tds.zip} containing the
version of the package you wish to use and place it in a root
directory that is recognized by your \TeX\ distribution. In
\TeX\ Live\footnote{For more information about the \TeX\ Live root
directories, see
\url{http://www.tug.org/texlive/doc/texlive-en/texlive-en.html\#x1-110002.3},
Chapter 2.3.}, one of such directories is the \texttt{texmf/}
folder in your user home directory. In Mik\TeX\footnote{
For more information about the \TeX\ Live root
directories, see
\url{http://docs.miktex.org/manual/localadditions.html}.},
the list of recognized root directories can be gleaned by
running
\begin{center}
\menu[,]{Start,MikTeX,MikTeX Options (Admin),Roots}
\end{center}
\section{Picking a \TeX\ engine}
There are several programs, called \TeX\ engines, that you can
use to typeset \textsf{fibeamer} \LaTeX{} source files into
displayable PDF documents. The ones we will discuss are
\hologo{pdfTeX} and \Hologo{LuaTeX}.
\Hologo{pdfTeX} is the more conservative choice and most \TeX\
editors use \hologo{pdfTeX} as the default \TeX\ engine. The main
advantage \Hologo{LuaTeX} over \hologo{pdfTeX} for a
\textsf{fibeamer} user is the ability to use standard OpenType
and TrueType fonts installed on your system, whereas
\hologo{pdfTeX} is confined to the fonts installed in your \TeX\
distribution.
If the ability to use arbitrary fonts within your documents
interests you, Chapter 3 of the \textsf{fontspec} package
manual\footnote{The \textsf{fontspec} package manual is available
at \url{http://mirrors.ctan.org/macros/latex/contrib/fontspec/fontspec.pdf}.}
should provide you with the relevant information. If you are
only going to use the fonts present in the \TeX{} distribution or
if you do not intend to change the preset \textsf{fibeamer}
fonts at all, you can safely use \hologo{pdfTeX}, which is
currently also considerably faster than \Hologo{LuaTeX}.
\section{Creating and typesetting a \textsf{fibeamer} document}
Before using the \textsf{fibeamer} theme, it is useful to be
familiar with the \LaTeX{} typesetting system. A good way to get
started is to read one of the introductory texts in English
\cite{veryshortlatex,shortlatex,longlatex,latex} or in Czech
\cite{rybicka03,satrapa11}. Taking one of the \textit{FI:PB029},
\textit{PřF:M5751}, or \textit{FF:PLIN028} courses taught at
the \makeatletter\thesis@english@universityName\makeatother\ is
also helpful.
To become familiar with \textsf{fibeamer}, you are encouraged to
inspect the example \textsf{fibeamer} documents named
\makeatletter
\texttt{\thesis@university-\thesis@faculty-pdflatex.pdf} and
\texttt{\thesis@university-\thesis@faculty-lualatex.pdf} as well
as their \LaTeX{} source files that are named
\texttt{\thesis@university-\thesis@faculty-pdflatex.tex} and
\texttt{\thesis@university-\thesis@faculty-lualatex.tex}. These
example documents are distributed along with the package inside
the \texttt{example/} directory\footnote{The example
\textsf{fibeamer} documents are also available online at
\url{http://mirror.ctan.org/macros/latex/contrib/beamer-contrib/fibeamer/example/mu}.
To typeset the example documents, you need to download the
\texttt{resources/} directory as well, as it contains vector
images used in the examples.}.
By modifying and by typesetting these \LaTeX{} source files using
either the \hologo{pdfTeX} or the \Hologo{LuaTeX} engine, you can
quickly gain a working knowledge of \LaTeX{} and use these source
files as the basis for your thesis.
If you are using an online editor, such as Overleaf
\footnote{Overleaf \textsf{fibeamer} templates are located at
\url{http://www.overleaf.com/gallery/tagged/muni}.}, \LaTeX{}
source files will be typeset automatically, as you edit them. The
\TeX{} engine can be selected inside the
\includegraphics[height=1.3ex]{resources/cog.pdf}\makeatletter
\thguide@iconkern\makeatother project settings.
If you are using a graphical \TeX{} editor, such as \TeX
works\footnote{\TeX works can be downloaded from
\url{http://www.tug.org/texworks/}.}, you can typeset a \LaTeX{}
source file by opening the source file from within the editor and
running either the \hologo{pdfLaTeX} or \Hologo{LuaLaTeX}
(depending on your choice of \TeX\ engine) command from the task
bar. The command needs to be executed at least twice.
If you are using the command line, you can typeset \LaTeX{}
source files by running either \texttt{pdflatex
\textit{name.tex}} or \texttt{lualatex
\textit{name.tex}} (depending on your choice of \TeX\
engine), where \texttt{\textit{name.tex}} corresponds to the name
of a \LaTeX\ source file. In the case of the two aforementioned
example files, the corresponding commands would be:
\begin{center}\makeatletter
\texttt{pdflatex \thesis@university-\thesis@faculty-pdflatex.tex}
\\\texttt{lualatex \thesis@university-\thesis@faculty-lualatex.tex}
\makeatother\end{center}
The command needs to be executed from within the directory, where
the \LaTeX\ source file is located. In Windows, the command line
can be opened in a directory by holding down the \keys{Shift} key
and by clicking the right mouse button while hovering the cursor
over a directory. Select the \menu{Open Command Window Here}
option in the context menu that opens shortly afterwards. The
command also needs to be executed at least twice.
Beside Overleaf and \TeX works, any text editor can be used to
modify \LaTeX{} source files.
\chapter{Configuration}
A \textsf{fibeamer} \LaTeX{} source file should begin as follows:
\begin{minted}{latex}
\documentclass{beamer}
\usetheme[option1, option2, ..., optionN]{fibeamer}
\end{minted}
The following list summarizes the options that are recognized by
the \textsf{fibeamer} theme and their meaning. Options that are
enabled by default are \textit{set in italics}.
{\makeatletter
% This macro formats a default class option.
\def\thguide@default{\itshape}
% This macro formats a class option.
\let\thguide@itemfmt\textbf
\begin{description}
\item[faculty=$\langle${name}$\rangle$]
This option changes the color theme based on the selected
faculty. To choose the color theme of the
\thesis@english@facultyName, use
{\thguide@itemfmt\thesis@faculty} as the
$\langle$name$\rangle$.
\item[\thguide@default fonts]
This option sets up the combination of the font families of
Carlito, Arev, Iwona, Dsfont, and DejaVu for the typesetting
of text and mathematics.
\item[nofonts]
This option prevents \textsf{fibeamer} from setting up the
fonts. The user must set the fonts manually in the preamble
of the document.
%<*fi>
The \thesis@english@facultyName\ has licensed the Comenia
font family. If you wish to use it in your thesis, you should
contact Doc.\ RNDr.\ Petr Sojka, Ph.D.
If you are typesetting your thesis on a public-access
computer at the \thesis@english@facultyName\ or on the
\url{aisa.fi.muni.cz} Linux server, you can use the
commercial Math Time mathematical font family,
%</fi>
%<*sci>
If you are typesetting your thesis on a public-access
computer at the \thesis@english@facultyName\ that runs Linux
or on either the \thguide@server{yoda} or
\thguide@server{vader} Linux server, you can also use the
commercial Math Time mathematical font family,
%</sci>
%<*sci,fi>
which goes well with the \TeX\ Gyre Termes text font family.
To use Math Time and \TeX\ Gyre Termes within your thesis,
the preamble of your document should look as follows:
\begin{minted}{latex}
\documentclass{beamer}
\usetheme[nofonts, ...]{fibeamer}
\usepackage[utf8]{inputenc}
\usepackage{cmap}
\usepackage[T1]{fontenc}
\usepackage{tgtermes}
\usepackage{mathtime}
%% Here goes the rest of the document.
\end{minted}
%</sci,fi>
\item[\thguide@default microtype]
This option sets up microtypographic extensions\footnote{
For more information about the \TeX\ engine
microtypographic extensions, see
\url{http://mirrors.ctan.org/macros/latex/contrib/microtype/microtype.pdf}.
}, which results in visually more pleasing paragraphs of
text.
\item[nomicrotype]
This option prevents \textsf{fibeamer} from setting up
microtypographic extensions.
\end{description}
The complete list of the package options can be found in Section
2 of the technical documentation of the \textsf{fibeamer}
class \cite{novotny15}.}
\makeatletter\thesis@postamble\makeatother
\tolerance=300\emergencystretch=1em
\printbibliography[heading=bibintoc]
\end{document}
% \end{macrocode}
|