Les pages cachées sont retirées de la navigation de votre site, mais restent accessibles publiquement à toute personne qui connaît leur URL.
Utilisez des pages cachées pour du contenu que vous souhaitez rendre accessible sur votre site ou référencer comme contexte pour des outils d’IA, sans qu’il soit découvrable via la navigation.
Pour du contenu nécessitant un contrôle d’accès strict, vous devez configurer l’authentification.
Si vous souhaitez masquer des pages pour des groupes d’utilisateurs spécifiques, utilisez la personnalisation pour contrôler la visibilité des pages.
Une page est masquée si elle n’est pas incluse dans la navigation de votre docs.json
. Pour masquer une page, retirez-la de votre structure de navigation.
Les pages cachées utilisent la même structure d’URL que les pages classiques, basée sur leur chemin de fichier. Par exemple, guides/hidden-page.mdx
sera accessible à l’adresse docs.yoursite.com/guides/hidden-page
.
Voir un exemple de page cachée.
Certains éléments de navigation, comme les barres latérales, les menus déroulants et les onglets, peuvent apparaître vides ou décaler la mise en page sur les pages cachées.
Masquer un groupe de pages
Un groupe de pages est masqué si la propriété hidden
est définie sur true
dans votre fichier docs.json
:
"groups": [
{
"group": "Getting started",
"hidden": true,
"pages": [
"index",
"quickstart"
]
},
{
"group": "Guides",
"pages": [
"guides/hidden-page.mdx",
"guides/hidden-groups.mdx"
]
}
]
Dans cet exemple, le groupe Getting started
est masqué, mais le groupe Guides
reste visible.
Vous pouvez aussi masquer un onglet en ajoutant la propriété hidden
à votre fichier docs.json
:
"tabs": [
{
"tab": "Home",
"hidden": true,
"pages": [
"index",
"quickstart"
]
}
]
Recherche, SEO et indexation par l’IA
Par défaut, les pages cachées sont exclues de l’indexation par les moteurs de recherche, de la recherche interne de votre documentation, ainsi que du contexte utilisé par l’Assistant. Pour inclure les pages cachées dans les résultats de recherche et comme contexte pour l’Assistant, ajoutez la propriété seo
à votre docs.json
:
"seo": {
"indexing": "all"
}
Pour exclure une page spécifique, ajoutez noindex: "true"
à son frontmatter.