> 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-gitlab-sync.md).
# Activation de 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 [en-tête de section](/docs/documentation/fr/ressources/gitbook-ui.md#space-header). Dans la liste des fournisseurs, cliquez sur **GitLab Sync**, puis cliquez sur **Configurer**.
Options de configuration de GitLab Sync.
### 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 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 de votre utilisateur GitLab.
{% endhint %}
Veillez à activer les accès suivants pour votre jeton :
* `api`
* `read_repository`
* `write_repository`
Si les jetons que vous créez sont également associés à un rôle spécifique, assurez-vous aussi qu’il ait un `Mainteneur` ou `Administrateur` rôle.
Vous pouvez ensuite 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 garder synchronisé avec votre contenu GitBook.
{% hint style="info" %}
**Vous ne voyez pas votre dépôt ?** Assurez-vous d’avoir défini les autorisations correctes lors de la création de votre jeton API.
{% 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.
{% 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 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 %}
### Effectuez une synchronisation initiale
Lors de la première synchronisation, vous aurez la possibilité de synchroniser dans l’une des deux directions suivantes :
1. GitBook -> GitLab synchronisera le contenu de votre section **vers** la branche sélectionnée. C’est idéal si vous partez d’un dépôt vide et souhaitez importer rapidement votre contenu 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
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 permet à GitBook de synchroniser de manière fiable le contenu vers votre dépôt lorsqu’un membre de votre équipe fusionne un [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 GitLab sélectionnée.
Lorsque vous effectuez un commit dans GitLab, chaque commit sera synchronisé avec 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/getting-started/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.