|
| 1 | +--- |
| 2 | +title: "La recherche du site ne renvoie aucun résultat" |
| 3 | +description: "Diagnostiquez pourquoi la recherche intégrée de votre site ne renvoie aucun résultat, souvent à cause de hidden: true sur une version dans docs.json." |
| 4 | +keywords: ["search returns no results", "empty search", "search broken", "hidden version", "search index empty", "site search"] |
| 5 | +--- |
| 6 | + |
| 7 | +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`. |
| 8 | + |
| 9 | +<div id="check-for-hidden-true-on-a-version-or-other-top-level-navigation-element"> |
| 10 | +## Vérifier la présence de `hidden: true` sur une version ou un autre élément de navigation de premier niveau |
| 11 | +</div> |
| 12 | + |
| 13 | +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. |
| 14 | + |
| 15 | +```json Example: this hides every page from search |
| 16 | +"navigation": { |
| 17 | + "versions": [ |
| 18 | + { |
| 19 | + "version": "v1", |
| 20 | + "hidden": true, |
| 21 | + "groups": [...] |
| 22 | + } |
| 23 | + ] |
| 24 | +} |
| 25 | +``` |
| 26 | + |
| 27 | +Pour corriger le problème, choisissez l'une des options suivantes : |
| 28 | + |
| 29 | +- Retirez `hidden: true` de la version ou de l'autre élément. |
| 30 | +- 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` : |
| 31 | + |
| 32 | + ```json |
| 33 | + "seo": { |
| 34 | + "indexing": "all" |
| 35 | + } |
| 36 | + ``` |
| 37 | + |
| 38 | +Contrairement aux onglets et aux groupes, les versions et les autres éléments de navigation de premier niveau ne prennent pas en charge l'option `searchable: true`. Consultez [Pages masquées](/fr/organize/hidden-pages#search-seo-and-ai-indexing) pour le comportement complet de visibilité et d'indexation de chaque emplacement de `hidden`. |
| 39 | + |
| 40 | +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. |
| 41 | + |
| 42 | +<div id="other-causes"> |
| 43 | +## Autres causes |
| 44 | +</div> |
| 45 | + |
| 46 | +- **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](/fr/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups). |
| 47 | +- **Pages absentes de la navigation** : les pages qui ne figurent pas dans la navigation de votre `docs.json` sont exclues de la recherche par défaut. |
| 48 | +- **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. |
0 commit comments