1% $Id$
2\documentclass[12pt,paper=a4]{scrartcl}
3
4%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
5% Packages
6%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
7
8% ...
9%\usepackage[margin=3cm]{geometry}
10\usepackage{a4wide}
11
12% ...
13\usepackage[english]{babel}
14
15%\usepackage[latin1]{inputenc}
16%\usepackage[T1]{fontenc}
17
18% Do not indent paragraphs, instead separate them via vertical spacing
19\usepackage{parskip}
20
21% Support for graphics, provides \includegraphics
22\usepackage{graphicx}
23%\graphicspath{{images/}}	% Specify subdir containing the images
24
25% Hyperref enriches the generated PDF with clickable links,
26% and provides many other useful features.
27\usepackage{nameref}
28\usepackage[colorlinks]{hyperref}
29\def\sectionautorefname{Section}	% Write section with capital 'S'
30\def\subsectionautorefname{Subsection}	% Write subsection with capital 'S'
31
32
33% The fancyvrb package provides the "Verbatim" environment, which,
34% unlike the built-in "verbatim", allows embedding TeX commands, as
35% well as tons of other neat stuff (line numbers, formatting adjustments, ...)
36\usepackage{fancyvrb}
37\fvset{tabsize=4,fontsize=\scriptsize,numbers=left}
38
39% Normally, one can not use the underscore character in LaTeX without
40% escaping it (\_ instead of _). Since the Vorbis specs use it a lot,
41% we use the underscore package to change this default behavior.
42\usepackage[nohyphen]{underscore}
43
44% In LaTeX, pictures are normally put into floating environments, and it is
45% left to the typesetting engine to place them in the "optimal" spot. These
46% docs however expect pictures to be placed in a *specific* position. So we
47% don't use \begin{figure}...\end{figure}, but rather a center environment.
48% To still be able to use captions, we use the capt-of package.
49\usepackage{capt-of}
50
51
52%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
53% Custom commands
54%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
55
56% Custom ref command, using hyperrefs autoref & nameref, to simulate the 
57% behavior of DocBook's '<xref>'.
58\newcommand{\xref}[1]{\autoref{#1}, ``\nameref{#1}''}
59
60% Emulat DocBook's '<link>'.
61\newcommand{\link}[2]{\hyperref[#1]{#2}}
62
63% Simple 'Note' environment. Can be customized later on.
64\newenvironment{note}{\subparagraph*{Note:}}{}
65
66% Map DocBook's <programlisting> to fancyvrb's Verbatim environment
67\let\programlisting\Verbatim
68\let\endprogramlisting\endVerbatim
69
70% Fake some more DocBook elements
71\newcommand{\function}[1]{\texttt{#1}}
72\newcommand{\filename}[1]{\texttt{#1}}
73\newcommand{\varname}[1]{\texttt{#1}}
74\newcommand{\literal}[1]{\texttt{#1}}
75
76% Redefine \~ to generate something that looks more appropriate when used in text.
77\renewcommand{\~}{$\sim$}
78
79% Useful helper macro that inserts TODO comments very visibly into the generated
80% file. Helps you to not forget to resolve those TODOs... :)
81\newcommand{\TODO}[1]{\textcolor{red}{*** #1 ***}}
82
83% Configure graphics formats: Prefer PDF, fall back to PNG or JPG, as available.
84\DeclareGraphicsExtensions{.pdf,.png,.jpg,.jpeg}
85
86
87% NOTE: Things to watch out for: Some chars are reserved in LaTeX. You need to translate them...
88%   ~ -> $\sim$ (or \~ which we defined above)
89%   % -> \%
90%   & -> \&
91%   < -> $<$
92%   > -> $>$
93% and others. Refer to any of the many LaTeX refs out there if in doubt!
94
95\begin{document}
96
97
98\title{Vorbis I specification}
99\author{Xiph.org Foundation}
100\maketitle
101
102\tableofcontents
103
104\include{01-introduction}
105\include{02-bitpacking}
106\include{03-codebook}
107\include{04-codec}
108\include{05-comment}
109\include{06-floor0}
110\include{07-floor1}
111\include{08-residue}
112\include{09-helper}
113\include{10-tables}
114
115\appendix
116\include{a1-encapsulation-ogg}
117\include{a2-encapsulation-rtp}
118
119\include{footer}
120
121 
122% TODO: Use a bibliography, as in the example below?
123\begin{thebibliography}{99} 
124 
125\bibitem{Sporer/Brandenburg/Edler} T.~Sporer, K.~Brandenburg and B.~Edler, 
126The use of multirate filter banks for coding of high quality digital audio,
127\url{http://www.iocon.com/resource/docs/ps/eusipco_corrected.ps}.
128
129
130\end{thebibliography}
131
132\end{document}
133