Zum Inhalt springen
Topos Uranos
Deutsch

Anatomie eines Dokuments

Zusammenfassung

Diese Lektion zerlegt einen LaTeX-Quelltext in seine Bestandteile. Sie unterscheidet die Präambel vom Textteil und erklärt, was in jeden der beiden gehört und warum; sie beschreibt die Befehle mit ihren zwei Arten von Namen, ihren Pflicht- und optionalen Argumenten und ihren Sternformen und legt genau fest, wo der Name eines Befehls endet; sie zeigt, wie Gruppen den Gültigkeitsbereich von Deklarationen begrenzen; sie stellt die Umgebungen vor und den Fehler, den eine falsche Schachtelung hervorruft; sie geht die zehn reservierten Zeichen durch, was jedes bewirkt und wie man es druckt; sie erklärt Kommentare als Mittel, Code zu deaktivieren; und sie stellt kurz die Pakete und die Dokumentklasse mit ihren Optionen vor, die die Einheit über die Struktur ausführlich behandeln wird.

Lernziele

  1. Die Präambel vom Textteil unterscheiden und entscheiden, wohin ein Befehl gehört, je nachdem, was er bewirkt.
  2. An einem Befehl seinen Namen, seine Pflicht- und optionalen Argumente und seine Sternform erkennen und vorhersagen, wo sein Name endet.
  3. Den Gültigkeitsbereich einer Deklaration innerhalb von Gruppen und Umgebungen vorhersagen und sie so schreiben, dass sie nur den gewünschten Text betrifft.
  4. Umgebungen korrekt schachteln und den Fehler deuten, den eine falsche Schachtelung hervorruft.
  5. Jedes der zehn reservierten Zeichen drucken und erklären, was jedes bewirkt, wenn es nicht geschützt ist.

Die zwei Teile eines Quelltextes

Jeder LaTeX-Quelltext hat dieselbe Form. Er beginnt mit \documentclass, das die Dokumentklasse festlegt. Was folgt, bis \begin{document}, ist die Präambel: Dort werden die Pakete geladen und die Entscheidungen getroffen, die für das ganze Dokument gelten, aber es wird nichts gesetzt. Zwischen \begin{document} und \end{document} liegt der Textteil, der einzige Ort, an dem Text gesetzt wird. Was nach \end{document} steht, wird vollständig ignoriert.

Die Teilung ist keine Stilkonvention, sondern eine Folge der Arbeitsweise von LaTeX. Bei \begin{document} schließt LaTeX die Konfiguration ab: Nun steht fest, welche Pakete vorhanden sind und welche Schrift, welche Sprache und welches Seitenformat gelten, und von diesem Augenblick an wird gesetzt. Daraus folgen zwei Regeln und zwei Fehler. Erstens: Ein Paket kann nur in der Präambel geladen werden, weil es bereits angewandte Entscheidungen ändern könnte; ein \usepackage im Textteil erzeugt den Fehler „Can be used only in preamble“. Zweitens: In der Präambel wird nichts gesetzt; ein Text, eine Abschnittsüberschrift oder ein Inhaltsverzeichnis vor \begin{document} erzeugen den Fehler „Missing \begin{document}“.

Zwischen beiden Extremen gibt es Befehle, die etwas nur definieren oder speichern, ohne es zu setzen: \newcommand, das einen neuen Befehl definiert, oder \title, das den Titel speichert, bis \maketitle ihn druckt. Sie funktionieren in beiden Teilen, gehören aber in die Präambel, weil sie so von Anfang an gelten und wer den Quelltext liest, sie beisammen findet.

BeispielEin Dokument mit gekennzeichneten Teilen

Die Kommentare, die mit % beginnen, kennzeichnen die Teile; das Satzprogramm ignoriert sie. Die letzte Zeile, nach \end{document} geschrieben, erscheint ebenfalls nicht im Ergebnis.

LaTeX-Code
\documentclass{article}      % die Klasse\usepackage{fontspec}        % Präambel: Pakete\usepackage[ngerman]{babel}\title{Lektürebericht}       % Präambel: gespeicherte Angaben\author{Anna Weber}\date{}​\begin{document}             % der Textteil beginnt\maketitle\section{Fragestellung}Der Textteil ist der einzige Ort, an dem Text gesetzt wird.\end{document}               % Ende des TextteilsDiese Zeile erscheint nicht im Ergebnis.
Ergebnis
Ergebnis

Der Befehl \date{} mit leerem Argument bewirkt, dass \maketitle kein Datum druckt, das sonst das der Übersetzung wäre. Die Option ngerman wählt die neue deutsche Rechtschreibung, etwa für die Silbentrennung.