Zum Hauptinhalt springen
Verbinden Sie ein Projekt mit einem GitLab-Repository. Änderungen fließen in beide Richtungen, und zwar nur, wenn Sie auf Sync klicken: Nichts wird von selbst synchronisiert.
Ein Administrator muss zuerst die GitLab-Synchronisierung aktivieren.
Das tun Sie nur einmal.
1

Kontoeinstellungen öffnen

Klicken Sie auf Account und dann auf Account settings. Suchen Sie unter Project synchronisation nach GitLab und klicken Sie auf Link.
Der Abschnitt GitLab der Kontoeinstellungen mit der Schaltfläche Link

GitLab in den Kontoeinstellungen

2

Auf GitLab autorisieren

GitLab öffnet sich. Melden Sie sich an, falls Sie dazu aufgefordert werden, und autorisieren Sie dann die Anwendung.
3

Verknüpfung prüfen

Sie sind zurück in den Kontoeinstellungen. Eine grüne Meldung bestätigt, dass Ihr GitLab-Konto verknüpft ist, und die Schaltfläche heißt jetzt Unlink.
Der Abschnitt GitLab der Kontoeinstellungen mit der Schaltfläche Unlink

Ihr GitLab-Konto ist verknüpft

Wenn Ihr Konto noch nicht verknüpft ist, fordern Import from GitLab und die Karte GitLab im Editor Sie auf, es zuerst zu verknüpfen. Klicken Sie auf Link to your GitLab account. Auch so landen Sie in den Kontoeinstellungen, in einem neuen Tab, wenn Sie im Editor begonnen haben. Gehen Sie dann zurück und beginnen Sie erneut.
Der Dialog Import from GitLab mit der Schaltfläche Link to your GitLab account

Die Aufforderung, wenn Ihr Konto nicht verknüpft ist

Ein Repository importieren

Dadurch entsteht aus einem GitLab-Repository ein neues Projekt, das bereits mit ihm verknüpft ist.
1

Importdialog öffnen

Klicken Sie auf der Projektseite auf New project und dann auf Import from GitLab.
Das Menü New project mit Import from GitLab

Das Menü New project

2

Repository auswählen

Klicken Sie neben dem Repository auf Import to Overleaf. Die Liste enthält Ihre Repositories und die Ihrer Gruppen.
Der Dialog Import from GitLab mit vier Repositories

Ihre GitLab-Repositories

3

Projekt prüfen

Das neue Projekt öffnet sich mit den Dateien des Repositorys.
Der Editor mit dem importierten Projekt, seinen Dateien und dem kompilierten PDF

Das importierte Projekt

Ein Projekt in ein neues Repository exportieren

Dadurch entsteht aus einem Projekt ein Repository, und beide werden verknüpft. Ein Projekt lässt sich nur auf diese Weise oder durch Importieren verknüpfen: Sie können es nicht mit einem bereits vorhandenen Repository verknüpfen.
1

GitLab im Editor öffnen

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

Das Panel Integrations

2

Repository ausfüllen

Wählen Sie den Owner, also Sie selbst oder eine Ihrer Gruppen. Wenn Sie eine Gruppe wählen, heißt dieses Feld Organization. Repository Name ist anfangs der Name des Projekts. Die Beschreibung ist optional, und Private ist standardmäßig ausgewählt. Klicken Sie auf Create a GitLab repository.
Das ausgefüllte Formular Export Project to GitLab

Export Project to GitLab

Wenn der Name bereits vergeben ist, zeigt der Dialog Please check that the repository name is valid, and that you have permission to create the repository. Ändern Sie den Namen und klicken Sie erneut auf die Schaltfläche.
3

Verknüpfung prüfen

Der Dialog zeigt jetzt This project is linked to und nennt das Repository.
Der Dialog Sync with GitLab nach dem Export

Das Projekt ist verknüpft

Synchronisieren

1

Synchronisierungsdialog öffnen

Öffnen Sie ein verknüpftes Projekt. Klicken Sie in der linken Leiste auf Integrations und dann auf GitLab.Recent commits in GitLab listet auf, was in das Projekt kommen wird.
Der Dialog Sync with GitLab mit einem neuen Commit

Ein neuer Commit wartet in GitLab

2

Ihre Änderungen beschreiben

Wenn Sie im Projekt etwas geändert haben, erscheint ein Feld für die Commit-Nachricht. Es ist optional: Wenn Sie es leer lassen, heißt der Commit Updates from Overleaf.
Der Dialog Sync with GitLab mit ausgefüllter Commit-Nachricht

Die Commit-Nachricht für Ihre Änderungen

3

Auf Sync klicken

Klicken Sie auf Sync. Neue Commits aus GitLab kommen in das Projekt, und Ihre Änderungen gehen in den Standard-Branch des Repositorys. Wenn beide Seiten Unterschiedliches geändert haben, werden die Änderungen für Sie zusammengeführt.
4

Ergebnis prüfen

Der Dialog zeigt No new commits in GitLab since last merge., und das Feld für die Commit-Nachricht ist verschwunden. Die Dateien im Editor und die Commits auf GitLab sind auf dem neuesten Stand.
Der Dialog Sync with GitLab nach der Synchronisierung, ohne neue Commits

Alles ist synchron

Wenn sich auf beiden Seiten dieselben Zeilen geändert haben

Der Dialog meldet, dass die Änderungen nicht zusammengeführt werden konnten, und nennt einen neuen Branch, overleaf-YYYY-MM-DD-HHMMSS, der Ihre Änderungen enthält. Overleaf öffnet außerdem auf GitLab einen Merge Request aus diesem Branch.
Der Dialog Sync with GitLab mit einer Warnung zu einem Merge-Konflikt

Ein Konflikt

  1. Führen Sie diesen Branch auf GitLab oder mit Git in den Standard-Branch zusammen. Sie können den Dialog in der Zwischenzeit schließen: Er zeigt dieselbe Meldung, wenn Sie ihn wieder öffnen.
  2. Klicken Sie auf I have manually merged. Continue. Das zusammengeführte Ergebnis kommt in das Projekt. Wenn Sie darauf klicken, bevor der Branch zusammengeführt ist, bleibt der Dialog unverändert.
  3. Der Branch bleibt auf GitLab, sofern Sie ihn beim Zusammenführen nicht gelöscht haben. Löschen Sie ihn, wenn Sie ihn nicht mehr brauchen.
Derselbe Dialog erscheint, wenn die Merge-Regeln des Repositorys den Merge Request zurückhalten, etwa weil er eine Freigabe braucht, auch wenn keine Zeilen in Konflikt stehen. Sobald die Regel es erlaubt, führen Sie den Merge Request auf GitLab zusammen und klicken auf I have manually merged. Continue. Siehe So funktioniert die Synchronisierung mit GitLab. Tun Sie das, wenn das Projekt nicht mehr synchronisiert werden soll.
1

Auf Unlink klicken

Klicken Sie im Synchronisierungsdialog auf Unlink.
2

Bestätigen

Klicken Sie auf Confirm. Dadurch wird nur die Verknüpfung entfernt: Die Verbindung mit einem Repository, das Ihnen gehört, die in der Warnung erwähnt wird, ist eine Möglichkeit, die Sie danach haben, nicht etwas, das jetzt geschieht.
Der Dialog Sync with GitLab mit der Bitte, das Aufheben der Verknüpfung zu bestätigen

Aufheben der Verknüpfung bestätigen

3

Ergebnis prüfen

Der Dialog zeigt jetzt Export Project to GitLab. Projekt und Repository behalten beide ihren Inhalt. Um wieder zu synchronisieren, exportieren Sie das Projekt in ein neues Repository oder importieren Sie das Repository in ein neues Projekt.
Klicken Sie in Account settings unter GitLab auf Unlink und dann im Dialog erneut auf Unlink.
Der Dialog Unlink GitLab Account

Verknüpfung Ihres Kontos aufheben

Ihre Projekte bleiben mit ihren Repositories verknüpft. Sie können sie erst wieder synchronisieren, wenn Sie Ihr Konto erneut verknüpfen.
Wer in einem geteilten Projekt was tun kann, erfahren Sie unter Wer verknüpfen und synchronisieren kann.
Zuletzt geändert am 20. November 2026