LaTeX – \include und \includeonly

Mit dem \include-Befehl kann man eine .tex-Datei an einer bestimmten Stelle des LaTeX-Quelltextes einfügen. Diese eingebundene Datei wird dann beim Kompilieren mitverarbeitet und sollte deswegen ebenfalls fehlerfreien LaTeX-Quelltext enthalten.

Bei Verwendung des Befehls \include wird automatisch ein Seitenvorschub vor und nach der eingelesenen Datei erzeugt. Man sollte ihn deshalb auch nur für Dokumente verwenden, bei denen eine oder mehrere Seiten in der Ausgabe erzeugt werden sollen.

Mit dem \include-Befehl lassen sich also nicht nur ganze Kapitel zur leichteren Bearbeitung in einzelne .tex-Dateien verpacken, man kann auch den kompletten Header auslagern. Das ist besonders interessant, wenn man zum Beispiel in Betrieben eine einheitliche Vorlage haben möchte oder für sich selbst einige Befehle gefunden hat, die man in jedem LaTeX-Dokument einbinden möchte. Oft werden hierbei Befehle bezüglich der Schriftart, des Textsatzes, der Dokumentart usw. verwendet.

Bei der Verwendung von \include muss die Datei, die eingebunden wird, in geschweifte Klammern gesetzt werden. Die Endung .tex kann hier weggelassen, da die Software diese ohnehin voraussetzt. Die einzubindende Datei muss sich dazu nicht im selben Ordner befinden, man kann in übergeordnete und untergeordnete Verzeichnisse navigieren. Hierzu ein kurzes Beispiel:

Unser Projektordner liegt auf \Dokumente\LaTeX\Diplomarbeit

In \Diplomarbeit befindet sich noch ein Unterordner mit dem Namen „Kapitel1“, der die datei Kapitel1.tex enthält.

In \LaTeX gibt es eine Datei Header.tex, die allgemein eingebunden werden soll und nicht dokumentenspezifisch ist, also nicht eigens für die Diplomarbeit angepasst wurde.

Diese lassen sich wie folgt einbinden:

\include{./Kapitel1/kapitel1} und \include{../Header}

Mit \includeonly kann angegeben werden, welcher der darunter stehenden \include-Befehle tatsächlich ausgeführt werden sollen. Hier lassen sich also erneut gezielt einzelne Dateien ausschließen beziehungsweise einbinden. Achtung: Nicht ausgeführte \include-Befehle erzeugen trotzdem einen Seitenumbruch, obwohl sie nicht eingebunden werden!