> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gitea-Synchronisierung

> Verknüpfen Sie Ihr Gitea-Konto, importieren oder exportieren Sie ein Projekt, synchronisieren Sie Änderungen in beide Richtungen und heben Sie die Verknüpfung auf.

Verbinden Sie ein Projekt mit einem Gitea-Repository. Änderungen fließen in beide Richtungen, und zwar nur, wenn Sie auf **Sync** klicken: Nichts wird von selbst synchronisiert.

> [!NOTE]
>
> Ein Administrator muss zuerst die [Gitea-Synchronisierung](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md) aktivieren.

## Ihr Gitea-Konto verknüpfen

Das tun Sie nur einmal.

**1. Kontoeinstellungen öffnen**

Klicken Sie auf **Account** und dann auf **Account settings**. Suchen Sie unter **Project synchronisation** nach **Gitea** und klicken Sie auf **Link**.

![Der Abschnitt Gitea der Kontoeinstellungen mit der Schaltfläche Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5514bcd66b524c3dde2376db09935feb)

Gitea in den Kontoeinstellungen

**2. Auf Gitea autorisieren**

Gitea ö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 Gitea-Konto verknüpft ist, und die Schaltfläche heißt jetzt **Unlink**.

![Der Abschnitt Gitea der Kontoeinstellungen mit der Schaltfläche Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b0eb94a11ff546a6770d4f5a8b5250de)

Ihr Gitea-Konto ist verknüpft

Wenn Ihr Konto noch nicht verknüpft ist, fordern **Import from Gitea** und die Karte **Gitea** im Editor Sie auf, es zuerst zu verknüpfen. Klicken Sie auf **Link to your Gitea 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 Gitea mit der Schaltfläche Link to your Gitea account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b9f6e8fc7d3aa2d3328423f660de5a9c)

Die Aufforderung, wenn Ihr Konto nicht verknüpft ist

## Ein Repository importieren

Dadurch entsteht aus einem Gitea-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 Gitea**.

![Das Menü New project mit Import from Gitea](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=de3258081da7ec5af1083ae6c127d510)

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 Organisationen. Ein leeres Repository wird nicht aufgeführt: Es braucht mindestens einen Commit.

![Der Dialog Import from Gitea mit vier Repositories](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=9b8c86ed6705efddab590e0e8f62892c)

Ihre Gitea-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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=bd72f7c7594e0f80e0966d4691598db3)

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. Gitea im Editor öffnen**

Öffnen Sie das Projekt. Klicken Sie in der linken Leiste auf **Integrations** und dann auf **Gitea**.

![Das Panel Integrations mit der Karte Gitea](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=12710e50eecf8f3b385565c85b4a45a4)

Das Panel Integrations

**2. Repository ausfüllen**

Wählen Sie den **Owner**, also Sie selbst oder eine Ihrer Organisationen. Wenn Sie eine Organisation wählen, heißt dieses Feld **Organization**. **Repository Name** ist anfangs der Name des Projekts: Wenn dieser Name Leerzeichen enthält, ändern Sie ihn, denn Gitea akzeptiert keine. Die Beschreibung ist optional, und **Private** ist standardmäßig ausgewählt. Klicken Sie auf **Create a Gitea repository**.

![Das ausgefüllte Formular Export Project to Gitea](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=867cf2d205d151a87dd35529b4e40d56)

Export Project to Gitea

Wenn der Name Leerzeichen enthält oder 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 Gitea nach dem Export](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=aa8d526d60f9733ba1885e73621ab8d6)

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 **Gitea**.

**Recent commits in Gitea** listet auf, was in das Projekt kommen wird.

![Der Dialog Sync with Gitea mit einem neuen Commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=0403560179cb63a6b5d3853f4590e6a5)

Ein neuer Commit wartet in Gitea

**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 Gitea mit ausgefüllter Commit-Nachricht](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=014cd300d4deff341310920221c63a30)

Die Commit-Nachricht für Ihre Änderungen

**3. Auf Sync klicken**

Klicken Sie auf **Sync**. Neue Commits aus Gitea 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 über einen Pull Request zusammengeführt, der als Nachweis auf Gitea bleibt.

**4. Ergebnis prüfen**

Der Dialog zeigt **No new commits in Gitea since last merge.**, und das Feld für die Commit-Nachricht ist verschwunden. Die Dateien im Editor und die Commits auf Gitea sind auf dem neuesten Stand.

![Der Dialog Sync with Gitea nach der Synchronisierung, ohne neue Commits](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=7a53483772e17e5ad75d5ceb7f44e34e)

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 Gitea einen Pull Request aus diesem Branch.

![Der Dialog Sync with Gitea mit einer Warnung zu einem Merge-Konflikt](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=9acaf32d0930decd2cfce516037a37b1)

Ein Konflikt

1. Führen Sie diesen Branch mit Git in den Standard-Branch zusammen und beheben Sie den Konflikt. Sie können den Dialog in der Zwischenzeit schließen: Er zeigt dieselbe Meldung, wenn Sie ihn wieder öffnen.

   ```bash theme={null}
   git clone <repository-address>
   cd <repository-name>
   git merge origin/overleaf-YYYY-MM-DD-HHMMSS
   # fix the conflict in the file Git names
   git add <file>
   git commit
   git push
   ```
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 Gitea, und sein Pull Request bleibt offen. Schließen Sie den Pull Request und löschen Sie den Branch, wenn Sie sie nicht mehr brauchen.

Derselbe Dialog erscheint, wenn eine Branch-Schutzregel den Pull Request zurückhält, etwa weil er eine Freigabe braucht, auch wenn keine Zeilen in Konflikt stehen. Sobald die Regel es erlaubt, führen Sie den Pull Request auf Gitea zusammen und klicken auf **I have manually merged. Continue**. Siehe [So funktioniert die Synchronisierung mit Gitea](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#how-syncing-works-with-gitea).

## Die Verknüpfung eines Projekts aufheben

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 Gitea mit der Bitte, das Aufheben der Verknüpfung zu bestätigen](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=796d5581463a481fed1772d6695430d1)

Aufheben der Verknüpfung bestätigen

**3. Ergebnis prüfen**

Der Dialog zeigt jetzt **Export Project to Gitea**. 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.

## Die Verknüpfung Ihres Gitea-Kontos aufheben

Klicken Sie in **Account settings** unter **Gitea** auf **Unlink** und dann im Dialog erneut auf **Unlink**.

![Der Dialog Unlink Gitea Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3995614c688a587c031de666d71ce64)

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.

> [!NOTE]
>
> Wer in einem geteilten Projekt was tun kann, erfahren Sie unter [Wer verknüpfen und synchronisieren kann](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#who-can-link-and-sync).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.