This repo demonstrates how to add lunr.js indexing to Antora builds, and a search UI to the Antora default UI.

The search UI is implemented as a drop-down menu, containing all matching entries. Results update immediately as you type. Use the kbd:[Arrow Up] and kbd:[Arrow Down] keys to select a result, and press kbd:[Enter] to navigate to that result (or just click). Press kbd:[Escape] to close the results.

• The included antora-playbook.yml is configured to use the Antora documentation. This demonstrates an excellent Antora feature: you can generate HTML for any documentation that exists in an Antora component in any accessible Git-based repository.

  Antora’s documentation is comprised of two components, one for Antora itself and another for its UI, and the Antora component has multiple versions. This is useful to demonstrate the 'faceting' of the search results, which are combined into groups based on the component
  version.

• You can use the search with your own documentation by revising the content: section of the antora-playbook.yml file.

• The supplemental_ui folder contains the search UI, as override files for Antora’s default UI.

• lunr indexes can often become quite large. The pako library is used to compress the index when it is created, and is also used to decompress the index in the browser. Typically, the compressed index is about 20% the size of the uncompressed index.

  As such, using lunr for search is best for sites with only a modest amount of content. Large sites likely require a search service, such as Algolia, to avoid distributing large indexes to all new users of your documentation site.

• Ewan Edwards

• Dan Allen, who wrote Asciidoctor and Antora

• Guillaume Grossetie, who wrote antora-lunr

Copyright © 2019 by the contributing authors.

Use of this software is granted under the terms of the Mozilla Public License Version 2.0 (MPL-2.0). See LICENSE to find the full license text.