Building the index along with the HTML pages allows us to hide page elements such as the table of contents, so that the index contains only relevant terms.
2. Using the search box
In principle, the search works like any other search engine: enter search terms in the search box on
These are matched against the index and you will receive a weighted list of results.
2.1. The simple search
In a simple search, enter the search terms one after the other in the search box. The resulting list will be sorted as follows:
At the top of the results list are pages that contain all of the search terms and which are the closest match.
This is followed by pages that contain all of the search terms, but which match less closely.
Finally follow pages which contain fewer of the terms, and finally only one of the entered search terms.
An occurrence in a page title and in a meta description is weighted higher than one in body text.
Below the search box, the 5 best results are listed. In the line below, you can display all results in a new overlay window.
2.2. Including and excluding search terms
You can use the
- operators to explicitly include or exclude search terms. Examples:
Finds all pages that contain
Finds pages that contain
Finds all pages that contain neither
* replaces any string at any position of a search term.
As you type, in the background an asterisk is automatically added to the end of your typed text to generate the preview.
Finish your search text with a space to find the exact search term.
Append an integer with a circumflex (
^) to a search term to weight it higher than the default for that factor:
3. Linking to search
You can also pass parameters for a search in
docs.checkmk.com via the URL.
The following parameters are available:
At least one search term is required. You can separate multiple search terms with
Does not open the preview with five results, but the larger overlay window with all hits.
Immediately opens the article of the first search result.
Specify this parameter to the origin if you link from the forum, for example, or if you create the search in the User guide as a search engine.
Our web server writes the query parameter to its log files.
We evaluate this parameter statistically, currently for
In principle, the search works on any page.
For example, you can access the English article on the Linux agent with an open search for the term
linux as follows: