> 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-gitlab-sync.md).
# Activer la synchronisation GitLab
Synchronisez votre dépôt GitLab avec GitBook
Ce guide vous expliquera comment configurer votre site GitBook avec un dépôt sur GitLab.
Options de configuration de GitLab Sync.
{% stepper %}
{% step %}
### Ouvrez Git Sync pour votre site
Depuis votre site, ouvrez Git Sync dans la barre latérale.
{% endstep %}
{% step %}
### Connecter GitLab
Créez un jeton d’accès personnel dans les paramètres utilisateur de GitLab. Activez `api`, `read_repository`, et `write_repository`, puis saisissez le jeton dans GitBook.
{% hint style="info" %}
Si votre jeton a un rôle, sélectionnez `Mainteneur` ou `Administrateur`.
{% endhint %}
{% endstep %}
{% step %}
### Sélectionnez un dépôt et une branche
Sous **Dépôt source**, sélectionnez le dépôt qui contient votre documentation. Sélectionnez la branche avec laquelle GitBook se 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 ?** Assurez-vous que votre jeton d’accès personnel dispose des étendues requises et de l’accès au dépôt.
{% endhint %}
{% hint style="warning" %}
Si votre `main` branche est protégée, sélectionnez une branche distincte pour Git Sync. Vous pouvez fusionner cette branche dans `main` tout en conservant sa protection.
{% endhint %}
{% endstep %}
{% step %}
### Choisissez une direction de synchronisation initiale
Choisissez la source de vérité pour la synchronisation initiale. Sélectionnez **Inverser la direction** si le contenu du dépôt doit remplacer le contenu GitBook.
{% hint style="warning" %}
**GitLab → GitBook peut remplacer le contenu de votre site.** Avant de lancer la synchronisation, confirmez le dépôt, la branche et la direction. Assurez-vous que le contenu de destination peut être remplacé sans risque.
{% endhint %}
{% endstep %}
{% step %}
### Définissez le répertoire du projet
Si votre documentation se trouve dans un sous-répertoire, saisissez-la sous **Répertoire du projet**. GitBook stocke le `docs.yaml` fichier de votre site dans ce répertoire. Utilisez cette configuration si votre documentation se trouve dans un [monorepo](/docs/documentation/fr/docs-as-code/git-sync/monorepos.md).
{% endstep %}
{% step %}
### Associez vos espaces
Sous **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 à partir de la racine du dépôt. Les espaces nouvellement associés se synchronisent 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 dans GitLab. Les commits vers GitLab se synchronisent ensuite vers 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 que vous souhaitez synchroniser, cliquez sur **Configurer** à côté de **Git Sync** dans le [en-tête de l’espace](/docs/documentation/fr/reference/gitbook-ui.md#space-header). Dans la liste des fournisseurs, cliquez sur **GitLab Sync**, puis cliquez sur **Configurer**.
---
# 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-gitlab-sync.md?ask=&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.
