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 dans un espacece qui vous permet de regrouper du contenu lié et de créer différentes sections pour les sujets ou domaines que vous traitez.
Lorsque vous publiez votre documentation, chaque espace sera son propre site de documentation ou section du siteet les pages à l’intérieur de l’espace apparaîtront toutes sur ce site.
Table des matières
Vous pouvez créer autant de pages que nécessaire dans un espace. Elles sont toutes visibles dans la barre latérale gauche de votre écran, dans la table des matières. La table des matières apparaîtra au même endroit lorsque vous publierez votre espace, sauf si vous choisissez de la masquer.
Page d’accueil du site de documentation
La première page de votre table des matières est toujours la page d’accueil de votre espace, même si elle est masquée dans la table des matières.
Créer une nouvelle page
Lorsque vous êtes en édition en direct ou dans une demande de modification, vous pouvez créer une nouvelle page en cliquant sur Ajouter un nouveau... > Page au bas de votre table des matières. Sinon, vous pouvez survoler l’espace entre les pages dans la table des matières et cliquer sur l’ + icône qui apparaît.

Vous ne voyez pas l’option permettant de créer une nouvelle page ?
Si les modifications en direct sont désactivées pour votre espace, vous devrez créer ou modifier une demande de modification. Une fois dans une demande de modification, le Nouvelle page bouton (qui vous permet de créer des pages, des groupes de pages et des liens) sera disponible dans la table des matières.
Sinon, il se peut que vous n’ayez pas les correctes autorisations 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 un espace où vous pouvez rédiger et ajouter tout type de contenu.
Vous pouvez imbriquer 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érera 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, par ex. /hello-world) changera aussi — sauf si vous avez défini manuellement le slug de la page auparavant.
Vous pouvez modifier le titre, le titre du lien et le slug d’une page à tout moment en ouvrant le menu d’actions et en choisissant Modifier le titre et le slug.
Titre du lien de la page
Si vous souhaitez que votre page ait un titre plus long, adapté au SEO, tout en conservant un titre plus court pour l’entrée de navigation et les liens, vous pouvez éventuellement définir un titre de lien.
Ouvrez le menu d’actions et choisissez Modifier le titre et le slug. Dans la boîte de dialogue Modifier la page vous trouverez l’option permettant d’activer et de définir un titre de lien pour cette page.
Si vous utilisez Git Sync, le titre du lien de la page est défini dans le SUMMARY.md fichier sur le lien de la page :
Les titres de lien de page sont facultatifs — si vous n’en ajoutez pas un manuellement, votre page utilisera par défaut le titre standard de la page.
Groupes de pages
Avec les groupes de pages, vous pouvez rassembler des pages en sections couvrant du contenu lié.
Vous pouvez créer un nouveau groupe de pages en cliquant sur Ajouter un nouveau... > Groupe au bas de votre table des matières.
Les groupes de pages ne peuvent exister qu’au niveau supérieur de la table des matières. Vous ne pouvez pas imbriquer des groupes de pages dans d’autres groupes de pages.
Pour modifier le titre et le slug 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 et choisissez Renommer.
Liens externes
Vous pouvez également ajouter des liens à votre table des matières. Un clic dessus redirigera directement les personnes vers le contenu lié.
Créez un nouveau lien externe en cliquant sur Ajouter un nouveau... > Lien externe au 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, vous pouvez ajouter une icône ou un emoji facultatif à des pages individuelles. L’icône ou l’emoji apparaîtra 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 page
Dans le Options de page menu, vous pouvez personnaliser l’apparence d’une page sélectionnée au sein d’un espace et contrôler sa visibilité.
Mise en page
Vous pouvez ouvrir le Options de page menu ou modifier la couverture d’une page en survolant le titre de la page. Vous verrez les boutons apparaître juste au-dessus du titre de la page.
Dans le Options de page panneau latéral, vous pouvez choisir comment chaque page est affichée aux personnes qui visitent votre publié contenu. Il existe trois préréglages de mise en page parmi lesquels choisir, ou vous pouvez créer une mise en page personnalisée.
Chaque préréglage de mise en page activera ou désactivera chacune des 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
Étiquettes
Vous pouvez attribuer à une page une ou plusieurs étiquettes depuis Bibliothèque → Étiquettes. Activez Afficher les étiquettes sur la page pour les afficher dans l’en-tête de la page. Vous pouvez également choisir une étiquette comme étiquette principale de la page. GitBook peut l’afficher à côté de la page dans la table des matières. En savoir plus dans Étiquettes.
Vous pouvez également définir la largeur globale de votre page depuis ce menu. Choisir Large accorde davantage d’espace aux blocs tels que les tableaux, les cartes et les blocs de code lorsque la page est publiée. C’est idéal pour créer des pages d’accueil percutantes.
Visibilité
Vous pouvez décider quelles pages afficher/masquer dans votre documentation publiée, tout en déterminant si vous souhaitez que la page soit indexée dans la recherche de votre documentation publiée et/ou par les moteurs de recherche.
Vous pouvez masquer une page ou un groupe de pages dans la table des matières de votre site en ouvrant le menu d’actions et en activant Masquer la page.
Les pages masquées ne sont masquées que dans la table des matières publiée.
Elles restent disponibles via le serveur MCP du site et dans llms-full.txt.
Si elle est masquée, ce qui suit apparaîtra dans le front matter du fichier Markdown lors de l’utilisation de Git Sync :
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 dans le corps de la page. En savoir plus sur les niveaux de titres dans Titres.
Métadonnées (SEO)
Utilisez Options de page → Métadonnées pour contrôler la manière dont les moteurs de recherche comprennent les relations entre des pages similaires (par exemple : versions de documentation ou 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.
URLs alternatives: autres URL pour le même contenu dans une autre variante. Par exemple, une autre version ou langue. Elles aident les moteurs de recherche à regrouper les variantes plutôt qu’à les traiter comme des doublons.
Les deux champs permettent de sélectionner une autre page GitBook (recommandé) ou de saisir une URL externe.
Couvertures de page
Vous pouvez également définir une couverture de page pour chaque page de votre documentation. Lorsque vous cliquez sur le Couverture de page option, une couverture par défaut sera ajoutée immédiatement. À partir d’ici, vous pouvez :
Modifier l’image de couverture
Survolez la couverture de page et cliquez sur Modifier la couverture, puis sélectionnez ou téléversez une image. Compte tenu de la manière dont nous affichons actuellement les couvertures de page, 1990×480 pixels est la taille idéale.
Repositionner l’image de couverture
Survolez la couverture de page et ouvrez le menu d’actions
. Cliquez sur Repositionner, puis faites glisser l’image comme vous le souhaitez et cliquez sur Enregistrer.
Supprimer l’image de couverture Survolez la couverture de page et ouvrez le menu d’actions
, puis cliquez sur Supprimer.
Pleine largeur et largeur « hero » Vous pouvez modifier le style de la couverture de votre page pour qu’il occupe toute la largeur de votre écran ou seulement la largeur de votre contenu. Survolez la couverture de page et ouvrez le menu d’actions
, puis choisissez l’option de votre choix dans le menu.
Mis à jour
Ce contenu vous a-t-il été utile ?