Solucionar que la búsqueda del sitio no devuelva resultados
Diagnostica por qué la búsqueda integrada de tu documentación no devuelve resultados, a menudo por hidden: true en una versión de docs.json.
Si la búsqueda integrada de tu sitio de documentación de Mintlify no devuelve resultados para ninguna consulta, incluidos los títulos exactos de las páginas, lo más probable es que tus páginas estén excluidas del índice de búsqueda por un ajuste hidden en tu docs.json.
Establecer hidden: true en una versión, un anclaje, un menú desplegable, un idioma o un producto en tu docs.json excluye del índice de búsqueda todas las páginas que contiene. Si ese elemento contiene todas tus páginas, como tu única versión, el índice de búsqueda queda vacío y todas las búsquedas devuelven nada. El sitio en sí sigue funcionando porque las páginas ocultas permanecen accesibles por URL directa.
"navigation": {
"versions": [
{
"version": "v1",
"hidden": true,
"groups": [...]
}
]
}Para solucionarlo, elige una de las siguientes opciones:
-
Elimina
hidden: truede la versión o del otro elemento. -
Mantén el elemento oculto en la navegación, pero devuelve sus páginas a la búsqueda y la indexación estableciendo
seo.indexing: "all"en tudocs.json:"seo": { "indexing": "all" }
Las pestañas y los grupos admiten la inclusión mediante searchable: true. Las versiones y otros elementos de navegación de nivel superior no. Consulta Páginas ocultas para ver el comportamiento completo de visibilidad e indexación de cada ubicación de hidden.
La búsqueda se vuelve a indexar cuando tu sitio se reconstruye, así que envía el cambio de docs.json y espera a que se complete el despliegue antes de volver a probar. Para verificar la corrección, abre tu sitio y busca el título exacto de una página que antes no aparecía en los resultados. Si la página aparece en el desplegable, el índice se reconstruyó correctamente.
- Pestañas o grupos ocultos:
hidden: trueen una pestaña o un grupo también excluye sus páginas de la búsqueda. En pestañas y grupos, puedes añadirsearchable: truejunto ahidden: truepara que las páginas descendientes sigan siendo localizables. Consulta Incluir páginas bajo pestañas o grupos ocultos específicos. - Páginas ausentes de la navegación: Mintlify excluye de la búsqueda, de forma predeterminada, cualquier página que no incluyas en la navegación de tu
docs.json. - Frontmatter de la página:
hidden: true,noindex: trueosearchable: falseen el frontmatter de una página excluyen esa página de la búsqueda del sitio.