Zum Inhalt springen
Topos Uranos
Deutsch

Lange Dokumente

Zusammenfassung

Diese Lektion zeigt, wie man ein langes Dokument auf mehrere Dateien verteilt, ohne dass es aufhört, ein einziges Dokument zu sein. Sie erklärt, warum es sich lohnt, eine Dissertation, ein Buch oder einen Sammelband aufzuteilen; sie unterscheidet \input, das eine Datei so einfügt, als stünde ihr Text an dieser Stelle, von \include, das ein Kapitel auf eigenen Seiten und mit einer eigenen Hilfsdatei setzt; sie zeigt, wie \includeonly nur einige Kapitel kompiliert und dabei Nummerierung und Querverweise bewahrt, und unter welcher Bedingung das gelingt; sie schlägt eine Ordnung der Ordner und Dateinamen vor; sie lehrt, in Texmaker das Masterdokument festzulegen und stets von der Hauptdatei aus zu kompilieren; sie stellt das Paket subfiles vor, mit dem sich ein Kapitel einzeln kompilieren lässt; sie entwickelt als vollständigen Fall den Aufbau einer Dissertation; und sie geht die häufigsten Fehler mit ihren tatsächlichen Meldungen durch.

Lernziele

  1. Für jedes Teilstück eines langen Dokuments entscheiden, ob es mit \input oder mit \include einzufügen ist, je nach der Wirkung auf die Seiten und die Hilfsdateien.
  2. Vorhersagen, welche Nummern, Seiten und Querverweise \includeonly erzeugt, und erklären, von welcher früheren Kompilierung ihre Bewahrung abhängt.
  3. Ein Projekt in eine Hauptdatei und Ordner gliedern, mit Pfaden relativ zur Hauptdatei und mit Dateinamen, die keine Probleme verursachen.
  4. Texmaker so einrichten, dass es das Masterdokument von jeder Datei des Projekts aus kompiliert, und mit subfiles Kapitel vorbereiten, die auch allein kompilieren.
  5. In der Protokolldatei die Fehler erkennen, die geteilten Dokumenten eigen sind, und diejenigen, welche die Kompilierung abbrechen, von denen unterscheiden, die sie mit einem unvollständigen Ergebnis zu Ende kommen lassen.

Warum man ein Dokument aufteilt

Ein Artikel von fünfzehn Seiten passt bequem in eine einzige Datei. Eine Dissertation von zweihundert Seiten nicht: Die Datei hat Tausende von Zeilen, eine Passage zu finden erfordert eine Suche, und jede Kompilierung durchläuft das ganze Dokument, auch wenn sich nur ein Komma im letzten Kapitel geändert hat. Ein Buch bringt Kapitel hinzu, die zu verschiedenen Zeiten geschrieben werden; ein Sammelband Kapitel, die verschiedene Autorinnen und Autoren schreiben, jede und jeder im eigenen Tempo. In allen drei Fällen empfiehlt es sich, dass jedes Kapitel in einer eigenen Datei steht.

Die Dateien aufzuteilen darf jedoch nicht das Dokument aufteilen. Das Inhaltsverzeichnis muss alle Kapitel aufführen, die Nummerierung muss von einem zum nächsten weiterlaufen, und ein Querverweis im ersten muss den Abschnitt des fünften finden. Die Lösung von LaTeX ist eine Hauptdatei, welche die Klasse, die Präambel und die Reihenfolge der Teilstücke enthält und jedes Teilstück mit einem Befehl an seiner Stelle einfügt. Die Engine kompiliert immer die Hauptdatei; die Teilstücke sind keine Dokumente, sondern Bruchstücke ihres Rumpfs. Daraus folgt die Regel, die die ganze Lektion durchzieht: Ein Teilstück hat keine Präambel, und es wird von der Hauptdatei aus kompiliert.

Es gibt zwei Befehle, um ein Teilstück einzufügen, \input und \include, und ihr Unterschied ist keine Stilfrage: Jeder macht etwas anderes mit den Seiten und mit den Hilfsdateien.