Git für wissenschaftliche Aufsätze: was mit Koautoren tatsächlich funktioniert
Ignore-Regeln, Zuständigkeit für Kapitel, Commit-Nachrichten, private Remotes und wie ein Forschungs-Workspace mit echtem Git, Forks und KI-Checkpoints Aufsätze wiederherstellbar hält, ohne aus Git einen Zweitjob zu machen.
Forschende nutzen Git schon für Code. Aufsätze sehen Code sehr ähnlich: Klartext, Einbindungen, Build-Müll. Ein Manuskript in ein Repository zu legen, ist weniger seltsam, als es klingt, sobald man es einmal ausprobiert hat.
Den Müll ignorieren
Eine vernünftige .gitignore für LaTeX:
*.aux*.log*.out*.toc*.synctex.gz*.bbl*.blg*.fdb_latexmk*.flsCommitten Sie .tex, .bib, Abbildungen, die Sie nicht neu erzeugen können, und
die Klassendatei, wenn die Hochschule sie verlangt. Committen Sie nicht jedes PDF,
es sei denn, die Zeitschrift will eine Binärdatei im Archiv.
Wenn Ihr Editor Git für Sie startet, prüfen Sie, dass Build-Zwischenspeicher und PDF-Zwischenprodukte ignoriert werden. Ein Strom von „Rausch“-Commits aus aux-Dateien macht das Protokoll wertlos. Sie hören auf, es zu lesen, und dann kann Ihnen der Verlauf nicht helfen, wenn etwas kaputtgeht.
Dateien besitzen, nicht Zeilen
Zwei Personen im selben Absatz bedeuten Merge-Schmerzen. Bevorzugen Sie die Zuständigkeit nach Kapitel oder Abschnitt. Nutzen Sie Pull Requests, wenn die Gruppe groß genug ist, dass ein Review wirklich hilft.
Gemeinsames Tippen mehrerer Personen in einem Puffer ist ein anderes Werkzeug (LaTeX-Editoren im Browser). Zusammenarbeit mit Git ist langsamer und ausdrücklicher: Branch, Push, Review. Das funktioniert gut, wenn Sie Nachvollziehbarkeit brauchen. Wenn drei Leute heute Nachmittag gemeinsam das Abstract tippen müssen, wählen Sie etwas anderes.
Commit-Nachrichten, die Ihr späteres Ich lesen kann
„Änderungen“ ist in drei Monaten nutzlos. „Verwandte Arbeiten zu Transformern neu geschrieben“ genügt. Zwei Ebenen helfen:
- Meilensteine, die Sie benennen: Abschnittsentwürfe, Einreichung, druckfertige Fassung.
- Sicherheits-Checkpoints: häufige Schnappschüsse, damit ein schlechter Nachmittag umkehrbar ist.
Wenn Ihr Editor nach einem erfolgreichen Kompilierlauf oder nach einer Tipppause einen Checkpoint setzt, betrachten Sie das als Untergrenze, nicht als den einzigen Verlauf. Schreiben Sie eine richtige Nachricht, wenn ein Abschnitt fertig ist oder ein Entwurf an Koautoren geht.
Private Remotes
Unveröffentlichte Arbeit gehört in private GitHub- oder GitLab-Projekte. Beim Abschluss und beim Laborwechsel verlieren Menschen den Zugriff auf irgendwelche Cloud-Editor-Konten. Ein Remote, das Sie kontrollieren, ist das Backup.
Pushen Sie, wenn Sie Netz haben. Warten Sie nicht bis zur Nacht vor einer Frist, um zu entdecken, dass das Remote nie verbunden war.
Auf dem eigenen Rechner kompilieren, entfernt sichern
In den meisten Wochen sieht der Ablauf so aus: offline bearbeiten und kompilieren, pushen, wenn Sie Netz haben. Sie brauchen keine Live-Sitzung im Browser, nur um zu tippen.
Was Sie von den Werkzeugen wollen:
- jedes Projekt ist schon ein echtes Git-Repository (kein vergessenes
git init) - automatische Checkpoints nach erfolgreichen Kompilierläufen und bei Bearbeitungspausen
- Bereitstellen, Diff nebeneinander, Verwerfen und Wiederherstellen mit einem Klick in derselben App wie Editor und PDF
- GitHub optional für Remotes; der Verlauf funktioniert schon auf der Festplatte
- ein ganzes Projekt mit vollständigem Verlauf für ein paralleles Experiment forken (riskante Überarbeitung der Methoden, alternativer Lebenslauf), während die Einreichungskopie unberührt bleibt
- KI-Änderungen, falls Sie sie aktivieren, setzen zuerst einen Checkpoint und kommen nur über Diffs zur Freigabe an
Oleafly (öffnet in einem neuen Tab) ist so gebaut:
gewöhnliche Ordner, ein echtes .git, automatische Checkpoints, die die
geänderten Dateien nennen, ein Panel „Versionsverwaltung“ mit bearbeitbaren Diffs
des Arbeitsverzeichnisses, Wiederherstellen nach Bestätigung, optionales
GitHub-Veröffentlichen/Pushen/Pullen mit Anzeige von voraus/zurück, Projekt-Fork
mit Abstammung in der Bibliothek. Das git log im Terminal stimmt mit der App
überein, weil es dasselbe Repository ist. Der KI-Checkpoint, wenn Sie einen
nutzen, landet in demselben Verlauf, aus dem Sie wiederherstellen.
Teile davon lassen sich mit einer sorgfältigen Gewohnheit und einem separaten Git-Client nachbilden. Der Unterschied ist, ob der Verlauf etwas ist, das Sie einrichten und an das Sie denken müssen, oder etwas, das der Forschungs-Workspace am ersten Tag neben SyncTeX und Kompilieren voraussetzt.
Was Git nicht löst
Git ersetzt keine Kommentare von Projektleitern, die nur PDFs öffnen, und es entscheidet nicht, wessen Abstract richtig ist. Binäre Abbildungen lassen sich weiterhin schlecht zusammenführen, halten Sie sie also klein, bevorzugen Sie Plots, die Sie neu erzeugen können, und klären Sie die Zuständigkeit früh.
Für Koautoren, die Git ablehnen, exportieren Sie PDF oder DOCX zur Durchsicht und
behalten .tex als maßgebliche Quelle. Siehe
Koautoren, die nur Word sprechen.
Eine minimale Praxis
- Ein Repository pro Aufsatz oder Abschlussarbeit, nicht ein Mega-Repository für Ihre ganze Laufbahn.
.gitignorefür Build-Müll am ersten Tag.- Zuständigkeit nach Kapitel, wenn mehr als eine Person bearbeitet.
- Meilenstein-Commits mit lesbaren Nachrichten.
- Privates Remote verbunden, bevor die Arbeit wichtig wird.
- Das Wiederherstellen einmal absichtlich getestet, damit der erste Notfall nicht die erste Wiederherstellung ist.
Wenn Sie sich an diese Liste halten, tritt Git für Aufsätze größtenteils in den Hintergrund. Vor einer Frist wollen Sie langweilige Verlässlichkeit, kein zweites Hobby.