> 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/content-configuration.md). # Configuration du contenu Si vous souhaitez configurer davantage Git Sync, vous pouvez ajouter un `.gitbook.yaml` fichier à la racine du contenu synchronisé pour cette section afin d'indiquer à GitBook comment analyser votre dépôt Git. Dans un monorepo, ce fichier se trouve dans le [répertoire du projet](/docs/documentation/fr/getting-started/git-sync/monorepos.md). {% code title=".gitbook.yaml" %} ```yaml root: ./ ​structure: readme: README.md summary: SUMMARY.md​ redirects: previous/page: new-folder/page.md ``` {% endcode %} ### Racine Le chemin de recherche de votre documentation pointe par défaut vers le répertoire racine du dépôt. Voici comment indiquer à GitBook de regarder dans un `./docs` dossier : {% code title=".gitbook.yaml" %} ```yaml root: ./docs/ ``` {% endcode %} {% hint style="warning" %} **Toutes les autres options qui spécifient des chemins seront relatives à ce dossier racine**. Donc, si vous définissez root sur `./docs/` et ensuite `structure.summary` comme `./product/SUMMARY.md`, GitBook cherchera en réalité un fichier dans `./docs/product/SUMMARY.md`.‌ {% endhint %} {% hint style="info" %} Dans un monorepo, `root` est résolu par rapport au répertoire du projet de la section synchronisée, et non à la racine du dépôt. La configuration basée sur les chemins ne s’applique que dans le périmètre synchronisé de cette section. Elle ne rend pas automatiquement les répertoires frères ni les dossiers au niveau du dépôt disponibles pour les autres sections. Pour les configurations de dépôt à plusieurs sections, voir [Monorepos](/docs/documentation/fr/getting-started/git-sync/monorepos.md). {% endhint %} ### ​Structure‌ La structure accepte deux propriétés :‌ * **`readme`** : La première page de votre documentation. Sa valeur par défaut est `./README.md` * **`summary`** : La table des matières de votre documentation. Sa valeur par défaut est `./SUMMARY.md` La valeur de ces propriétés est un chemin vers les fichiers correspondants. Le chemin est relatif à l’option « root ». Par exemple, voici comment indiquer à GitBook de regarder dans un `./product` dossier pour la première page et la table des matières : {% code title=".gitbook.yaml" %} ```yaml structure : readme: ./product/README.md summary: ./product/SUMMARY.md ``` {% endcode %} {% hint style="warning" %} Lorsque Git Sync est activé, **n'oubliez pas de ne pas créer ni modifier les fichiers readme** via l’interface de GitBook. Le fichier readme doit être géré exclusivement dans votre dépôt GitHub/GitLab afin d’éviter les conflits et les problèmes de duplication. {% endhint %} ### Sommaire‌ Le `summary` fichier est un fichier Markdown (`.md`) qui doit avoir la structure suivante : {% code title="./SUMMARY.md" %} ```markdown ‌# Sommaire​ ## Utilisez des titres pour créer des groupes de pages comme celui-ci​ * [Titre de la première page](page1/README.md) * [Une page enfant](page1/page1-1.md) * [Une autre page enfant](part1/page1-2.md) * [Titre de la deuxième page](page2/README.md) * [Une page enfant](page2/page2-1.md) * [Une autre page enfant](part2/page2-2.md) ## Un groupe de deuxième page​ * [Une autre page](another-page.md) ``` {% endcode %} Fournir un fichier de sommaire personnalisé est facultatif. Par défaut, GitBook recherchera un fichier nommé `SUMMARY.md` dans votre `root` dossier si cela est spécifié dans votre fichier de configuration, ou à la racine du dépôt sinon. Si vous ne spécifiez pas de sommaire et que GitBook ne trouve pas de `SUMMARY.md` fichier à la racine de votre documentation, GitBook déduira la table des matières à partir de la structure des dossiers et des fichiers Markdown ci-dessous.‌ {% hint style="info" %} Le fichier Markdown de sommaire est **un miroir de la** **table des matières** de votre section GitBook. Ainsi, même lorsqu’aucun fichier de sommaire n’est fourni lors d’une importation initiale, GitBook en créera un et/ou le mettra à jour chaque fois que vous modifierez votre contenu à l’aide de l’éditeur GitBook. Pour cette raison, il n’est pas possible de faire référence deux fois au même fichier Markdown dans votre `SUMMARY.md` fichier, car cela impliquerait qu’une même page existe à deux URL différentes dans votre section GitBook. {% endhint %} #### Titres de la table des matières (barre latérale) Si vous souhaitez que vos pages aient un titre différent dans la barre latérale de la table des matières que sur la page elle-même, vous pouvez définir un **titre du lien de page** dans votre `SUMMARY.md` fichier. Si vous utilisez Git Sync, le titre du lien de page se définit sur le lien de page : {% code title="./SUMMARY.md" %} ```markdown # Sommaire * [Titre principal de la page](page.md "Titre du lien de page") ``` {% endcode %} Le texte entre guillemets (`"Titre du lien de page"`) sera utilisé : * Dans la table des matières (barre latérale) * Dans les boutons de pagination au bas de chaque page * Dans tous les liens relatifs que vous ajoutez à cette page Les titres de lien de page sont facultatifs — si vous n’en ajoutez pas manuellement, GitBook utilisera par défaut partout le titre standard de la page. --- # 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/content-configuration.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.