Große LaTeX-Projekte verwalten: Struktur, Kapitelvorschauen und Benennung
Große LaTeX-Projekte werden wartungsaufwendig, wenn Änderungsorte unklar sind, die Kompilierung langsamer wird und verstreute Pakete Konflikte erzeugen. Geben Sie Dateien klare Aufgaben, bündeln Sie die Präambel, begrenzen Sie Vorschauen und verwenden Sie einheitliche Namen.
Verzeichnis nach Zuständigkeit ordnen
Trennen Sie Kapitel, Tabellen und Bilder, damit Dateinamen den Suchort erkennen lassen:
project/├── main.tex % Klasse und Kapitelreihenfolge├── preamble.tex % Pakete und Projektbefehle├── chapters/│ ├── intro.tex│ ├── method.tex│ └── results.tex├── tables/ % Tabellenquellen für \input└── figures/Diese Hauptdatei setzt preamble.tex und die drei Kapiteldateien an den angegebenen Orten voraus:
% main.tex\documentclass[11pt]{article}\input{preamble}% Nur für Kapitelvorschau aktivieren; für endgültige Ausgabe auskommentiert lassen% \includeonly{chapters/method}\begin{document}\include{chapters/intro}\include{chapters/method}\include{chapters/results}\end{document}Die Hauptdatei enthält Klasse, gemeinsame Konfiguration und Kapitelreihenfolge. Eine Kapiteländerung betrifft normalerweise eine Datei unter chapters/.
Pakete über einen Einstiegspunkt laden
Wird ein Paket an mehreren Stellen mit verschiedenen Optionen geladen, kann Option clash for package ... entstehen. Halten Sie die Paketliste in preamble.tex; die deutsche Fassung ergänzt Sprach- und Schriftunterstützung:
% preamble.tex – sämtliche Projektpakete hier laden\usepackage[T1]{fontenc}\usepackage{lmodern}\usepackage[ngerman]{babel}\usepackage{amsmath,amssymb}\usepackage{graphicx}\usepackage{booktabs}\usepackage[hidelinks]{hyperref}Laden Sie sie mit \input vor \begin{document}. Die Paketreihenfolge ist wichtig; hyperref steht normalerweise gegen Ende. Kapiteldateien sollten dieselben Pakete nicht selbst erneut laden.
Ausgewählte Kapitel mit \includeonly vorab ansehen
Für Vorschauen begrenzt \includeonly, welche eingebundenen Kapitel gesetzt werden. Nummerierung und Verweise ausgeschlossener Kapitel hängen von vorhandenen Hilfsinformationen ab. Setzen Sie nicht voraus, dass diese bei jedem Plattformauftrag fortbestehen.
Der Befehl gilt für \include, nicht für \input. Verweise auf Kapitel ohne verfügbare Hilfsinformationen können ?? anzeigen.
% Nur das Methodenkapitel vorab ansehen\includeonly{chapters/method}Nur eingeschlossene Kapitel werden aktualisiert. Ändern sich Längen, können Seitenzahlen übersprungener Kapitel veraltet sein. Entfernen Sie die Einschränkung und kompilieren Sie vor der Abgabe das gesamte Dokument.
Präfixe für Labels verwenden
| Objekt | Präfix | Beispiel |
|---|---|---|
| Abschnitt | sec: | \label{sec:method} |
| Abbildung | fig: | \label{fig:pipeline} |
| Tabelle | tab: | \label{tab:ablation} |
| Gleichung | eq: | \label{eq:update} |
Doppelte Labels stoppen die Kompilierung möglicherweise nicht, können aber Warnungen wie multiply-defined labels und falsche Verweise erzeugen. Präfixe erleichtern projektweite Suchen; die Namen müssen dennoch eindeutig sein.
Setzen Sie in einem Gleitobjekt \label nach \caption. Die umgekehrte Reihenfolge kann das Label ohne Kompilierfehler an einen früheren Zähler binden.
Dateipfade, Labels und endgültige Kompilierung prüfen
Gleichen Sie nach einer Änderung Einbindungsliste und Dateibaum ab, prüfen Sie Verweisziele und entscheiden Sie, ob eine vollständige Kompilierung nötig ist.
| Meldung | Ursache | Maßnahme |
|---|---|---|
There were multiply-defined labels. | Labelname wiederholt | Duplikate finden und umbenennen; vollständige Kompilierung aktualisiert Verweise |
Reference 'fig:x' undefined | Labelinformationen fehlen oder Kapitel ausgeschlossen | Ganzes Dokument kompilieren und Labelposition prüfen |
Label(s) may have changed. | Verweise haben sich während der Kompilierung geändert | Wiederholungen abwarten; bei bleibender Warnung untersuchen |
Option clash for package hyperref. | Paket mit widersprüchlichen Optionen geladen | In preamble.tex bündeln |
\include cannot be nested. | Kapitel enthält weiteres \include | Innerhalb des Kapitels \input verwenden |
Verwandte Themen: Codewiederholungen reduzieren, Kompilierfehlersuche und kontrollierbare KI-Änderungen.
Das Wichtigste
- Trennen Sie Hauptstruktur, Kapitel, Tabellenquellen und Bilder.
- Laden Sie Pakete an einer Stelle.
- Nutzen Sie Kapitelvorschauen nur für Teilprüfungen; kompilieren Sie vor der Abgabe alles.
- Verwenden Sie durchsuchbare Präfixe und eindeutige Labels.
Importieren Sie das gesamte Verzeichnis in EasyLaTeX und wählen Sie main.tex als Hauptdatei.