La recherche du site ne renvoie aucun résultat

Si la recherche intégrée de votre site de documentation Mintlify ne renvoie aucun résultat, quelle que soit la requête, y compris les titres exacts de pages, vos pages sont probablement exclues de l’index de recherche par un paramètre hidden dans votre docs.json.

Définir hidden: true sur une version, une ancre, un menu déroulant, une langue ou un produit dans votre docs.json exclut chaque page qu’il contient de l’index de recherche. Si cet élément contient toutes vos pages, par exemple votre seule version, l’index de recherche devient vide et chaque recherche ne renvoie rien. Le site lui-même continue de fonctionner, car les pages masquées restent accessibles par URL directe.

"navigation": {
  "versions": [
    {
      "version": "v1",
      "hidden": true,
      "groups": [...]
    }
  ]
}

Pour corriger le problème, choisissez l’une des options suivantes :

• Retirez hidden: true de la version ou de l’autre élément.

• Gardez l’élément masqué dans la navigation, mais réintégrez ses pages dans la recherche et l’indexation en définissant seo.indexing: "all" dans votre docs.json :

  "seo": {
    "indexing": "all"
  }

Les onglets et les groupes prennent en charge l’option searchable: true. Les versions et les autres éléments de navigation de premier niveau ne la prennent pas en charge. Consultez Pages masquées pour le comportement complet de visibilité et d’indexation de chaque emplacement de hidden.

La recherche se réindexe lorsque votre site est reconstruit ; poussez donc la modification de docs.json et attendez la fin du déploiement avant de tester à nouveau. Pour vérifier la correction, ouvrez votre site et recherchez le titre exact d’une page qui n’apparaissait plus dans les résultats. Si la page apparaît dans la liste déroulante, l’index a bien été reconstruit.

• Onglets ou groupes masqués : hidden: true sur un onglet ou un groupe exclut également ses pages de la recherche. Pour les onglets et les groupes, vous pouvez ajouter searchable: true en plus de hidden: true pour garder les pages descendantes accessibles à la recherche. Consultez Inclure les pages situées sous des onglets ou groupes masqués spécifiques.
• Pages absentes de la navigation : Mintlify exclut par défaut de la recherche toute page que vous n’avez pas incluse dans la navigation de votre docs.json.
• Frontmatter de la page : hidden: true, noindex: true ou searchable: false dans le frontmatter d’une page excluent chacun cette page de la recherche du site.