New docs: configure Algolia DocSearch

Algolia DocSearch support is included implicitly in the package @docusaurus/preset-classic, but not active. It requires the algolia options object to be present in docusaurus.config.js as shown below.

This seems to be done either by submitting a PR against Algolia’s public list of DocSearch indexes, or by submitting this form https://docsearch.algolia.com/apply/

Reference: Connecting Algolia.

module.exports = {
  themeConfig: {
    algolia: {
      apiKey: 'YOUR_API_KEY',
      indexName: 'YOUR_INDEX_NAME',
      searchParameters: {}, // Optional (if provided by Algolia)
    },
  },
  themes: [
    ['@docusaurus/theme-search-algolia', {}],
  ],
};

[m-vdb]

latest update:

• it works on Rasa SDK ✅
• for some reason it doesn’t work on Rasa X and Rasa 🔴
  • Rasa X behavior: no results
  • Rasa behavior: results from Rasa and Rasa X are mixed up

Continuing the conversation with their support, we should get an answer today or tomorrow for Rasa X.

[lunelson]

@akelad It’s Sylvain, yes. He finally clued me in today to what was missing: the search is not configured through our account at Algolia (though it is listed there, in the sidebar); it is configured through a JSON file in their public repo:

• docsearch-configs/rasa.json at master · algolia/docsearch-configs

This is of course out of date now, so we need to do a PR to remove that JSON and create two new ones, one for each of the new sites; however this can’t be done until their baseUrl settings are final (without the /next/ addition).

CC @m-vdb