#  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`

---

 <div class="two-columns">
	<div class="column">
		```tex \input{filename.tex}```
		<ul class="fragment">
			<li>Dateiendung .tex angeben</li>
			<li>Schachtelung möglich: Unterdateien können wiederum per `tex \input{}` andere Unterunterdateien einbinden</li>
			<li>Unterdatei wird im fertigen Dokument ohne Sprung auf neue Seite in Hauptdatei eingefügt</li>
	    	</ul>
	</div>
	<div class="column">
		```tex \include{filename}```
			<ul class="fragment">
				<li>Dateiendung .tex **nicht** angeben</li>
				<li>Schachtelung nicht möglich</li>
				<li>für jede Unterdatei wird im fertigen Dokument eine neue Seite angelegt</li>
		</ul>
	</div>
</div>

---

##  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