Git für LaTeX

Verlauf, Vergleich und Wiederherstellung: Versionieren Sie Ihre LaTeX-Projekte auf BlaBLaTeX.

BlaBLaTeX integriert Git für LaTeX, um den Verlauf, die Versionen und die Nachvollziehbarkeit Ihrer Projekte zu verwalten. Sie können ein Projekt klonen, lokal arbeiten (Editor, Skripte), und anschließend pushen, damit Ihre Änderungen automatisch im Workspace erscheinen. Sie können auch von einem bereits vorhandenen lokalen Git-Repository ausgehen und es mit einem BlaBLaTeX-Projekt verbinden.

Das Wichtigste auf einen Blick

Git-URL finden · Schnellstart · Bereits vorhandenes lokales Repository · Empfohlener Workflow · Dokumentation

Zurückgehen

Stellen Sie eine stabile Version (Commit) wieder her, ohne Dateien mehrfach zu kopieren.

Vergleichen

Erkennen Sie Unterschiede zwischen zwei Versionen (Diff) und validieren Sie eine Korrektur.

Nachverfolgen

Klare Historie: wer hat was, wann und warum geändert (Commit-Nachricht).

Teilen

Synchronisieren Sie vom und zum BlaBLaTeX-Workspace für Review und Teamarbeit.

Schritt 1

Die Git-URL Ihres BlaBLaTeX-Projekts finden

Jedes BlaBLaTeX-Projekt besitzt eine eigene Git-URL, die aus der Kennung in der Workspace-URL aufgebaut wird:

  • Workspace: https://workspace.blablatex.com/project/<PROJEKT_ID>
  • Git: https://git.blablatex.com/project/<PROJEKT_ID>.git
Workspace : https://workspace.blablatex.com/project/6940036c696502c3fc2d49dc
Git       : https://git.blablatex.com/project/6940036c696502c3fc2d49dc.git

Wenn Sie Git bereits verwenden: merken Sie sich einfach clone, pull und push.

Schritt 2

Schnellstart: klonen, ändern, senden

Kopieren Sie die Git-URL Ihres Projekts (siehe oben) und führen Sie dann aus: 

# 1) Projekt klonen
git clone https://git.blablatex.com/project/<PROJEKT_ID>.git
cd <projektordner>

# 2) Status prüfen
git status
git log --oneline -n 10

# 3) Ändern und an BlaBLaTeX senden
git add -A
git commit -m "Dokument aktualisiert"
git push

Nach git push werden die Dateien automatisch aktualisiert und im BlaBLaTeX-Workspace angezeigt.

Schritt 3

Von einem bereits vorhandenen lokalen Git-Repository ausgehen

Wenn Ihr Projekt bereits lokal versioniert ist, können Sie es direkt mit BlaBLaTeX verbinden. Erstellen Sie zunächst ein BlaBLaTeX-Projekt, übernehmen Sie dessen Kennung und fügen Sie dann den entsprechenden Remote hinzu.

Wenn Ihr lokaler Branch main heißt: 

git remote add blablatex https://git.blablatex.com/project/<PROJEKT_ID>.git
git push blablatex main

Wenn Ihr lokaler Branch master heißt: 

git remote add blablatex https://git.blablatex.com/project/<PROJEKT_ID>.git
git push blablatex master

Beim ersten Senden wird das BlaBLaTeX-Projekt mit dem Inhalt Ihres lokalen Repositorys initialisiert.

Best Practices

Empfohlener Workflow (Git ↔ BlaBLaTeX)

Wenn Sie das Projekt gelegentlich direkt in der BlaBLaTeX-Oberfläche bearbeiten, holen Sie zuerst die Änderungen, bevor Sie pushen: 

# Vor dem Arbeiten
git pull

# Lokale Änderungen
git add -A
git commit -m "Klare Beschreibung der Änderungen"

# An BlaBLaTeX senden
git push

Wenn Sie einen Remote mit dem Namen blablatex verwenden

Um Änderungen ausdrücklich von BlaBLaTeX zu holen: 

# Lokaler Branch main
git pull blablatex main

# Lokaler Branch master
git pull blablatex master

Verwenden Sie die Befehle, die zu dem Branch passen, den Sie lokal benutzen.

Was Sie damit tun können

Wofür ist Git für LaTeX auf BlaBLaTeX nützlich?

Einen Bericht, eine Dissertation oder einen Artikel versionieren

Behalten Sie einen sauberen Verlauf von main.tex, Kapiteln, Bildern und Bibliografie und kehren Sie jederzeit zu einer stabilen Version zurück.

Mit Ihren eigenen Werkzeugen arbeiten

Lokaler Editor, Skripte, Automatisierung, CI … und trotzdem bleibt BlaBLaTeX die zentrale Quelle.

Zusammenarbeiten, ohne Dateien zu vervielfachen

Der Commit wird zu Ihrem Kontrollpunkt: klare Nachricht, Nachvollziehbarkeit, einfachere Review.

Änderungen vergleichen

Verstehen Sie schnell, was sich zwischen zwei Versionen geändert hat – dank git diff und Verlauf.