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écouvrable via la navigation.
Pour le contenu nécessitant un contrôle d’accès strict, vous devez configurer l’Authentification.
Si vous souhaitez masquer des pages pour certains groupes d’utilisateurs, utilisez la personnalisation pour contrôler la visibilité des pages.
Une page est masquée si elle n’est pas incluse dans la propriété navigation
de votre docs.json
. Pour masquer une page, supprimez-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 apparaître vides ou décaler 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 aussi 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 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 contexte pour l’Assistant. Pour inclure les pages masqué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.