> 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/content-structure/page.md). # Pages Une page est l'endroit où vous pouvez ajouter, modifier et intégrer du contenu. Les pages se trouvent toujours dans une section, ce qui vous permet de regrouper le contenu lié aux sujets ou aux domaines que vous abordez. Lorsque vous publiez votre site, chaque section apparaît dans la navigation de votre site, et toutes les pages qu'elle contient apparaissent sous cette section. ### Table des matières Créez autant de pages que nécessaire dans une section. Elles sont toutes visibles dans la barre latérale de gauche de votre écran, dans la table des matières de votre section. La table des matières apparaît au même endroit sur votre site publié, sauf si [vous choisissez de la masquer](#page-options). {% hint style="info" %} **Page d'accueil de la section** La première page de votre table des matières est toujours la page d'accueil de votre section, même si elle est masquée dans la table des matières. {% endhint %} ### Créer une nouvelle page 1. Passez en mode d'édition en direct ou ouvrez une demande de modification. 2. Cliquez sur **Ajouter un nouveau...** en bas de votre table des matières. 3. Cliquez sur **Page**. Ou survolez l'espace entre les pages dans la table des matières et cliquez sur l' **+** icône qui apparaît.

A GitBook screenshot showing an empty page listed in the table of contents — Une page vide dans GitBook. Vous pouvez la voir listée dans la table des matières sur la gauche.

### Option Nouvelle page manquante {% hint style="warning" %} Si les modifications en direct sont désactivées pour votre section, créez ou modifiez une demande de modification. Dans une demande de modification, le **Nouvelle page** bouton — qui crée des pages, des groupes de pages et des liens — est disponible dans la table des matières. Il se peut également que vous n'ayez pas les autorisations pour modifier une page. {% endhint %} ### Organiser votre contenu Il existe trois façons d'organiser votre contenu dans la table des matières : #### Pages Une page a un titre, une description facultative et un espace où vous pouvez écrire et ajouter n'importe quel type de contenu. Imbriquez des pages en faisant glisser une page sous une autre dans la table des matières. Cela crée une **sous-page**. Si vous ajoutez des sous-pages à une page parente vide, GitBook génère automatiquement une page 'contents' avec des liens vers toutes les sous-pages dans la version publiée de votre documentation. {% hint style="info" %} **Astuce :** Il n'y a pas de limite à l'imbrication des pages, mais évitez de dépasser trois niveaux pour conserver une navigation simple. {% endhint %} Lorsque vous modifiez le titre d'une page, le slug de la page (la partie tout à la fin de l'URL, par exemple `/hello-world`) change également — sauf si vous avez déjà défini manuellement le slug de la page. Pour modifier le titre, le titre du lien ou le slug d'une page : 1. Ouvrez le **menu d'actions**

. 2. Cliquez sur **Modifier le titre et le slug**. #### Titre du lien de la page Pour donner à votre page un titre plus long, optimisé pour le SEO, tout en conservant un titre plus court pour votre entrée de navigation et vos liens, définissez un titre de lien. 1. Ouvrez le **menu d'actions**

. 2. Cliquez sur **Modifier le titre et le slug**. 3. Dans la **Modifier la page** boîte de dialogue, activez et définissez un titre de lien pour cette page. Si vous utilisez Git Sync, définissez le titre du lien de la page dans `SUMMARY.md` dans le lien de la page : ```markdown # Table des matières * [Titre principal de la page](page.md "Titre du lien de la page") ``` {% hint style="info" %} **Remarque :** Les titres de lien de page apparaissent dans la table des matières, les boutons de pagination en bas de chaque page et tous les liens relatifs que vous ajoutez à cette page. {% endhint %} Les titres de lien de page sont facultatifs — si vous n'en ajoutez pas, la page utilise son titre standard. #### Groupes de pages Les groupes de pages rassemblent des pages liées au sein de la table des matières d'une section. {% hint style="info" %} Les groupes de pages organisent **des pages** au sein d'une seule section. Pour organiser les **sections** de votre site, utilisez plutôt des groupes. {% endhint %} Créez un groupe de pages en cliquant sur **Ajouter un nouveau...** > **Groupe** en bas de votre table des matières. Les groupes de pages vivent uniquement au **niveau supérieur** de la table des matières — vous ne pouvez pas imbriquer des groupes de pages les uns dans les autres. Pour modifier le titre et le slug d'un groupe de pages : 1. Cliquez sur le **menu d'actions** icône

à côté du titre du groupe dans la table des matières. 2. Cliquez sur **Renommer**. #### Liens externes Ajoutez des liens à votre table des matières pour diriger les personnes directement vers le contenu lié. Créez un lien externe en cliquant sur **Ajouter un nouveau...** > **Lien externe** en bas de votre table des matières. ### Icônes et emojis de page Pour améliorer la visibilité pour les lecteurs lorsqu'ils parcourent rapidement votre table des matières, ajoutez une icône ou un emoji facultatif à des pages individuelles. L'icône ou l'emoji apparaît dans la table des matières et à côté du titre en haut de la page. Pour ajouter une icône ou un emoji, cliquez sur le **Ajouter une icône** bouton lorsque vous survolez le titre de la page, ou sur le bouton emoji à gauche du titre. ### Options de la page Dans la **Options de la page** menu, personnalisez l'apparence et le fonctionnement d'une page sélectionnée au sein d'une section et contrôlez sa visibilité. #### Disposition Ouvrez le **Options de la page**

menu ou changez la couverture d'une page en survolant le titre de la page. Les boutons apparaissent juste au-dessus du titre de la page. Dans la **Options de la page** panneau latéral, choisissez comment chaque page s'affiche pour les visiteurs de votre **publié** contenu. Il existe trois préréglages de disposition parmi lesquels choisir, ou vous pouvez créer une disposition personnalisée. Chaque préréglage de disposition active ou désactive les éléments suivants de la page : * Titre de la page * Description de la page * Table des matières * Plan de la page * Liens suivant/précédent * Métadonnées de la page * Étiquettes Attribuez une ou plusieurs étiquettes à une page à partir de **Bibliothèque** → **Étiquettes**. Activez **Afficher les étiquettes sur la page** pour les afficher dans l'en-tête de la page. Ou choisissez une étiquette comme étiquette principale de la page, que GitBook peut afficher à côté de la page dans la table des matières. En savoir plus dans Étiquettes. Définissez aussi la largeur globale de votre page depuis ce menu. Choisir **Large** donne plus d'espace à des blocs comme les tableaux, les cartes et les blocs de code sur la page publiée. Utilisez cette option pour des pages d'accueil accrocheuses. #### Visibilité Choisissez les pages à afficher ou à masquer dans votre documentation publiée, ainsi que celles qui apparaissent dans la recherche de votre site et dans les moteurs de recherche. Pour masquer une page ou un groupe de pages de la table des matières de votre site : 1. Ouvrez le **menu d'actions**

. 2. Basculez **Masquer la page**. Les pages masquées sont uniquement masquées de la table des matières publiée. Elles restent accessibles via le serveur MCP du site et dans `llms-full.txt`. Si vous utilisez Git Sync, les pages masquées incluent le front matter suivant dans le fichier Markdown :

---
hidden: true
---

{% hint style="warning" %} Masquer **Titre de la page** ou **Description de la page** masque uniquement l'en-tête de la page dans le contenu publié. Cela ne supprime pas les titres dans le corps de la page. En savoir plus sur les niveaux de titre dans Titres. {% endhint %} #### Métadonnées (SEO) Utilisez **Options de la page → Métadonnées** pour contrôler la manière dont les moteurs de recherche comprennent les relations entre des pages similaires (par exemple : les versions de la documentation ou les variantes de contenu). * **URL canonique** : l'URL privilégiée (faisant autorité) pour cette page. Les moteurs de recherche la considèrent comme la 'source de vérité'. Utilisez-la lorsque plusieurs URL affichent le même contenu. * **URL alternatives** : d'autres URL pour le même contenu dans une autre variante. Par exemple, une autre version ou une autre langue. Elles aident les moteurs de recherche à regrouper les variantes au lieu de les traiter comme des doublons. Les deux champs prennent en charge la sélection d'une autre page GitBook (recommandé) ou la saisie d'une URL externe. {% hint style="info" %} Un schéma courant pour des docs versionnées consiste à définir les pages plus anciennes comme canoniques vers la page équivalente la plus récente (par exemple, `1.0` → `2.0`), puis à répertorier les versions plus anciennes comme alternatives sur la page la plus récente. {% endhint %} #### Déplacer des pages entre sections GitBook ne prend actuellement pas en charge le déplacement de pages individuelles entre sections dans l'application. Pour déplacer le contenu d'une page vers une autre section : * **Copier et coller** — sélectionnez le contenu de la page avec la `Échap` touche, puis copiez-collez-le vers la destination. Certains blocs peuvent nécessiter une reconfiguration ; les commentaires et l'historique de la page ne sont pas copiés, et les images doivent être téléversées à nouveau dans la nouvelle section. * **Utilisez Git Sync** — si les deux sections se synchronisent avec des dépôts, copiez les fichiers entre les dépôts et ajoutez les titres des pages au `SUMMARY.md`. Voir [Git Sync](/docs/documentation/fr/getting-started/git-sync.md). ### Couvertures de page Définissez une couverture de page pour chaque page de votre documentation. Lorsque vous cliquez sur l' **Couverture de page**

option, GitBook ajoute immédiatement une couverture par défaut. La taille idéale de l'image de couverture est de 1990 × 480 pixels — les couvertures sont verrouillées à ce ratio d'aspect, de sorte que les proportions sont conservées quelle que soit la taille de l'écran. À partir d'ici, vous pouvez : * **Modifier l'image de couverture** 1. Survolez la couverture de la page et cliquez sur **Modifier la couverture**. 2. Choisissez ou téléversez une image. La taille idéale est de 1990 × 480 pixels. * **Repositionner l'image de couverture** 1. Survolez la couverture de la page et ouvrez le **menu d'actions**

. 2. Cliquez sur **Repositionner**. 3. Faites glisser l'image pour la placer et cliquez sur **Enregistrer**. * **Supprimer l'image de couverture** 1. Survolez la couverture de la page et ouvrez le **menu d'actions**

. 2. Cliquez sur **Supprimer**. * **Pleine largeur et largeur héro** Changez le style de la couverture de votre page pour qu'elle s'étende sur toute la largeur de votre écran ou seulement sur la largeur de votre contenu. 1. Survolez la couverture de la page et ouvrez le **menu d'actions**

. 2. Cliquez sur l'option de votre choix. --- # 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/content-structure/page.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.