> 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/documentation-as-code/git-sync/enabling-gitlab-sync.md).
# Activer la synchronisation GitLab
### Premiers pas
Dans la section que vous souhaitez synchroniser avec votre dépôt GitLab, cliquez sur **Configurer** à côté de **Git Sync** dans le [l’en-tête de section](/docs/documentation/fr/reference/gitbook-ui.md#space-header). Dans la liste des fournisseurs, cliquez sur **GitLab Sync**, puis cliquez sur **Configurer**.
Options de configuration de la synchronisation GitLab.
### Générez et saisissez votre jeton d’accès API
Vous pouvez générer un jeton d’accès API dans les paramètres utilisateur de votre GitLab.
{% hint style="info" %}
Il existe deux types de jetons d’accès dans GitLab : Projet et Personnel. Notez que pour que l’intégration fonctionne, vous devrez utiliser un jeton Personnel, que vous pouvez générer depuis le menu des préférences utilisateur de votre GitLab.
{% endhint %}
Assurez-vous d’activer l’accès suivant pour votre jeton :
* `api`
* `read_repository`
* `write_repository`
Si les jetons que vous créez ont également un rôle spécifique associé, assurez-vous également qu’il s’agit d’un `Mainteneur` ou `Administration` rôle.
Ensuite, vous pouvez coller le jeton dans le champ du jeton d’accès API lors de la configuration de votre intégration GitLab.
### Sélectionnez un dépôt et une branche
Sélectionnez le dépôt que vous souhaitez synchroniser avec votre contenu GitBook.
{% hint style="info" %}
**Vous ne voyez pas votre dépôt ?** Assurez-vous d’avoir défini les bonnes autorisations lors de la création de votre jeton API.
{% endhint %}
Une fois que vous avez sélectionné le bon dépôt, choisissez vers quelle branche vous voulez que les commits soient poussés et depuis laquelle ils soient synchronisés.
{% hint style="warning" %}
Pour de nombreux dépôts GitLab, la `main` branche peut être automatiquement définie comme protégée. Si c’est le cas, nous vous recommandons d’ajouter une branche spécifique entre laquelle synchroniser votre contenu. Vous pourrez ensuite la fusionner dans `main` et conserver la protection en place.
{% endhint %}
### Effectuer une synchronisation initiale
Lors de la première synchronisation, vous aurez la possibilité de synchroniser dans l’un des deux sens :
1. GitBook -> GitLab synchronisera le contenu de votre section **de** la branche sélectionnée. C’est idéal si vous partez d’un dépôt vide et souhaitez importer rapidement le contenu de votre GitBook.
2. GitLab -> GitBook synchronisera le contenu de votre section **depuis** la branche sélectionnée. C’est idéal si vous avez déjà du contenu Markdown dans un dépôt et souhaitez l’importer dans GitBook.
### Écrire et valider
Tout est prêt. Vous remarquerez que si votre section était en [édition en direct](/docs/documentation/fr/collaborer/live-edits.md) mode, les modifications en direct sont désormais verrouillées. Cela permet à GitBook de synchroniser de manière fiable le contenu vers votre dépôt lorsqu’une personne de votre équipe fusionne un [demande de modification](/docs/documentation/fr/collaborer/change-requests.md) dans GitBook.
Lorsque vous modifiez dans GitBook, chaque fusion de demande de changement entraînera un commit sur la branche GitLab sélectionnée.
Lorsque vous faites un commit dans GitLab, chaque commit sera synchronisé vers votre section GitBook sous forme de commit d’historique.
---
# 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/documentation-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 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.