zola/docs/content/documentation/content/search.md
Vincent Prouillet 73ddbf7152 Write some docs
2018-03-21 16:18:24 +01:00

1.1 KiB

+++ title = "Search" weight = 100 +++

Gutenberg can build a search index from the sections and pages content to be used by a JavaScript library: elasticlunr.

To enable it, you only need to set build_search_index = true in your config.toml and Gutenberg will generate an index for the default_language set for all pages not excluded from the search index.

It is very important to set the default_language in your config.toml if you are writing a site not in English: the index building pipelines are very different depending on the language.

After gutenberg build or gutenberg serve, you should see two files in your static directory:

  • search_index.${default_language}.js: so search_index.en.js for a default setup
  • elasticlunr.min.js

As each site will be different, Gutenberg makes no assumptions about how your search and doesn't provide the JavaScript/CSS code to do an actual search and display results. You can however look at how this very site is implementing it to have an idea: search.js.