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

# Intégration Git

> Créez un jeton d'accès, clonez un projet avec Git, puis effectuez des pull et des push.

Travaillez sur un projet depuis votre propre ordinateur avec Git. Les modifications ne sont transférées que lorsque vous exécutez `git pull` ou `git push`.

> [!NOTE]
>
> Un administrateur doit d'abord activer l'[intégration Git](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Créer un jeton

Git se connecte avec un jeton d'authentification Git, et non avec le mot de passe de votre compte.

**1. Ouvrir les paramètres de votre compte**

Cliquez sur **Account**, puis sur **Account settings**. Sous **Git integration**, cliquez sur **Generate token**. Une fois que vous avez un jeton, ce bouton s'appelle **Add another token**.

![La section Git integration des paramètres du compte avec un bouton 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)

L'intégration Git dans les paramètres du compte

**2. Copier le jeton**

Cliquez sur **Copy** et conservez le jeton en lieu sûr. Vous ne le voyez qu'une seule fois. Cliquez ensuite sur **Close**.

![La boîte de dialogue du jeton d'authentification Git avec un bouton Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Votre nouveau jeton

**3. Vérifier le jeton**

La liste affiche maintenant le début du jeton, sa date de création et sa dernière utilisation. Il expire au bout d'un an. Vous pouvez avoir jusqu'à 10 jetons.

![La liste des jetons avec un jeton](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Vos jetons

## Cloner un projet

**1. Ouvrir l'intégration Git dans l'éditeur**

Ouvrez le projet. Dans la barre de gauche, cliquez sur **Integrations**, puis sur **Git integration**.

![Le panneau Integrations avec la carte 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)

Le panneau Integrations

**2. Copier la commande**

La boîte de dialogue **Clone with Git** affiche la commande, avec l'adresse de votre site et l'ID du projet. Cliquez sur **Copy**. Si vous n'avez pas encore de jeton, **Go to settings** ouvre les paramètres de votre compte dans un nouvel onglet.

![La boîte de dialogue Clone with Git avec la commande 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)

La commande de clonage

**3. L'exécuter**

Collez la commande dans un terminal. Lorsque Git demande un mot de passe, collez votre jeton.

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

Un dossier portant l'ID du projet contient maintenant les fichiers du projet, sur la branche `main`. Pour choisir le nom du dossier, ajoutez-le à la fin de la commande.

Git demande le jeton chaque fois qu'il contacte le site. Pour qu'il soit mémorisé, activez un credential helper : Git le demande une dernière fois, puis le conserve. Le helper `store` le conserve non chiffré dans `~/.git-credentials`.

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

## Récupérer les modifications de l'éditeur

Dans le dossier, exécutez :

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

Git liste les fichiers modifiés. Les modifications faites dans l'éditeur arrivent sous forme de commits nommés `Update on Overleaf.`.

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

## Envoyer vos modifications

Faites un commit de vos modifications, puis envoyez-les avec push :

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

La dernière ligne de la sortie indique la branche qui a avancé :

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

Les modifications apparaissent dans l'éditeur, et un éditeur ouvert se met à jour de lui-même. Les nouveaux fichiers, dossiers et renommages apparaissent dans l'arborescence des fichiers. Dans **History**, votre modification est marquée **You (via Git)**. Votre message de commit n'y est pas affiché.

![L'historique du projet affichant la ligne envoyée, marquée 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)

Un push dans l'historique du projet

### Si Git refuse votre push

Si le projet a changé entre-temps, Git rejette le push :

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

Récupérez d'abord ces modifications, puis renvoyez :

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

Un simple `git pull` peut s'arrêter avec `fatal: Need to specify how to reconcile divergent branches.` L'option `--no-rebase` ci-dessus y répond : elle fusionne les deux côtés.

Si les mêmes lignes ont changé des deux côtés, le pull s'arrête avec `CONFLICT (content): Merge conflict in main.tex`. Corrigez le fichier, puis :

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

Le site n'accepte pas deux choses :

* Les autres branches : `! [remote rejected] feature -> feature (wrong branch)`. Seule `main` existe, envoyez donc votre travail sur celle-ci.
* Les force push : `! [remote rejected] main -> main (forced push prohibited)`. Placez plutôt vos modifications par-dessus la `main` actuelle.

### Si Git affiche Authentication failed

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

Le jeton est erroné ou a été supprimé, ou vous avez saisi le mot de passe de votre compte. Créez un nouveau jeton si vous ne l'avez plus, car vous ne pouvez pas revoir un jeton existant.

## Supprimer un jeton

Dans **Account settings**, sous **Git integration**, cliquez sur l'icône de suppression à côté du jeton, puis sur **Delete** dans la boîte de dialogue. Dès lors, Git répond `Authentication failed` à ce jeton.

![La boîte de dialogue 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)

Supprimer un jeton

> [!NOTE]
>
> Pour savoir ce que peuvent faire les collaborateurs en lecture seule, consultez le Q\&A de l'[intégration Git](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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