> 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/docs-as-code/git-sync/enabling-github-sync.md).

# Activer la synchronisation GitHub

Synchronisez votre dépôt GitHub avec GitBook

Ce guide vous accompagnera dans la configuration de votre site GitBook avec un dépôt sur GitHub.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-6c33061b672738c3e7da914fa50e7424a87179e2%2FGit%20Sync%20-%20GitHub.png?alt=media" alt="A GitBook screenshot showing GitHub Sync configuration options"><figcaption><p>Options de configuration de GitHub Sync.</p></figcaption></figure>

{% stepper %}
{% step %}

### Ouvrez Git Sync pour votre site

Depuis votre site, ouvrez Git Sync dans la barre latérale.
{% endstep %}

{% step %}

### Connecter GitHub

Connectez le compte GitHub qui a accès au dépôt que vous souhaitez synchroniser.

{% hint style="warning" %}
Si vous voyez un **« Potential duplicated accounts »** message d’erreur à cette étape, cela signifie que votre compte GitHub est déjà associé à 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 d’associer votre compte actuel.

Pour en savoir plus, consultez notre [page de dépannage](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync/troubleshooting.md#potential-duplicated-accounts-when-signing-in).
{% endhint %}
{% endstep %}

{% step %}

### Sélectionnez un dépôt et une branche

Dans **Dépôt source**, sélectionnez le dépôt qui contient votre documentation. Sélectionnez la branche que GitBook synchronise. Si la branche n’existe pas, GitBook la crée lors de la synchronisation initiale.

{% hint style="info" %}
**Vous ne trouvez pas votre dépôt ?** Si votre dépôt n’apparaît pas dans la liste, vérifiez que vous avez installé [l’application GitHub de GitBook](https://github.com/apps/gitbook-com) dans le bon périmètre (votre compte personnel ou l’organisation GitHub où se trouve le dépôt). Vérifiez également que l’accès au dépôt est correctement configuré dans l’application GitHub de GitBook.
{% endhint %}
{% endstep %}

{% step %}

### Choisissez une direction de synchronisation initiale

Choisissez la source de référence pour la synchronisation initiale. Sélectionnez **Inverser le sens** si le contenu du dépôt doit remplacer celui de GitBook.

{% hint style="warning" %}
**GitHub → GitBook peut remplacer le contenu de votre section.** GitBook remplace la section par le contenu de la branche sélectionnée. Si le dépôt est vide ou en retard sur GitBook parce que des demandes de modification récentes n’ont pas encore été exportées, ce contenu sera perdu dans la section et sur votre site publié.

Vous choisissez un sens à chaque configuration de Git Sync, y compris lorsque vous le reconnectez ou recréez une connexion existante. Avant de lancer la synchronisation, vérifiez le dépôt, la branche et le sens. Si vous choisissez GitHub → GitBook, vérifiez que le dernier commit de la branche inclut vos demandes de modification les plus récentes qui ont été fusionnées.

Si le contenu a été remplacé, consultez [Dépannage](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync/troubleshooting.md) pour le restaurer.
{% endhint %}
{% endstep %}

{% step %}

### Définissez le répertoire du projet

Si votre documentation se trouve dans un sous-répertoire, indiquez-le sous **Répertoire du projet**. GitBook stocke le fichier `gitbook-docs.yaml` de votre site dans ce répertoire. Utilisez cette configuration si votre documentation se trouve dans un [monorepo](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync/monorepos.md).
{% endstep %}

{% step %}

### Associez vos espaces

Dans **Mappage du contenu**, associez chaque espace à un répertoire du dépôt. Utilisez `./` pour les chemins relatifs au répertoire du projet. Utilisez `/` pour les chemins relatifs à la racine du dépôt. Les nouveaux espaces associés sont synchronisés automatiquement.
{% endstep %}

{% step %}

### Consultez les options avancées

Si nécessaire, configurez les fichiers d’instructions de l’agent, un modèle de message de commit ou des aperçus de fork.
{% endstep %}

{% step %}

### Synchronisez votre site

Cliquez sur **Synchroniser** pour lancer la synchronisation initiale.
{% endstep %}

{% step %}

### Écrire et valider

Fusionnez une demande de modification dans GitBook pour valider ses changements sur GitHub. Les commits vers GitHub se synchronisent ensuite avec GitBook.
{% endstep %}
{% endstepper %}

#### Exclure un espace de la synchronisation Git Sync à l’échelle du site

Dans le mappage de contenu Git Sync du site, cliquez sur l’icône de suppression à côté de l’espace que vous souhaitez exclure. Vous pouvez ensuite configurer Git Sync à partir de cet espace.

Si le site utilise déjà Git Sync, GitBook vous demande de choisir un périmètre :

* Sélectionnez le dépôt et la branche du site pour ajouter l’espace à la synchronisation Git Sync à l’échelle du site.
* Sélectionnez un dépôt et une branche indépendants pour configurer Git Sync pour l’espace.

Si le site n’utilise pas Git Sync, GitBook configure Git Sync indépendamment pour l’espace.

Pour configurer Git Sync pour un seul espace, dans l’espace à synchroniser, cliquez sur **Configurer** à côté de **Git Sync** dans l’ [en-tête de l’espace](https://gitbook.com/docs/documentation/fr/reference/gitbook-ui.md#space-header). Dans la liste des fournisseurs, cliquez sur **GitHub Sync**.

{% hint style="warning" %}
L’application GitHub qui alimente notre intégration GitHub n’est actuellement pas disponible pour les clients utilisant des 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync/enabling-github-sync.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
