Zum Hauptinhalt springen
Bearbeiten Sie ein Projekt mit Git auf Ihrem eigenen Computer. Änderungen werden nur übertragen, wenn Sie git pull oder git push ausführen.
Ein Administrator muss zuerst die Git-Integration aktivieren.

Ein Token erstellen

Git meldet sich mit einem Git-Authentifizierungstoken an, nicht mit Ihrem Kontopasswort.
1

Kontoeinstellungen öffnen

Klicken Sie auf Account und dann auf Account settings. Klicken Sie unter Git integration auf Generate token. Sobald Sie ein Token haben, heißt diese Schaltfläche Add another token.
Der Abschnitt Git integration der Kontoeinstellungen mit der Schaltfläche Generate token

Git-Integration in den Kontoeinstellungen

2

Token kopieren

Klicken Sie auf Copy und bewahren Sie das Token an einem sicheren Ort auf. Sie sehen es nur einmal. Klicken Sie dann auf Close.
Der Dialog mit dem Git-Authentifizierungstoken und der Schaltfläche Copy

Ihr neues Token

3

Token prüfen

Die Liste zeigt jetzt den Anfang des Tokens, wann es erstellt und wann es zuletzt verwendet wurde. Es läuft nach einem Jahr ab. Sie können bis zu 10 Tokens haben.
Die Liste der Tokens mit einem Token

Ihre Tokens

Ein Projekt klonen

1

Git-Integration im Editor öffnen

Öffnen Sie das Projekt. Klicken Sie in der linken Leiste auf Integrations und dann auf Git integration.
Das Panel Integrations mit der Karte Git integration

Das Panel Integrations

2

Befehl kopieren

Der Dialog Clone with Git zeigt den Befehl mit der Adresse Ihrer Website und der ID des Projekts. Klicken Sie auf Copy. Wenn Sie noch kein Token haben, öffnet Go to settings Ihre Kontoeinstellungen in einem neuen Tab.
Der Dialog Clone with Git mit dem Befehl git clone

Der Klon-Befehl

3

Befehl ausführen

Fügen Sie den Befehl in ein Terminal ein. Wenn Git nach einem Passwort fragt, fügen Sie Ihr Token ein.
Ein Ordner, der nach der Projekt-ID benannt ist, enthält jetzt die Dateien des Projekts auf dem Branch main. Um den Namen des Ordners selbst zu wählen, hängen Sie ihn an das Ende des Befehls an.
Git fragt bei jeder Verbindung mit der Website nach dem Token. Damit es gespeichert wird, aktivieren Sie einen Credential Helper: Git fragt noch einmal und behält das Token dann. Der Helper store speichert es unverschlüsselt in ~/.git-credentials.

Änderungen aus dem Editor abrufen

Führen Sie im Ordner Folgendes aus:
Git listet die geänderten Dateien auf. Änderungen aus dem Editor kommen als Commits mit dem Namen Update on Overleaf. an.

Ihre Änderungen hochladen

Committen Sie Ihre Änderungen und pushen Sie sie dann:
Die letzte Zeile der Ausgabe zeigt den Branch, der sich bewegt hat:
Die Änderungen erscheinen im Editor, und ein geöffneter Editor aktualisiert sich von selbst. Neue Dateien, Ordner und Umbenennungen erscheinen im Dateibaum. In History ist Ihre Änderung mit You (via Git) markiert. Ihre Commit-Nachricht wird dort nicht angezeigt.
Der Projektverlauf mit der gepushten Zeile, markiert mit You (via Git)

Ein Push im Projektverlauf

Wenn Git Ihren Push ablehnt

Wenn sich das Projekt in der Zwischenzeit geändert hat, lehnt Git den Push ab:
Holen Sie zuerst diese Änderungen und pushen Sie dann erneut:
Ein einfaches git pull kann mit fatal: Need to specify how to reconcile divergent branches. abbrechen. Die Option --no-rebase oben beantwortet das: Sie führt die beiden Seiten zusammen. Wenn sich auf beiden Seiten dieselben Zeilen geändert haben, stoppt der Pull mit CONFLICT (content): Merge conflict in main.tex. Korrigieren Sie die Datei und führen Sie dann aus:
Zwei Dinge akzeptiert die Website nicht:
  • Andere Branches: ! [remote rejected] feature -> feature (wrong branch). Es gibt nur main, also pushen Sie Ihre Arbeit dorthin.
  • Force Pushes: ! [remote rejected] main -> main (forced push prohibited). Setzen Sie Ihre Änderungen stattdessen auf den aktuellen Stand von main.

Wenn Git Authentication failed meldet

Das Token ist falsch oder wurde gelöscht, oder Sie haben Ihr Kontopasswort eingegeben. Erstellen Sie ein neues Token, wenn Sie es nicht mehr haben, denn ein vorhandenes Token können Sie nicht erneut ansehen.

Ein Token löschen

Klicken Sie in Account settings unter Git integration auf das Löschsymbol neben dem Token und dann im Dialog auf Delete. Danach antwortet Git auf dieses Token mit Authentication failed.
Der Dialog Delete Authentication token

Ein Token löschen

Was Mitarbeitende mit reinem Lesezugriff tun können, erfahren Sie im Q&A der Git-Integration.
Zuletzt geändert am 20. November 2026