latex-wochenende/sections/german/05.md

Projektstruktur

---

Zielsetzung

Ein größeres LaTeX-Projekt anlegen und dabei ...

• ... verhindern, dass LaTeX-Dokumente zu monströser Größe anwachsen 👹
• ... den Überblick über die Struktur eines Projekts behalten

---

Hauptdatei 👑

• enthält wie immer tex \begin{document} und tex \end{document}
• Elemente wie Inhalts-, Literatur- und Abbildungsverzeichnis
• die Dateien mit den verschiedenen Teilabschnitten werden eingefügt mit
  • tex \input{filename.tex} ODER
  • tex \include{filename}

---

Datei mit Teilabschnitt

• enthält keine Präambel
• enthält kein tex \begin{document} und tex \end{document

---

```tex \input{filename.tex}```

• Dateiendung .tex angeben
• Schachtelung möglich: Unterdateien können wiederum per `tex \input{}` andere Unterunterdateien einbinden
• Unterdatei wird im fertigen Dokument ohne Sprung auf neue Seite in Hauptdatei eingefügt

```tex \include{filename}```

• Dateiendung .tex **nicht** angeben
• Schachtelung nicht möglich
• für jede Unterdatei wird im fertigen Dokument eine neue Seite angelegt

---

EXKURS: Dateipfade angeben 👣

• wichtig für tex \input{} und tex \include{} sowie später für das Einbinden von Bildern
• Datei- und Ordnerstruktur = Baumstruktur

---

Absolute Dateipfade

• Pfad von der Wurzel des Ordnerbaums bis zur jeweiligen Datei
• die verschiedenen Ebenen des Baums werden dabei durch folgende Zeichen getrennt:
  • / (Unix, Mac)
  • \ (Windows)

---

Relative Dateipfade

• Pfad von einem bestimmten Ort irgendwo im Ordnerbaum bis zur jeweiligen Datei
• kürzer + weniger Schreibarbeit! :)
• bei tex \input{}und tex \include{} kann etwa der Pfad zu einer Unterdatei relativ zur Hauptdatei angeben werden

---

Ende des Exkurses

---

Kompilieren des Projekts

• Nur die Hauptdatei wird kompiliert, um das fertige PDF-Dokument zu erhalten
• Fehlermeldungen enthalten dann Verweis, in welcher Unterdatei sie aufgetreten sind

---

Kompilieren des Projekts

• die Unterdateiten können wegen ihrer fehlenden Präambel nicht selbstständig kompiliert werden
• aber geschickter Trick bei tex \include{}: tex \includeonly{file1,file2,...} in die Präambel schreiben, um nur einzelne Unterdateien zu kompilieren