Les pages masquées sont retirées de la navigation de votre site, mais restent accessibles publiquement à toute personne connaissant leur URL.
Utilisez des pages masqué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étectable 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 votre navigation docs.json
. Pour masquer une page, retirez-la de votre structure de navigation.
Les pages masquées utilisent la même structure d’URL que les pages standard, basée sur leur chemin de fichier. Par exemple, guides/hidden-page.mdx
serait accessible à l’adresse docs.yoursite.com/guides/hidden-page
.
Voir un exemple de page masquée.
Certains éléments de navigation comme les barres latérales, les menus déroulants et les onglets peuvent sembler vides ou modifier la mise en page sur les pages masqué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": "Premiers pas",
"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é, tandis que le groupe « Guides » est visible.
Vous pouvez également masquer un onglet en ajoutant la propriété hidden
à votre fichier docs.json
:
"tabs": [
{
"tab": "Accueil",
"hidden": true,
"pages": [
"index",
"quickstart"
]
}
]
Recherche, SEO et indexation par l’IA
Par défaut, les pages masquées sont exclues de l’indexation pour les moteurs de recherche, la recherche interne de votre documentation et comme context pour l’Assistant IA. Pour inclure les pages masquées dans les résultats de recherche et comme context 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.