Buscar localmente en los Docs públicos
Usa la caja de búsqueda de los Docs públicos para acotar los artículos ya cargados en el navegador para el idioma, la plataforma y el tema actuales. El filtro es local a la página después de cargar el índice de Docs y no inicia una nueva búsqueda en el servidor.
En este artículo
La búsqueda de los Docs públicos ayuda a operadores de restaurante, responsables de sala y usuarios de soporte a encontrar guías públicas relevantes sin iniciar sesión.
La búsqueda funciona sobre el índice de Docs cargado para el contexto de documentación actual. Es inmediata, no distingue mayúsculas y mantiene abierto el artículo actual hasta que seleccionas un resultado filtrado.
Antes de empezar
- Abre una ruta pública de Docs gestionada por la pantalla de Docs: `/docs`, `/manual` o `/wiki`. Para la documentación en español, usa `/docs?lang=es`.
- Espera a que el índice de Docs termine de cargarse desde `GET /api/public/docs?locale={locale}&platform={platform}&theme={theme}`.
- No se requiere inicio de sesión, pertenencia a organización ni pertenencia a ubicación.
Instrucciones
- 1.
Abre los Docs públicos
Abre `/docs?lang=es` y espera hasta que el índice público de Docs sea visible. El contador de guías junto a la caja de búsqueda sigue siendo el total de artículos cargados, no el número de resultados filtrados.
- 2.
Busca en el índice cargado
Haz clic en la entrada `Buscar` de la barra lateral de Docs y escribe un término como `Accesos`. La barra lateral se acota inmediatamente sin salir de la página y sin enviar una nueva petición `/api/public/docs?q=...`.
- 3.
Revisa los artículos coincidentes
Usa los enlaces filtrados de la barra lateral para encontrar la guía que necesitas. Las secciones coincidentes se abren automáticamente, las secciones sin coincidencias se ocultan y los resultados mantienen el mismo orden de sección y artículo devuelto por el índice cargado.
- 4.
Limpia la búsqueda
Borra el término de búsqueda para volver a mostrar todos los artículos cargados, o sustitúyelo por otro término para volver a filtrar el mismo índice cargado. El término de búsqueda no se guarda en la URL ni en el almacenamiento local.
- 5.
Gestiona la ausencia de coincidencias
Si ningún artículo de la barra lateral de escritorio coincide con la consulta, la página muestra `Ningún artículo coincide con esa búsqueda.`. En el panel de secciones de Docs móvil se usa la misma lista filtrada, pero este mensaje de búsqueda vacía de escritorio no se renderiza.
Validaciones y límites
- La búsqueda se normaliza solo con `trim().toLowerCase()`; no hay longitud mínima, debounce, stemming, tokenización ni plegado de acentos.
- Los campos buscables del artículo se limitan a título, resumen, slug de sección, id de acción y palabra clave principal.
- La búsqueda local no busca en el cuerpo del artículo, el id del artículo, el slug, el id de guía fuente, el título de sección, la introducción, los prerrequisitos, los pasos, las validaciones, los metadatos de media ni los artículos relacionados.
- Escribir en la caja de búsqueda de los Docs públicos no hace una nueva petición `/api/public/docs?q=...`, aunque la API de Docs del backend soporte un parámetro `q`.
- Un parámetro `q` en la URL del navegador no inicializa el campo de búsqueda.
- Solo se genera contenido de Docs en `es` y `en` en la configuración actual de la pantalla de la landing; otros idiomas de la landing caen al contenido de Docs en inglés.
Resultado esperado
La barra lateral de los Docs públicos muestra solo los artículos del índice ya cargado que coinciden con la consulta local. Limpiar la consulta restaura el índice cargado completo.