Chris@1: % $Id$
Chris@1: \documentclass[12pt,paper=a4]{scrartcl}
Chris@1: 
Chris@1: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Chris@1: % Packages
Chris@1: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Chris@1: 
Chris@1: % ...
Chris@1: %\usepackage[margin=3cm]{geometry}
Chris@1: \usepackage{a4wide}
Chris@1: 
Chris@1: % ...
Chris@1: \usepackage[english]{babel}
Chris@1: 
Chris@1: %\usepackage[latin1]{inputenc}
Chris@1: %\usepackage[T1]{fontenc}
Chris@1: 
Chris@1: % Do not indent paragraphs, instead separate them via vertical spacing
Chris@1: \usepackage{parskip}
Chris@1: 
Chris@1: % Support for graphics, provides \includegraphics
Chris@1: \usepackage{graphicx}
Chris@1: %\graphicspath{{images/}}	% Specify subdir containing the images
Chris@1: 
Chris@1: % Hyperref enriches the generated PDF with clickable links,
Chris@1: % and provides many other useful features.
Chris@1: \usepackage{nameref}
Chris@1: \usepackage[colorlinks]{hyperref}
Chris@1: \def\sectionautorefname{Section}	% Write section with capital 'S'
Chris@1: \def\subsectionautorefname{Subsection}	% Write subsection with capital 'S'
Chris@1: 
Chris@1: 
Chris@1: % The fancyvrb package provides the "Verbatim" environment, which,
Chris@1: % unlike the built-in "verbatim", allows embedding TeX commands, as
Chris@1: % well as tons of other neat stuff (line numbers, formatting adjustments, ...)
Chris@1: \usepackage{fancyvrb}
Chris@1: \fvset{tabsize=4,fontsize=\scriptsize,numbers=left}
Chris@1: 
Chris@1: % Normally, one can not use the underscore character in LaTeX without
Chris@1: % escaping it (\_ instead of _). Since the Vorbis specs use it a lot,
Chris@1: % we use the underscore package to change this default behavior.
Chris@1: \usepackage[nohyphen]{underscore}
Chris@1: 
Chris@1: \usepackage{enumitem}
Chris@1: 
Chris@1: % In LaTeX, pictures are normally put into floating environments, and it is
Chris@1: % left to the typesetting engine to place them in the "optimal" spot. These
Chris@1: % docs however expect pictures to be placed in a *specific* position. So we
Chris@1: % don't use \begin{figure}...\end{figure}, but rather a center environment.
Chris@1: % To still be able to use captions, we use the capt-of package.
Chris@1: \usepackage{capt-of}
Chris@1: 
Chris@1: 
Chris@1: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Chris@1: % Custom commands
Chris@1: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Chris@1: 
Chris@1: % Custom ref command, using hyperrefs autoref & nameref, to simulate the 
Chris@1: % behavior of DocBook's '<xref>'.
Chris@1: \newcommand{\xref}[1]{\autoref{#1}, ``\nameref{#1}''}
Chris@1: 
Chris@1: % Emulat DocBook's '<link>'.
Chris@1: \newcommand{\link}[2]{\hyperref[#1]{#2}}
Chris@1: 
Chris@1: % Simple 'Note' environment. Can be customized later on.
Chris@1: \newenvironment{note}{\subparagraph*{Note:}}{}
Chris@1: 
Chris@1: % Map DocBook's <programlisting> to fancyvrb's Verbatim environment
Chris@1: \let\programlisting\Verbatim
Chris@1: \let\endprogramlisting\endVerbatim
Chris@1: 
Chris@1: % Fake some more DocBook elements
Chris@1: \newcommand{\function}[1]{\texttt{#1}}
Chris@1: \newcommand{\filename}[1]{\texttt{#1}}
Chris@1: \newcommand{\varname}[1]{\texttt{#1}}
Chris@1: \newcommand{\literal}[1]{\texttt{#1}}
Chris@1: 
Chris@1: % Redefine \~ to generate something that looks more appropriate when used in text.
Chris@1: \renewcommand{\~}{$\sim$}
Chris@1: 
Chris@1: % Useful helper macro that inserts TODO comments very visibly into the generated
Chris@1: % file. Helps you to not forget to resolve those TODOs... :)
Chris@1: \newcommand{\TODO}[1]{\textcolor{red}{*** #1 ***}}
Chris@1: 
Chris@1: % Configure graphics formats: Prefer PDF, fall back to PNG or JPG, as available.
Chris@1: \DeclareGraphicsExtensions{.pdf,.png,.jpg,.jpeg}
Chris@1: 
Chris@1: 
Chris@1: % NOTE: Things to watch out for: Some chars are reserved in LaTeX. You need to translate them...
Chris@1: %   ~ -> $\sim$ (or \~ which we defined above)
Chris@1: %   % -> \%
Chris@1: %   & -> \&
Chris@1: %   < -> $<$
Chris@1: %   > -> $>$
Chris@1: % and others. Refer to any of the many LaTeX refs out there if in doubt!
Chris@1: 
Chris@1: \begin{document}
Chris@1: 
Chris@1: 
Chris@1: \title{Vorbis I specification}
Chris@1: \author{Xiph.Org Foundation}
Chris@1: \maketitle
Chris@1: 
Chris@1: \tableofcontents
Chris@1: 
Chris@1: \include{01-introduction}
Chris@1: \include{02-bitpacking}
Chris@1: \include{03-codebook}
Chris@1: \include{04-codec}
Chris@1: \include{05-comment}
Chris@1: \include{06-floor0}
Chris@1: \include{07-floor1}
Chris@1: \include{08-residue}
Chris@1: \include{09-helper}
Chris@1: \include{10-tables}
Chris@1: 
Chris@1: \appendix
Chris@1: \include{a1-encapsulation-ogg}
Chris@1: \include{a2-encapsulation-rtp}
Chris@1: 
Chris@1: \include{footer}
Chris@1: 
Chris@1:  
Chris@1: % TODO: Use a bibliography, as in the example below?
Chris@1: \begin{thebibliography}{99} 
Chris@1:  
Chris@1: \bibitem{Sporer/Brandenburg/Edler} T.~Sporer, K.~Brandenburg and B.~Edler, 
Chris@1: The use of multirate filter banks for coding of high quality digital audio,
Chris@1: \url{http://www.iocon.com/resource/docs/ps/eusipco_corrected.ps}.
Chris@1: 
Chris@1: 
Chris@1: \end{thebibliography}
Chris@1: 
Chris@1: \end{document}