Die Dateien in einem echten Projekt
.tex, .bib, .cls, .sty und der erzeugte Müll, den Sie nicht einchecken sollten.
Die Dateien in einem echten Projekt
Öffnen Sie nach einer Kompilierung den Ordner eines beliebigen echten LaTeX-Projekts, und Sie finden weit mehr Dateien, als Sie geschrieben haben. Das überrascht die meisten Anfänger, und die Angst, das Falsche zu löschen, hält Ordner für immer unaufgeräumt. Die Unterscheidung, die Klarheit schafft: Manche Dateien sind Quellen, die Sie bearbeiten, manche sind Stile, die eine Vorlage oder ein Paket mitbringt, und der Rest sind erzeugte Zwischendateien, die der Compiler bei jedem Lauf neu anlegt.
Die Dateien, die Sie schreiben
Ihre .tex-Dateien enthalten das eigentliche Dokument: den Text, die Abschnitte, Abbildungen und Formeln. Eine .bib-Datei ist Ihre Literaturdatenbank, mit einem Eintrag pro Paper oder Buch, das Sie zitieren könnten; Sie können sie von Hand pflegen oder aus einer Literaturverwaltung wie Zotero exportieren. Diese Dateien sollten Sie sichern und unter Versionskontrolle stellen, denn alles andere lässt sich aus ihnen neu erzeugen.
Die Dateien, die eine Vorlage mitbringt
Eine .cls-Datei definiert eine Dokumentklasse, das, was Sie in \documentclass{...} nennen. Zeitschriften und Tagungen liefern eigene mit, damit jede Einreichung gleich aussieht, und Sie bearbeiten so gut wie nie eine. Eine .sty-Datei ist ein Paket: wiederverwendbare Makros und Einstellungen, die mit \usepackage geladen werden. Selbst schreiben werden Sie eines erst, wenn Sie eigene Befehle für mehrere Dokumente gemeinsam nutzen wollen. Eine .bst-Datei beschreibt einen BibTeX-Zitierstil und wird ebenfalls meist einfach von der Zeitschrift oder Tagung mitgeliefert.
Die Dateien, die der Compiler erzeugt
Die .aux-Datei speichert Querverweis- und Zitatdaten zwischen den Kompilierdurchläufen; bearbeiten Sie sie nie und löschen Sie sie ruhig, denn die nächste Kompilierung schreibt sie neu. Die .log-Datei hält alles fest, was der Compiler getan hat, und lohnt sich nur zu öffnen, wenn etwas schiefgeht. Die .pdf ist die Ausgabe, die Sie eigentlich wollten.
| Endung | Rolle | Von Hand bearbeiten? |
|---|---|---|
.tex | Quelldokumente und Kapitel | Ja |
.bib | Literaturdatenbank | Ja (oder aus Zotero exportieren) |
.cls | Dokumentklasse | Selten, bei Vorlagen von Zeitschriften und Tagungen |
.sty | Pakete / Stildateien | Wenn Sie eigene Makros schreiben |
.bst | BibTeX-Stil | Selten |
.aux | Querverweisdaten | Nein: erzeugt |
.log | Compiler-Log | Beim Debuggen lesen |
.pdf | Ausgabe | Ansehen / einreichen |
Eine Projektstruktur, die mitwächst
paper/ main.tex chapters/ figures/ refs.bibEine main.tex auf oberster Ebene dient als Einstiegspunkt, Kapitel liegen in einem eigenen Ordner und werden mit \input oder \include eingebunden, Bilder liegen in figures/, und die Literaturdatenbank bleibt in einer einzigen refs.bib. Diese Struktur bleibt handhabbar, ob das Projekt ein vierseitiges Paper oder eine Abschlussarbeit ist. Kapitel auf Dateien aufteilen zeigt, wie die Teile zusammenhängen.
Wenn Sie Git verwenden, tragen Sie *.aux, *.log und die anderen erzeugten Dateien in .gitignore ein, damit Ihre Historie nur echte Quellen verfolgt. Oleafly-Projekte sind einfache Ordner auf der Festplatte, daher gilt dieser Rat dort unverändert. Der häufigste Fehler ist der umgekehrte: Bei der Suche nach einem merkwürdigen Kompilierfehler besteht die Lösung oft darin, die .aux-Dateien zu löschen, denn eine veraltete Datei aus einem fehlgeschlagenen Lauf kann jede weitere Kompilierung vergiften.