> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/getting-started/git-sync/enabling-github-sync.md).
# Activation de la synchronisation GitHub
### Premiers pas
Dans la section que vous souhaitez synchroniser avec votre dépôt GitHub, cliquez sur **Configurer** à côté de **Git Sync** dans le [en-tête de section](/docs/documentation/fr/ressources/gitbook-ui.md#space-header). Dans la liste des fournisseurs, cliquez sur **GitHub Sync**.
Options de configuration de GitHub Sync.
### Authentifiez-vous auprès de GitHub
Si vous configurez GitHub Sync pour la première fois et n’avez pas encore lié de compte GitHub, vous serez invité à le faire lorsque vous commencerez à configurer Git Sync. Si vous avez déjà lié votre compte, vous devrez peut-être encore vous authentifier via GitHub.
{% hint style="warning" %}
Si vous voyez un **« Comptes potentiellement dupliqués »** message d’erreur à cette étape, cela signifie que votre compte GitHub est déjà lié à un autre compte utilisateur GitBook.
Pour vous aider à identifier quels comptes sont liés, vous devrez vous déconnecter de cette session et vous connecter en utilisant la méthode de connexion avec GitHub.
Si vous connaissez déjà votre compte GitBook associé à GitHub, vous pouvez vous connecter à ce compte utilisateur et dissocier votre compte GitHub (dans les paramètres) avant de vous reconnecter et de lier votre compte actuel.
En savoir plus sur notre [page de dépannage](/docs/documentation/fr/getting-started/git-sync/troubleshooting.md#potential-duplicated-accounts-when-signing-in).
{% endhint %}
### Installez l’application GitBook sur votre compte GitHub
Si ce n’est pas déjà fait, vous verrez une invite pour ajouter l’ [application GitBook](https://github.com/apps/gitbook-com) à votre compte GitHub.
Suivez les instructions dans la fenêtre contextuelle GitHub et accordez à GitBook des autorisations spécifiques sur le dépôt, ou autorisez l’accès à tous les dépôts, selon vos besoins.
### Sélectionnez un dépôt et une branche
Sélectionnez le compte et le dépôt que vous souhaitez maintenir synchronisés avec votre contenu GitBook.
{% hint style="info" %}
**Vous ne voyez pas votre dépôt ?** Si vous ne trouvez pas votre dépôt dans la liste, assurez-vous d’avoir installé le [application GitBook GitHub](https://github.com/apps/gitbook-com) dans le bon périmètre (c.-à-d. votre compte personnel ou l’organisation GitHub où se trouve le dépôt). Vous devez également vérifier que vous avez configuré le bon accès au dépôt dans l’application GitBook GitHub.
{% endhint %}
Une fois que vous avez sélectionné le bon dépôt, choisissez la branche vers laquelle vous souhaitez que les commits soient poussés et à partir de laquelle ils soient synchronisés.
### Effectuez une synchronisation initiale
Pour la synchronisation initiale, la source sélectionnée fait autorité. La synchronisation initiale peut remplacer le contenu existant dans sa destination.
Choisissez l’une de ces directions :
1. **GitBook → GitHub :** GitBook est la source de vérité. Utilisez cette direction uniquement lorsque la branche sélectionnée peut recevoir le contenu de votre section.
2. **GitHub → GitBook :** La branche GitHub sélectionnée est la source de vérité. Utilisez cette direction uniquement lorsque votre section peut recevoir le contenu de cette branche.
{% hint style="warning" %}
**GitHub → GitBook peut remplacer le contenu de votre section.** Si vous sélectionnez un dépôt vide, GitBook peut remplacer votre section par le contenu vide du dépôt.
Avant de commencer la synchronisation initiale, confirmez le dépôt, la branche et la direction. Assurez-vous qu’il est sûr de remplacer le contenu de destination.
{% endhint %}
Lorsque vous êtes prêt, démarrez la synchronisation initiale.
### Si vous avez choisi la mauvaise direction
Les opérations Git Sync apparaissent dans l’ **historique des versions**. Repérez la révision juste avant l’opération Git Sync, puis cliquez sur **Rétablir** pour restaurer le contenu précédent de la section.
Pour des étapes détaillées, consultez [Contrôle de version](/docs/documentation/fr/creating-content/version-control.md#roll-back-to-a-previous-version).
La déconnexion de Git Sync arrête les synchronisations futures. Elle ne restaure pas automatiquement le contenu.
Si la révision d’avant synchronisation n’est pas disponible ou si vous ne pouvez pas terminer le rétablissement, [contactez l’assistance GitBook](https://gitbook.com/docs/help-center/further-help/how-do-i-contact-support).
### Écrire et valider
C’est bon, vous pouvez y aller. Vous remarquerez que si votre section était en [modification en direct](/docs/documentation/fr/collaboration/live-edits.md) mode, les modifications en direct sont désormais verrouillées. Cela nous permet de synchroniser de manière fiable le contenu vers votre dépôt lorsqu’une personne de votre équipe fusionne une [demande de modification](/docs/documentation/fr/collaboration/change-requests.md) dans GitBook.
Lorsque vous modifiez dans GitBook, chaque fusion de demande de modification entraînera un commit sur la branche GitHub sélectionnée.
Lorsque vous validez dans GitHub, chaque commit sera synchronisé avec votre section GitBook sous forme de commit d’historique.
{% hint style="warning" %}
L’application GitHub qui alimente notre intégration GitHub n’est actuellement pas disponible pour les clients sur les instances GitHub Enterprise Server.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/fr/getting-started/git-sync/enabling-github-sync.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.