 |
This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Introducción
Este sitio web - docs.checkmk.com - utiliza páginas HTML estáticas creadas con Asciidoctor, que se actualizan diariamente. Esta solución es eficaz y será la forma más eficiente de proporcionarte el Manual de usuario durante muchos años. Otra ventaja es que cada artículo está disponible como un único archivo, lo que significa que el índice para la búsqueda puede integrarse en el sistema de archivos sin necesidad de dar un rodeo por la red. Para aprovechar esta ventaja, en septiembre de 2022 se cambió la búsqueda de una solución de rastreo al programa JavaScript Lunr.js.
Lunr utiliza un índice que se carga completamente como un objeto JavaScript en la primera carga de la página. Este objeto tiene un tamaño comprimido inferior a un megabyte y permanece en la caché del navegador, lo que hace que la búsqueda sea muy rápida. Sólo cuando hay un nuevo índice disponible -lo que ocurre una vez al día- se vuelve a cargar en la caché del navegador.
Construir el índice junto con las páginas HTML nos permite ocultar elementos de la página, como el índice de contenidos, para que el índice sólo contenga los términos relevantes.
2. Utilizar la caja de búsqueda
En principio, la búsqueda funciona como cualquier otro buscador: introduce los términos de búsqueda en la caja de búsqueda de docs.checkmk.com. Éstos se cotejan con el índice y recibirás una lista ponderada de resultados.
2.1. La búsqueda simple
En una búsqueda simple, introduce los términos de búsqueda uno tras otro en la caja de búsqueda. La lista resultante se ordenará de la siguiente manera:
En la parte superior de la lista de resultados están las páginas que contienen todos los términos de búsqueda y que son las que más coincidencias presentan.
Le siguen las páginas que contienen todos los términos de búsqueda, pero que coinciden menos.
Por último siguen las páginas que contienen menos de los términos y, por último, sólo uno de los términos de búsqueda introducidos.
Una aparición en el título de la página y en una meta descripción se pondera más que una en el cuerpo del texto.
Debajo de la caja de búsqueda, se enumeran los 5 mejores resultados. En la línea inferior, puedes mostrar todos los resultados en una nueva ventana superpuesta.
2.2. Incluir y excluir términos de búsqueda
Puedes utilizar los operadores + y - para incluir o excluir explícitamente términos de búsqueda. Ejemplos:
|
Busca todas las páginas que contengan |
|
Encuentra las páginas que contienen |
|
Busca todas las páginas que no contengan ni |
2.3. Términos que se utilizan en combinación
Para encontrar términos que se utilicen juntos, puedes enmascarar los espacios o los signos de puntuación o los guiones utilizando dos barras invertidas seguidas de un espacio. Así, agent\\ controller encontrará todas las páginas que contengan Agente Controlador aunque se utilice una grafía con guiones incorrecta. En cambio, con +agent +controller, se encuentran las páginas que contengan Agente y Controlador en cualquier orden y con cualquier espacio.
2.4. Comodín
El asterisco * sustituye a cualquier cadena en cualquier posición de un término de búsqueda. Mientras escribes, en segundo plano se añade automáticamente un asterisco al final del texto escrito para generar la vista previa. Termina el texto de búsqueda con un espacio para encontrar el término de búsqueda exacto.
2.5. Ponderación
Añade un número entero con un circunflejo (^) a un término de búsqueda para ponderarlo más alto que el predeterminado para ese factor:
|
Pondera |
3. Enlace a la búsqueda
También puedes pasar parámetros para una búsqueda en docs.checkmk.com a través de la URL. El JavaScript transfiere entonces el término o términos de búsqueda a la caja de búsqueda e inicia la búsqueda. Están disponibles los siguientes parámetros:
|
Se requiere al menos un término de búsqueda. Puedes separar varios términos de búsqueda con |
|
No abre la vista previa con cinco resultados, sino la ventana superpuesta más grande con todos los resultados. |
|
Abre inmediatamente el artículo del primer resultado de la búsqueda. |
|
Especifica este parámetro al origen si enlazas desde el foro, por ejemplo, o si creas la búsqueda en el Manual de usuario como motor de búsqueda. Nuestro servidor web escribe el parámetro de consulta en sus archivos de registro. Evaluamos este parámetro estadísticamente, actualmente para |
En principio, la búsqueda funciona en cualquier página. Por ejemplo, puedes acceder al artículo en inglés sobre el agente Linux con una búsqueda abierta del término linux de la siguiente manera:
https://docs.checkmk.com/latest/en/agent_linux.html?find=linux&origin=bookmarks