Eine Wurzeldatei, viele Kapitel
include und input, includeonly und das Entwerfen Kapitel für Kapitel.
Eine Wurzeldatei, viele Kapitel
Eine Abschlussarbeit in einer einzigen .tex-Datei wird etwa ab dem zweiten Kapitel mühsam zu bearbeiten: Scrollen ersetzt Nachdenken, und jede Kompilierung verarbeitet alles. Das Standardmittel ist eine Wurzeldatei, die Klasse und Präambel enthält, mit jedem Kapitel in einer eigenen Datei. Die Wurzeldatei fügt sie zusammen.
Die Wurzeldatei
% main.tex\documentclass{report}\begin{document}\include{chapters/intro}\include{chapters/methods}\include{chapters/results}\end{document}main.tex ist die einzige Datei, die Sie jemals kompilieren. Jedes \include nennt eine andere Datei ohne ihre Endung .tex, mit einfachen Schrägstrichen auf jeder Plattform, und zieht ihren Inhalt an dieser Stelle ein. Die Kapiteldateien selbst enthalten nur Inhalt und beginnen typischerweise mit \chapter{...}. Sie haben weder \documentclass noch eine eigene Umgebung document, denn sie sind Fragmente dieses Dokuments, keine eigenständigen Dokumente.
include und input im Vergleich
Die beiden Einbindungsbefehle verhalten sich unterschiedlich, und die Unterschiede entscheiden, welchen Sie wo verwenden. \include beginnt vor dem Material eine neue Seite, was zu Kapiteln passt, und schreibt für jede eingebundene Datei eine eigene .aux-Datei, was die selektive Kompilierung erst möglich macht. \input ist ein schlichtes textuelles Einfügen: kein Seitenumbruch, keine eigene .aux, und es lässt sich in ein anderes \input schachteln. Damit ist \input das richtige Werkzeug für Fragmente, die kleiner als ein Kapitel sind, etwa eine große Tabelle in einer eigenen Datei oder eine gemeinsame Makrodatei. Eine Strukturregel sollten Sie sich merken: \include darf nicht in einer eingebundenen Datei verschachtelt werden, \input dagegen kann überall verwendet werden.
Ein Kapitel nach dem anderen entwerfen
\includeonly{chapters/methods}In der Präambel platziert, weist \includeonly LaTeX an, nur die aufgelisteten Dateien zu verarbeiten, die gespeicherten .aux-Daten aller anderen aber weiterhin zu lesen. Die Kompilierung wird dramatisch schneller, und weil die Labels und Seitenzahlen der anderen Kapitel aus deren .aux-Dateien wiedergegeben werden, bleiben Querverweise und Nummerierung im Kapitel, das Sie gerade entwerfen, korrekt. Diese zweite Hälfte ist der Grund, dieses Vorgehen dem Auskommentieren von \include-Zeilen vorzuziehen, das die anderen Kapitel vollständig vergisst und jedes \ref auf sie in ?? verwandelt.
Kommentieren Sie die Zeile \includeonly für vollständige Builds aus, und führen Sie immer eine vollständige Kompilierung durch, bevor Sie ein PDF weitergeben, denn veraltete .aux-Daten können hinter Änderungen in ausgeschlossenen Kapiteln zurückbleiben. Welche Dateien im entstehenden Ordner von Ihnen stammen und welche erzeugt wurden, steht in Die Dateien in einem echten Projekt.