xerif

h1. Document Structure

h2. Minimal TeX Document

A minimal tex document that uses the transpect-tex Framework has the following structure: 

<pre><code class="text">

\documentclass[book]{transpect}                              (1)

\usepackage[main=ngerman,bidi=basic,silent]{babel}           (2)

\babelprovide[import]{english}                               (3)

\babelprovide[import]{french}                                (4)

\usepackage[<opt>]{<verlagsstyle>}                           (5)

...                                                          (6)

\begin{document}                                             (7)

…                                                            (8)

\end{document}                                               (9)

</code></pre>

# Document class

** Document class name is *always* @transpect@. 

** Optional argument can be used to pass LaTeX-options such as @a4paper@, @openright@, @twoside@, etc.

** and the document type:

*** "book" 

*** "collection" for books with contributions from various authors

*** "article" for journal articles

# you can include the Babel package, in which the main language of the document is specified (main=<myBabelLanguage>)

# with @\babelprovide{}@ you can specify aditionally used languages

# add an @\babelprovide{<sprachname>}@ for each language

# Include the customer-specific style with the respective options

# the area between @\documentclass[…]{…}@ and @\begin{document}@ is the TeX preamble. Additional meta information (e.g. color definitions, parameters for the front cover, ...) may inserted here

# @\begin{document}@ marks the start of the document

# Content

# anything after @\end{document}@ is ignored. 

h2. Compiling

The minimal order of the TeX files is shown below:

<pre><code class="ruby">

latex <main>.tex       ## first run: collect

latex <main>.tex       ## second run: read and apply aux, toc, lof, lot

latex <main>.tex       ## third run: update page numbers after including toc, lof, etc.

./index.sh <main>      ## script to generate the index 

latex <main>.tex       ## fourth run: Index-Ausgabe, ggf. Aktualisierung toc für Index-ÜS

latex <main>.tex       ## fifth run: update toc 

</code></pre>