Wie verwendet man Input und Include Befehle?

In LaTeX werden die Befehle \input{} und \include{} verwendet, um externe Dateien in das Hauptdokument einzufügen. Beide Befehle dienen dazu, das Dokument in mehrere kleinere Teile zu unterteilen, die separat verwaltet und bearbeitet werden können. Obwohl sie ähnlich sind, gibt es einige wichtige Unterschiede zwischen \input{} und \include{}, die bei der Entscheidung, welchen Befehl man verwenden möchte, zu berücksichtigen sind.

1. Verwendung von \input{}

Der Befehl \input{} wird verwendet, um den Inhalt einer externen LaTeX-Datei (in der Regel mit der Endung .tex) an der Stelle einzufügen, an der der Befehl aufgerufen wird. Er funktioniert so, als ob der Inhalt der externen Datei direkt in das Hauptdokument kopiert würde.

Syntax:

\input{filename}

• filename ist der Name der Datei, die Sie einfügen möchten, ohne die Endung .tex.
• Sie können den Befehl \input{} verwenden, um mehrere Dateien an beliebigen Stellen im Hauptdokument einzufügen.
• \input{} erzeugt keine Seitenumbrüche, daher ist der Übergang zwischen dem Hauptdokument und der eingefügten Datei nahtlos.

Beispiel:

\documentclass[ngerman]{article}
\usepackage{babel} 
\usepackage[utf8]{inputenc} 
\usepackage[T1]{fontenc} 

\begin{document}
\section{Einleitung}
Dies ist der erste Abschnitt des Dokuments.

\input{kapitel1}  % Fügt den Inhalt von kapitel1.tex ein

\input{kapitel2}  % Fügt den Inhalt von kapitel2.tex ein

\end{document}

In diesem Beispiel werden die Dateien kapitel1.tex und kapitel2.tex an den entsprechenden Stellen in das Hauptdokument eingefügt. \input{} kann überall im Dokument verwendet werden, ohne zusätzliche .aux-Dateien zu erstellen oder Seitenumbrüche zu erzwingen.

Wichtige Punkte zu \input{}:

• Seitenumbruch: Keine automatischen Seitenumbrüche.
• Dateiformat: Die Datei muss LaTeX-kompatibel sein, aber sie kann auch nur Text oder LaTeX-Befehle enthalten.
• Verschachtelung: \input{} kann innerhalb von anderen Dateien verwendet werden, die ebenfalls mit \input{} eingefügt wurden.

2. Verwendung von \include{}

Der Befehl \include{} wird verwendet, um ganze Abschnitte oder Kapitel in ein LaTeX-Dokument einzufügen. Im Gegensatz zu \input{} erzeugt \include{} immer einen Seitenumbruch vor und nach dem eingefügten Text. Das macht \include{} besonders nützlich für große Dokumente, bei denen jedes Kapitel oder jeder Abschnitt auf einer neuen Seite beginnen soll.

Syntax:

\include{filename}

• filename ist der Name der Datei, die Sie einfügen möchten, ohne die Endung .tex.
• \include{} erstellt für jede Datei eine eigene .aux-Datei, die Informationen für Inhaltsverzeichnisse, Literaturverzeichnisse und andere Referenzen speichert.
• \include{} führt immer einen Seitenumbruch vor und nach dem eingefügten Text durch.

Beispiel:

\documentclass[ngerman]{book}
\usepackage{babel} 
\usepackage[utf8]{inputenc} 
\usepackage[T1]{fontenc} 

\begin{document}

\include{kapitel1}  % Fügt den Inhalt von kapitel1.tex ein und erzeugt Seitenumbrüche

\include{kapitel2}  % Fügt den Inhalt von kapitel2.tex ein und erzeugt Seitenumbrüche

\end{document}

In diesem Beispiel werden die Dateien kapitel1.tex und kapitel2.tex eingefügt, wobei vor dem Inhalt der eingebunden Dateien automatisch ein Seitenumbruch erfolgt.

Wichtige Punkte zu \include{}:

• Seitenumbruch: \include{} fügt immer Seitenumbrüche vor und nach dem Inhalt ein.
• Zusätzliche .aux-Dateien: Für jede \include{}-Datei wird eine eigene .aux-Datei erstellt, was nützlich ist, wenn Sie Verzeichnisse wie Inhaltsverzeichnisse oder Literaturverzeichnisse erstellen.
• Nur auf oberster Ebene: Eine Versachtelung ist mit \include{} nicht möglich.
• includeonly{}: Mit \includeonly{} können Sie angeben, welche Dateien eingefügt werden sollen, während andere Dateien übersprungen werden. Dies kann beim Kompilieren großer Projekte oder bei der Einschränkung der Rechenzeit eine sinnvolle Möglichkeit sein. Der includeonly{} kann nur in der Präambel verwendet werden.

3. Unterschied zwischen \input und \include

Feature	\input{}	\include{}
Seitenumbruch	Keiner	Automatischer Seitenumbruch vor und nach
.aux-Dateien	Keine zusätzlichen .aux-Dateien	Erzeugt für jede Datei eine .aux-Datei
Einsatz für große Projekte	Gut für kleine Abschnitte oder Dateien	Gut für große Kapitel oder Abschnitte
Verschachtelung	Kann verschachtelt werden	Kann nicht verschachtelt werden
Verwendung von \includeonly{}	Nicht anwendbar	Ermöglicht das selektive Kompilieren

4. Verwendung von \includeonly

Der Befehl \includeonly{} ist besonders nützlich für große Projekte, da er es ermöglicht, nur bestimmte Kapitel oder Abschnitte zu kompilieren. Sie können festlegen, welche Dateien eingefügt werden sollen, während andere \include{}-Dateien ignoriert werden.

Beispiel:

\documentclass[ngerman]{book}
\usepackage{babel} 
\usepackage[utf8]{inputenc} 
\usepackage[T1]{fontenc} 
\includeonly{kapitel2}  % Nur kapitel2 wird kompiliert

\begin{document}

\include{kapitel1}  % Diese Datei wird ignoriert, da sie nicht in \includeonly enthalten ist
\include{kapitel2}  % Nur diese Datei wird eingefügt
\include{kapitel3}  % Diese Datei wird ebenfalls ignoriert

\end{document}

In diesem Beispiel wird nur die Datei kapitel2.tex kompiliert, während die anderen ignoriert werden. Das spart Zeit beziehungsweise Rechenleistung beim Kompilieren großer Projekte.

5. Weitere Tipps und Hinweise

• Strukturierung größerer Dokumente: Für größere Projekte, wie z. B. Bücher oder Abschlussarbeiten, empfiehlt es sich, die Dokumente in Kapitel oder Abschnitte zu unterteilen und mit \include{} zu arbeiten. Bei kleineren Dokumenten können die Unterteilungen mit \input{} realisiert werden.
• Pfad zu den Dateien: Wenn sich die Dateien in einem anderen Verzeichnis befinden, können Sie den relativen oder absoluten Pfad angeben, z. B. \input{chapters/kapitel1.tex}.
• Kombinierte Verwendung: Es ist möglich, \input{} und \include{} in einem Dokument zu kombinieren, je nach den Anforderungen an das Dokument. Beispielsweise können Sie große Kapitel mit \include{} einfügen und kleinere Unterabschnitte mit \input{}. Es ist möglich, innerhalb einer Datei welche mit \include{} eingebunden, eine Datei mit \input{} einzufügen.

Zusammenfassung

• \input{}: Gut für das Einfügen kleinerer LaTeX-Dateien ohne Seitenumbrüche und ohne Erstellung zusätzlicher .aux-Dateien. Es kann verschachtelt werden und ist flexibel für kleinere Abschnitte. Es eignet sich auch gut für Zeichnungen, welche mittels TikZ erstellt worden sind.
• \include{}: Nützlich für größere Projekte, bei denen separate .aux-Dateien benötigt werden und Kapitel immer auf neuen Seiten beginnen sollen. Mit \includeonly{} können Sie nur bestimmte Abschnitte kompilieren, was die Bearbeitung großer Dokumente effizienter macht.