 |
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 a diario. Esta solución ofrece un buen rendimiento y será la forma más eficiente de ofrecerte el Manual de usuario durante muchos años. Otra ventaja es que cada artículo está disponible como un único archivo. Esto significa que el índice para la búsqueda se puede integrar en el sistema de archivos sin necesidad de pasar por la red. Para aprovechar esto, en septiembre de 2022 se cambió la búsqueda de una solución de rastreador al programa JavaScript Lunr.js.
Lunr utiliza un índice que se carga completamente como un objeto JavaScript al cargar la primera página. Este objeto ocupa menos de un megabyte comprimido y permanece en la caché del navegador, lo que hace que la búsqueda sea muy rápida. Solo cuando haya un nuevo índice disponible —lo cual ocurre una vez al día— se volverá a cargar en la caché del navegador.
Crear el índice junto con las páginas HTML nos permite ocultar elementos de la página, como la tabla de contenidos, para que el índice solo contenga términos relevantes.
2. Cómo usar la caja de búsqueda
En principio, la búsqueda funciona como cualquier otro motor de búsqueda: introduce los términos de búsqueda en la caja de búsqueda de docs.checkmk.com.
Estas producen coincidencias con el índice y obtendrás una lista de resultados ordenada por relevancia.
2.1. La búsqueda simple
En una búsqueda simple, escribe 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 aparecen las páginas que contienen todos los términos de búsqueda y que son las que ofrecen la mayor coincidencia con ellos.
A continuación, aparecen las páginas que contienen todos los términos de búsqueda, pero con una coincidencia menor.
A continuación, aparecen las páginas que contienen menos términos y, por último, las que solo contienen uno de los términos de búsqueda introducidos.
Una aparición en el título de la página y en la meta descripción tiene más peso que una en el cuerpo del texto.
Debajo de la caja de búsqueda, hay una lista con los 5 mejores resultados. En la línea de abajo, puedes ver todos los resultados en una nueva ventana emergente.
2.2. Incluir y excluir términos de búsqueda
Puedes usar los operadores + y - para incluir o excluir términos de búsqueda de forma explícita. Ejemplos:
|
Busca todas las páginas que contengan |
|
Busca páginas que contengan |
|
Busca todas las páginas que no contengan ni |
2.3. Términos que se usan en combinación
Para encontrar términos que se usan juntos, puedes ocultar espacios, signos de puntuación o guiones usando dos barras invertidas seguidas de un espacio.
Así, agent\\ controller encontrará todas las páginas con Controlador de agentes, incluso si se usa una ortografía incorrecta con guion.
Con +agent +controller, por otro lado, se encuentran páginas que contienen Agent y Controller en cualquier orden y con cualquier espaciado.
2.4. Comodín
El asterisco * sustituye cualquier cadena en cualquier posición de un término de búsqueda.
A medida que escribes, en segundo plano se añade automáticamente un asterisco al final del texto que has escrito para generar la vista previa.
Termina tu texto de búsqueda con un espacio para encontrar el término exacto.
2.5. Ponderación
Añade un número entero con un circunflejo (^) a un término de búsqueda para darle más peso 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.
A continuación, el JavaScript transfiere los 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 búsqueda. |
|
Especifica este parámetro en el 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érminolinux
de la siguiente manera:
https://docs.checkmk.com/latest/en/agent_linux.html?find=linux&origin=bookmarks