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

# Synchronisation GitHub

> Liez votre compte GitHub, importez ou exportez un projet, synchronisez les modifications dans les deux sens et supprimez le lien.

Connectez un projet à un dépôt GitHub. Les modifications circulent dans les deux sens, et uniquement lorsque vous cliquez sur **Sync** : rien ne se synchronise tout seul.

> [!NOTE]
>
> Si vous ne voyez aucune option GitHub dans **Account settings** ni dans l'éditeur, demandez à votre administrateur d'activer la [synchronisation GitHub](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md).

## Lier votre compte GitHub

Vous ne le faites qu'une fois.

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

Cliquez sur **Account**, puis sur **Account settings**. Faites défiler jusqu'à **GitHub** et cliquez sur **Link**.

![La section GitHub des paramètres du compte avec un bouton Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8812ab1604914a8aa6c1f0937f0e1b2e)

GitHub dans les paramètres du compte

**2. Autoriser sur GitHub**

GitHub s'ouvre. Connectez-vous si on vous le demande, puis autorisez l'application.

**3. Vérifier le lien**

Vous revenez aux paramètres du compte, et le bouton indique maintenant **Unlink**.

![La section GitHub des paramètres du compte avec un bouton Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=910b756aa0adea66bda5bb2e5776214e)

Votre compte GitHub est lié

Si votre compte n'est pas encore lié, **Import from GitHub** et la carte **GitHub** de l'éditeur vous demandent d'abord de le lier. Cliquez sur **Link to your GitHub account**. Vous arrivez également dans les paramètres du compte, dans un nouvel onglet si vous étiez dans l'éditeur. Revenez ensuite en arrière et recommencez.

![La boîte de dialogue Import from GitHub avec un bouton Link to your GitHub account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=05546893169a57f837a8938f904db194)

L'invite lorsque votre compte n'est pas lié

## Importer un dépôt

Cela crée un nouveau projet à partir d'un dépôt GitHub, déjà lié à celui-ci.

**1. Ouvrir la boîte de dialogue d'importation**

Sur la page des projets, cliquez sur **New project**, puis sur **Import from GitHub**.

![Le menu New project avec Import from GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=384e6663f982016a5c295f35c4709413)

Le menu New project

> [!NOTE]
>
> **New project** apparaît dès que vous avez un projet. Le menu **Create a new project** de la page d'accueil ne propose pas d'importation : créez donc d'abord un projet vide.

**2. Choisir le dépôt**

Cliquez sur **Import to Overleaf** à côté du dépôt. La liste contient vos dépôts et ceux de vos organisations.

![La boîte de dialogue Import from GitHub listant quatre dépôts](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=54a0bd11655ddbfad4ae16e5e7473b74)

Vos dépôts GitHub

S'il manque le dépôt d'une organisation, cliquez sur **Can't see what you're looking for?** pour consulter l'aide de GitHub sur l'approbation de l'application pour cette organisation.

**3. Vérifier le projet**

Le nouveau projet s'ouvre avec les fichiers du dépôt.

![L'éditeur affichant le projet importé avec ses fichiers et le PDF compilé](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=90dfe6947c2e0ed420abfc8c81992768)

Le projet importé

## Exporter un projet vers un nouveau dépôt

Cela crée un dépôt à partir d'un projet dont vous êtes propriétaire et les lie. Un projet ne peut être lié que de cette façon ou par importation : vous ne pouvez pas le lier à un dépôt qui existe déjà.

**1. Ouvrir GitHub dans l'éditeur**

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

![Le panneau Integrations avec la carte GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5c96ec0031a5940c337393254b06e0d3)

Le panneau Integrations

**2. Renseigner le dépôt**

Choisissez l'**Owner**, qui peut être vous ou l'une de vos organisations. **Repository Name** reprend au départ le nom du projet. La description est facultative, et **Private** est sélectionné par défaut. Cliquez sur **Create a GitHub repository**.

![Le formulaire Export Project to GitHub rempli](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=24bd26a171943d43efaa3c4aed69d1e8)

Export Project to GitHub

**3. Vérifier le lien**

La boîte de dialogue indique maintenant **This project is linked to** et nomme le dépôt.

![La boîte de dialogue Sync with GitHub après l'exportation](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=93ebf2c62d4a34c7d2c41ffbca9d0740)

Le projet est lié

## Synchroniser

**1. Ouvrir la boîte de dialogue de synchronisation**

Ouvrez un projet lié. Dans la barre de gauche, cliquez sur **Integrations**, puis sur **GitHub**.

**Recent commits in GitHub** liste ce qui va arriver dans le projet.

![La boîte de dialogue Sync with GitHub listant un nouveau commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6a3c23a6993f04d0fa818bceb565ce3e)

Un nouveau commit en attente sur GitHub

**2. Décrire vos modifications**

Si vous avez modifié quelque chose dans le projet, un champ de message de commit apparaît. Il est facultatif : si vous le laissez vide, le commit s'appelle `Updates from Overleaf`.

![La boîte de dialogue Sync with GitHub avec un message de commit rempli](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3fe2cbcae8335c7363fcd220d2b993c)

Le message de commit de vos modifications

**3. Cliquer sur Sync**

Cliquez sur **Sync**. Les nouveaux commits de GitHub arrivent dans le projet, et vos modifications partent vers la branche par défaut du dépôt. Si les deux côtés ont modifié des choses différentes, elles sont fusionnées pour vous.

**4. Vérifier le résultat**

La boîte de dialogue affiche **No new commits in GitHub since last merge.** et le champ de message de commit a disparu. Les fichiers de l'éditeur et les commits sur GitHub sont à jour.

![La boîte de dialogue Sync with GitHub après la synchronisation, sans nouveau commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=851a620d8601a3ebaf9260f0f1c1685a)

Tout est synchronisé

### Si les mêmes lignes ont changé des deux côtés

La boîte de dialogue indique que les modifications n'ont pas pu être fusionnées et nomme une nouvelle branche, `overleaf-YYYY-MM-DD-HHMMSS`, qui contient vos modifications.

![La boîte de dialogue Sync with GitHub avec un avertissement de conflit de fusion](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b67dd69bb98605672da34b3a372be582)

Un conflit

1. Fusionnez cette branche dans la branche par défaut sur GitHub ou avec Git. Vous pouvez fermer la boîte de dialogue entre-temps : elle affiche le même message lorsque vous la rouvrez.
2. Cliquez sur **I have manually merged. Continue**. Le résultat fusionné arrive dans le projet.
3. La branche reste sur GitHub. Supprimez-la lorsque vous n'en avez plus besoin.

## Supprimer le lien d'un projet

Faites-le lorsque vous ne voulez plus que le projet se synchronise. Seul le propriétaire du projet peut le faire.

**1. Cliquer sur Unlink**

Dans la boîte de dialogue de synchronisation, cliquez sur **Unlink**.

**2. Confirmer**

Cliquez sur **Confirm**. La mention d'un abonnement ne vous empêche pas de lier à nouveau le projet.

![La boîte de dialogue Sync with GitHub demandant de confirmer la suppression du lien](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f2e541c2e9e8d000baa0dacd28a328)

Confirmer la suppression du lien

**3. Vérifier le résultat**

La boîte de dialogue affiche maintenant **Export Project to GitHub**. Le projet et le dépôt conservent tous deux leur contenu. Pour synchroniser à nouveau, exportez le projet vers un nouveau dépôt, ou importez le dépôt dans un nouveau projet.

## Supprimer le lien de votre compte GitHub

Dans **Account settings**, sous **GitHub**, cliquez sur **Unlink**, puis à nouveau sur **Unlink** dans la boîte de dialogue.

![La boîte de dialogue Unlink GitHub Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=94ce090cb4d8b98231886319d6e6d903)

Supprimer le lien de votre compte

Vos projets restent liés à leurs dépôts. Vous ne pouvez pas les synchroniser tant que vous n'avez pas lié à nouveau votre compte.

> [!NOTE]
>
> Pour savoir qui peut faire quoi dans un projet partagé, consultez [Qui peut lier et synchroniser](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md#who-can-link-and-sync). Chaque collaborateur qui synchronise lie son propre compte GitHub.


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