> 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/creer-du-contenu/styleguide.md).

# Guide de style

Définissez les règles de rédaction de votre équipe dans un guide de style dédié et gardez chaque contributeur, humain ou agent GitBook, cohérent.

Un guide de style regroupe les règles d’écriture de votre équipe : voix et ton, terminologie, mise en forme et structure. Il s’adresse à deux publics :

* **Votre équipe :** les rédacteurs et les réviseurs partagent une même référence, ce qui garantit la cohérence de la documentation, quel que soit son auteur.
* **GitBook Agent :** l’Agent suit votre guide de style lorsqu’il rédige, modifie ou révise du contenu. Vos règles prévalent sur ses paramètres par défaut.

GitBook Agent applique les règles qui ont un identifiant numérique ou qui sont précises et vérifiables, et considère les autres comme des recommandations. Pour en savoir plus, consultez [Comment GitBook Agent applique votre guide de style](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/how-gitbook-agent-enforces-your-style-guide.md).

## Commencer

Pour configurer un guide de style, vous avez besoin de droits d’administration sur le site.

{% stepper %}
{% step %}
**Configurer un guide de style**

Cliquez sur **Guide de style** dans la barre latérale de votre site, puis cliquez sur **Configurer**. Partez d’un modèle, réutilisez un guide de style déjà utilisé par votre organisation ou importez le vôtre. Consultez [Choisir un point de départ](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/build-your-style-guide.md#choose-a-starting-point).
{% endstep %}

{% step %}
**Remplissez le modèle**

Remplissez chaque section portant la mention **Votre contribution est requise**, par exemple le nom de votre produit, votre public cible et votre liste de mots, et attribuez un identifiant à chaque règle que vous souhaitez faire appliquer. Consultez [Créer votre guide de style](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/build-your-style-guide.md).
{% endstep %}

{% step %}
**Lancer votre première vérification**

Ouvrez votre guide de style, accédez à l’onglet **Vérifications** et cliquez sur **Lancer une vérification** pour examiner le contenu existant. Vous pouvez également demander une vérification du guide de style lors de votre prochaine demande de modification. Consultez [Vérifier le contenu par rapport à votre guide de style](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/check-content-against-your-style-guide.md).
{% endstep %}
{% endstepper %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Construisez votre guide de style</strong></td><td>Choisissez un point de départ, remplissez le modèle et rédigez des règles que l’Agent peut appliquer</td><td><a href="https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/build-your-style-guide.md">Construisez votre guide de style</a></td></tr><tr><td><strong>Vérifier le contenu par rapport à votre guide de style</strong></td><td>Relire une page, une demande de modification ou des espaces entiers</td><td><a href="https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/check-content-against-your-style-guide.md">Vérifier le contenu par rapport à votre guide de style</a></td></tr><tr><td><strong>Comment GitBook Agent applique votre guide de style</strong></td><td>Ce que l’Agent lit, signale et modifie</td><td><a href="https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/how-gitbook-agent-enforces-your-style-guide.md">Comment GitBook Agent applique votre guide de style</a></td></tr></tbody></table>

## Modifier votre guide de style

Cliquez sur **Guide de style** dans la barre latérale de votre site pour ouvrir votre guide de style. Vous le modifiez comme le reste de votre documentation : apportez vos modifications dans une demande de modification, puis fusionnez-les.

## Partager un guide de style entre plusieurs sites

Un guide de style appartient à votre organisation, donc plusieurs sites peuvent utiliser le même et suivre les mêmes règles.

Après avoir créé un guide de style, GitBook propose de le lier à tous les autres sites de votre organisation qui n’en ont pas encore. Vous pouvez également choisir un guide de style existant, partagé ou forké, lorsque vous en créez un pour un site.

Pour voir tous les guides de style de votre organisation et les sites qui utilisent chacun d’eux, ouvrez **Guides de style** dans la barre latérale de votre organisation.

### Dissocier un guide de style

Pour qu’un site cesse d’utiliser son guide de style, ouvrez le menu des actions à côté de **Guide de style** dans la barre latérale de votre site, puis cliquez sur **Détacher le guide de style**. Le guide de style est conservé après son détachement, car d’autres sites peuvent encore l’utiliser. Si aucun autre site ne l’utilise, GitBook vous propose de le supprimer définitivement.


---

# 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/creer-du-contenu/styleguide.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.
