Pages
Ajoutez des pages, des groupes de pages ou des liens externes — et découvrez les options disponibles sur chaque page
Une page est l’endroit où vous pouvez ajouter, modifier et intégrer du contenu. Les pages vivent toujours à l’intérieur d’une section, ce qui vous permet de regrouper du contenu مرتبط aux sujets ou aux domaines que vous traitez.
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 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.
Créer une nouvelle page
Passez en mode d’édition en direct ou ouvrez une demande de changement.
Cliquez sur Ajouter nouveau… en bas de votre table des matières.
Cliquez sur Page.
Ou survolez l’espace entre des pages dans la table des matières et cliquez sur l’ + icône qui apparaît.

Option Nouvelle page manquante
Si les modifications en direct sont désactivées pour votre section, créez ou modifiez une demande de changement. Dans une demande de changement, 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 aussi que vous n’ayez pas les autorisations nécessaires pour modifier une page.
Organiser votre contenu
Il existe trois façons d’organiser votre contenu dans la table des matières :
Pages
Une page comporte un titre, une description facultative et une zone 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.
Lorsque vous modifiez le titre d’une page, le slug de la page (la partie tout à la fin de l’URL, comme /hello-world) change également — sauf si vous avez déjà défini manuellement le slug de la page auparavant.
L’URL d’une page publiée suit l’arborescence de navigation, et non la structure de fichiers de votre Git Sync. Elle inclut le slug de la section ou du groupe de niveau supérieur, le slug de chaque page ou groupe ancêtre, ainsi que le propre slug de la page.
Par exemple, cette structure de fichiers Git Sync :
Peut avoir cette arborescence de navigation :
Si les slugs sont api, guides, et install, l’URL publiée est /api/guides/install. Le chemin du fichier ne détermine pas l’URL.
Pour modifier le titre, le titre du lien ou le slug d’une page :
Ouvrez le menu d’actions
.
Cliquez sur Modifier le titre et le slug.
Titre du lien de la page
Pour donner à votre page un titre plus long et optimisé pour le SEO tout en conservant un titre plus court pour l’entrée de navigation et les liens, définissez un titre du lien.
Ouvrez le menu d’actions
.
Cliquez sur Modifier le titre et le slug.
Dans la boîte de dialogue Modifier la page , activez et définissez un titre du lien pour cette page.
Si vous utilisez Git Sync, définissez le titre du lien de la page dans SUMMARY.md sur le lien de la page :
Les titres des liens 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 connexes dans la table des matières d’une section. Vous pouvez ajouter une icône à chaque groupe de pages.
Créez un groupe de pages en cliquant sur Ajouter nouveau… > Groupe en bas de votre table des matières.
Les groupes de pages ne vivent qu’au niveau supérieur de la table des matières — vous ne pouvez pas imbriquer des groupes de pages les uns dans les autres.
Les slugs des groupes de pages font partie de l’URL de chaque page enfant. L’ajout, le renommage ou la suppression d’un groupe de pages modifie les URL des pages enfants et casse les liens existants, sauf si vous ajoutez des redirections. Voir Redirections du site.
Pour modifier le titre, le slug ou l’icône d’un groupe de pages :
Cliquez sur l’ menu d’actions icône
à côté du titre du groupe dans la table des matières.
Cliquez sur Renommer.
Mettre à jour le titre, le slug ou l’icône.
SUMMARY.md ne stocke pas les icônes des groupes de pages. GitBook les stocke, et Git Sync ne les synchronise pas de façon bidirectionnelle. Si votre dépôt recrée un groupe de pages, GitBook ne restaure pas automatiquement l’icône d’origine. Définissez à nouveau l’icône dans GitBook.
Liens externes
Ajoutez des liens à votre table des matières pour amener les personnes directement vers le contenu lié.
Créez un lien externe en cliquant sur Ajouter nouveau… > Lien externe en bas de votre table des matières.
Icônes et emojis de page
Pour améliorer la visibilité des 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, ainsi qu’à 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 boîte de dialogue Options de la page menu, personnalisez l’apparence et le comportement d’une page sélectionnée dans une section et contrôlez sa visibilité.
Disposition
Ouvrez le Options de la page menu ou modifiez la couverture d’une page en survolant son titre. Les boutons apparaissent juste au-dessus du titre de la page.
Dans la boîte de dialogue Options de la page panneau latéral, choisissez comment chaque page s’affiche pour les visiteurs de votre contenu publié . Vous avez le choix entre trois préréglages de disposition, ou vous pouvez créer une disposition personnalisée.
Chaque préréglage de disposition active ou désactive les parties suivantes 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
Balises
Associez une ou plusieurs balises à une page depuis Bibliothèque → Balises. Activez Afficher les balises sur la page pour les afficher dans l’en-tête de la page. Ou choisissez une balise comme balise principale de la page, que GitBook peut afficher à côté de la page dans la table des matières. En savoir plus dans Balises.
Définissez également la largeur globale de votre page depuis ce menu. Choisir Large donne plus d’espace à des blocs tels que les tableaux, les cartes et les blocs de code sur la page publiée. Utilisez cette option pour des pages d’accueil attrayantes.
Visibilité
Choisissez quelles pages afficher ou masquer dans votre documentation publiée, et si chaque page apparaît 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 :
Ouvrez le menu d’actions
.
Basculez Masquer la page.
Les pages masquées ne sont cachées que 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 :
Masquage 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 à l’intérieur du corps de la page. En savoir plus sur les niveaux de titres dans Titres.
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 des variantes de contenu).
URL canonique: l’URL préférée (de référence) 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: autres URL du 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 permettent de sélectionner une autre page GitBook (recommandé) ou de saisir une URL externe.
Déplacer des pages entre sections
GitBook ne prend pas actuellement 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
Esctouche, puis copiez et collez-le dans 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 sont synchronisées avec des dépôts, copiez les fichiers entre les dépôts et ajoutez les titres des pages à
SUMMARY.md. Voir Git Sync.
Covers 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 sur ce format, afin que les proportions soient conservées sur toutes les tailles d’écran. À partir d’ici, vous pouvez :
Modifier l’image de couverture
Survolez la couverture de la page et cliquez sur Modifier la couverture.
Choisissez ou téléversez une image. La taille idéale est de 1990 × 480 pixels.
Repositionner l’image de couverture
Survolez la couverture de la page et ouvrez le menu d’actions
.
Cliquez sur Repositionner.
Faites glisser l’image pour la placer, puis cliquez sur Enregistrer.
Supprimer l’image de couverture
Survolez la couverture de la page et ouvrez le menu d’actions
.
Cliquez sur Supprimer.
Pleine largeur et largeur héro
Modifiez le style de la couverture de votre page pour qu’elle occupe toute la largeur de votre écran ou seulement la largeur de votre contenu.
Survolez la couverture de la page et ouvrez le menu d’actions
.
Cliquez sur l’option de votre choix.
Mis à jour
Ce contenu vous a-t-il été utile ?