> ## 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.

# Git-Integration

> Erstellen Sie ein Zugriffstoken, klonen Sie ein Projekt mit Git und führen Sie dann Pull und Push aus.

Bearbeiten Sie ein Projekt mit Git auf Ihrem eigenen Computer. Änderungen werden nur übertragen, wenn Sie `git pull` oder `git push` ausführen.

> [!NOTE]
>
> Ein Administrator muss zuerst die [Git-Integration](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md) 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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-settings.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4ff1f16eb46266f7bf31956bf3b9d89)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-panel.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=3fb82c63ba8d205191eadb5015bdefb5)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-clone.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f6d69046df7caf4cbee07f49e8dd6540)

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.

```text theme={null}
$ git clone https://git@<your-site>/git/<project-id>
Cloning into '<project-id>'...
Password for 'https://git@<your-site>': <your-token>
```

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`.

```bash theme={null}
git config --global credential.helper store
```

## Änderungen aus dem Editor abrufen

Führen Sie im Ordner Folgendes aus:

```bash theme={null}
git pull
```

Git listet die geänderten Dateien auf. Änderungen aus dem Editor kommen als Commits mit dem Namen `Update on Overleaf.` an.

```text theme={null}
Updating db007e3..c3e6332
Fast-forward
 main.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
```

## Ihre Änderungen hochladen

Committen Sie Ihre Änderungen und pushen Sie sie dann:

```bash theme={null}
git add main.tex
git commit -m "Add a line from Git"
git push
```

Die letzte Zeile der Ausgabe zeigt den Branch, der sich bewegt hat:

```text theme={null}
   53aca61..db007e3  main -> main
```

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)](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-history.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f4d5575612ebd75db3656cac1ea495)

Ein Push im Projektverlauf

### Wenn Git Ihren Push ablehnt

Wenn sich das Projekt in der Zwischenzeit geändert hat, lehnt Git den Push ab:

```text theme={null}
 ! [rejected]        main -> main (fetch first)
```

Holen Sie zuerst diese Änderungen und pushen Sie dann erneut:

```bash theme={null}
git pull --no-rebase --no-edit
git push
```

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:

```bash theme={null}
git add main.tex
git commit -m "Merge the changes from the editor"
git push
```

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

```text theme={null}
remote: Enter your Git authentication token when prompted for a password.
fatal: Authentication failed for 'https://<your-site>/git/<project-id>/'
```

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-delete-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=1708062228778239c6465b0369614a18)

Ein Token löschen

> [!NOTE]
>
> Was Mitarbeitende mit reinem Lesezugriff tun können, erfahren Sie im Q\&A der [Git-Integration](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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