Pages
Ajoutez des pages, des groupes de pages ou des liens externes — et découvrez les options disponibles pour chaque page
Une page est l'endroit où vous pouvez ajouter, modifier et intégrer du contenu. Les pages se trouvent toujours à l'intérieur d'un espace, ce qui vous permet de regrouper du contenu lié et de créer différentes sections pour les sujets ou domaines que vous couvrez.
Lors de la publication de votre documentation, chaque espace sera son propre site de documentation ou section du site, et 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 sur le côté gauche de votre écran dans la table des matières de votre espace. La table des matières apparaîtra au même endroit lorsque vous publierez votre espace, sauf si vous choisissez de la masquer.
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... > Page en bas de votre table des matières. Vous pouvez également survoler entre les pages dans la table des matières et cliquer sur l'icône + qui apparaît.
Vous ne voyez pas l'option pour créer une nouvelle page ?
Si les éditions 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 bouton Nouvelle page (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 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 a un titre, une description optionnelle et une zone où vous pouvez écrire et ajouter tout type de contenu.
Vous pouvez imbriquer des pages en faisant glisser et déposer une page sous une autre dans la table des matières. Cela crée une sous-page.
Lorsque vous modifiez le titre d'une page, le slug de la page (la partie à la toute fin de l'URL, par ex. /hello-world
) changera également — sauf si vous avez déjà défini manuellement le slug de la page.
Vous pouvez modifier le titre et le slug d'une page à tout moment en ouvrant le menu Actions de la page et en choisissant Renommer.
Groupes de pages
Avec les groupes de pages, vous pouvez rassembler des pages en sections qui couvrent du contenu lié.
Vous pouvez créer un nouveau groupe de pages en cliquant sur Ajouter... > Groupe en 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 de groupes de pages dans d'autres groupes de pages.
Pour modifier le titre et le slug d'un groupe de pages, cliquez sur l'icône menu Actions à 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. En cliquant dessus, les utilisateurs seront dirigés directement vers le contenu lié.
Créez un nouveau lien externe en cliquant sur Ajouter... > Lien externe en bas de votre table des matières.
Icônes et emojis de page
Pour améliorer la visibilité pour les lecteurs lors du survol de 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 bouton Ajouter une icône en survolant le titre de la page, ou sur le bouton emoji à gauche du titre.
Options de page
Dans le menu Options de page, vous pouvez personnaliser l'apparence d'une page sélectionnée dans un espace, et contrôler sa visibilité.
Disposition
Vous pouvez ouvrir le Options de page menu ou changer 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 pour ceux qui visitent votre contenu publié. 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 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
Visibilité
Vous pouvez décider quelles pages vous souhaitez afficher/masquer dans votre documentation publiée, tout en décidant également si vous souhaitez que la page soit indexée dans la recherche de votre documentation publiée, et/ou indexée par les moteurs de recherche.
Vous pouvez masquer une page ou un groupe de pages de la table des matières de votre site en ouvrant le Menu Actions et en activant Masquer la page.
Si elle est masquée, ce qui suit apparaîtra dans l’en-tête du fichier markdown lors de l’utilisation de Git Sync :
---
hidden: true
---
Couvertures de page
Vous pouvez également définir une couverture de page pour chaque page de votre documentation. Lorsque vous cliquez sur l’option Couverture de page , une couverture par défaut sera ajoutée immédiatement. À partir de là, vous pouvez :
Changer l’image de couverture
Survolez la couverture de la page et cliquez sur Changer la couverture, puis sélectionnez ou téléversez une image. Selon la façon dont nous affichons actuellement les couvertures de page, 1990x480 pixels est la taille idéale.
Repositionner l’image de couverture
Survolez la couverture de la page et ouvrez le Menu 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 la page et ouvrez le Menu Actions
, puis cliquez sur Supprimer.
Pleine largeur et largeur héroïque Vous pouvez changer 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. Survolez la couverture de la page et ouvrez le Menu Actions
, puis choisissez l’option de votre choix dans le menu.
Mis à jour
Ce contenu vous a-t-il été utile ?