> 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/creating-content/styleguide.md). # Guide de style Un guide de style est un espace dédié qui rassemble les règles et conventions de rédaction de votre équipe. C’est la source unique de vérité sur la manière dont le contenu de votre site doit être rédigé — ton, terminologie, mise en forme et structure. Un guide de style sert deux publics : * **Votre équipe** — les rédacteurs et les relecteurs disposent d’une référence commune sur la manière d’écrire, afin que la documentation reste cohérente, quel que soit le contributeur. * **GitBook Agent** — l’Agent lit votre guide de style et le considère comme la source de vérité qu’il doit suivre chaque fois qu’il génère ou modifie du contenu. Il remplace les valeurs par défaut de l’Agent et les conventions générales de rédaction. {% hint style="info" %} **Les guides de style sont en accès anticipé** La fonctionnalité de guide de style est déployée progressivement. Si vous ne la voyez pas encore dans les paramètres de votre site, elle n’est pas activée pour votre organisation. {% endhint %} ### Créer un guide de style Ouvrez les **Paramètres** de votre site et choisissez la section **Guide de style** . Si votre site n’a pas encore de guide de style, vous pouvez en créer un de plusieurs façons : {% tabs %} {% tab title="Vide" %} Partez d’un espace vide et rédigez vos règles de zéro. {% endtab %} {% tab title="Modèle de démarrage" %} Partez d’un modèle intégré qui couvre déjà la voix et le ton, les principes de rédaction, la mise en forme et la terminologie. Adaptez chaque section à votre équipe — considérez-le comme un point de départ, pas comme un règlement gravé dans le marbre. {% endtab %} {% tab title="Importer" %} Importez du contenu existant — par exemple, un guide de style que vous conservez déjà dans un autre outil — dans le nouvel espace de guide de style. {% endtab %} {% endtabs %} La première fois que vous ouvrez un guide de style, GitBook affiche une courte introduction expliquant que vous le modifiez comme n’importe quel autre espace. ### Que mettre dans votre guide de style Un guide de style est particulièrement utile lorsqu’il consigne les décisions faciles à mal interpréter ou incohérentes au sein d’une équipe. Les sections courantes incluent : * **Voix et ton** — comment vous vous adressez au lecteur, et votre degré de formalité ou de convivialité. * **Principes de rédaction** — temps verbal, voix active ou passive, longueur des phrases et des paragraphes. * **Mise en forme** — casse des titres, quand utiliser des listes, des étapes, des astuces et d’autres blocs. * **Terminologie** — noms de produits et de fonctionnalités, termes préférés, gestion des acronymes. {% hint style="warning" %} **Placez vos règles principales sur la première page** GitBook Agent charge en entier la **première page** de votre guide de style dans son contexte pour chaque tâche, afin que cette page guide toujours son travail. Il lit les autres pages uniquement à la demande, en s’appuyant sur la table des matières. Conservez vos règles les plus importantes sur la première page et utilisez les pages supplémentaires pour les détails que l’Agent pourra récupérer en fonction du contexte. {% endhint %} ### Modifier un guide de style Un guide de style est un espace, vous le modifiez donc de la même manière que le reste de votre documentation : * **Dans GitBook** — faites vos modifications dans une [demande de modification](/docs/documentation/fr/collaboration/change-requests.md)puis fusionnez-les lorsque vous êtes prêt. * **Avec Git Sync** — si l’espace du guide de style est [synchronisé avec GitHub ou GitLab](/docs/documentation/fr/getting-started/git-sync.md)— modifiez-le en markdown dans votre dépôt. Pour ouvrir votre guide de style, utilisez l’entrée de la **Guide de style** barre latérale de votre site, ou l’action **Modifier** dans **Paramètres du site → Guide de style**. ### Partager un guide de style entre plusieurs sites Un guide de style appartient à votre organisation, donc plusieurs sites peuvent s’appuyer sur le même. Lorsque vous configurez le guide de style d’un site qui n’en a pas encore, et que votre organisation dispose déjà de guides de style, vous pouvez : * **Utiliser un guide de style existant** — l’attacher tel quel, partagé avec les autres sites qui l’utilisent. Les modifications s’appliquent partout où il est utilisé. * **Le dupliquer** — créer une copie dédiée à ce site (nommée `Guide de style - {site name}`) que vous pouvez faire évoluer indépendamment. Pour voir tous les guides de style de votre organisation et les sites qui utilisent chacun d’eux, ouvrez l’entrée **Guides de style** dans la barre latérale de votre organisation. ### Détacher un guide de style Pour empêcher un site d’utiliser son guide de style, ouvrez **Paramètres du site → Guide de style** et choisissez **Détacher**. Le détachement conserve l’espace du guide de style — il peut toujours être utilisé par d’autres sites. Si aucun autre site n’y fait référence, GitBook propose de le supprimer définitivement. ### Comment GitBook Agent utilise votre guide de style Chaque fois que GitBook Agent rédige ou modifie du contenu sur un site, il lit le guide de style de ce site et le suit comme source de vérité. En pratique : * À chaque tâche de demande de modification, l’Agent charge à l’avance la **première page** du guide de style ainsi que sa table des matières, puis récupère les autres sections au besoin. * Vous pouvez demander à l’Agent de vérifier directement une page par rapport à votre guide de style, en utilisant **Vérifier la cohérence par rapport au guide de style** dans le [menu Améliorer](/docs/documentation/fr/gitbook-agent/write-and-edit-with-ai.md#improve-page-content-with-gitbook-agent). {% hint style="info" %} Un guide de style complète les [instructions personnalisées](/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent.md#add-a-style-guide-and-custom-instructions) au niveau du site que vous pouvez donner à GitBook Agent. Les instructions personnalisées sont des consignes courtes et propres au site ; un guide de style est un document complet et partagé regroupant vos règles de rédaction. {% 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 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/creating-content/styleguide.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.