A question about i18n configuration

[Justineo]

Is your issue related to your own DocSearch implementation?

It's a general usage question. I saw in the docs that we can configure certain part in URL to match language/version facets. But what if I have a default language like this:

http://www.example.com/docs/installation    -> en
http://www.example.com/docs/fr/installation -> fr
http://www.example.com/docs/jp/installation -> jp

And the following config should help docsearch to recognize language facets like fr and jp:

{
  "start_urls": [
    {
      "url": "http://www.example.com/docs/(?:(?P<lang>.*?)/)?",
      "variables": {
        "lang": ["fr", "jp"]
      }
    }
  ]
}

My question is, in this case, how can I configure for the default language (en) so that on English pages docsearch only return those results not matching any language facets? Thanks in advance.

[s-pace]

👋 @Justineo

You should rely on the content of your pages instead of relying on the URL. You can either:

• introduces DocSearch meta tags within your DOM
• extract the lang attributes from your DOM (as defined by the update of your configuration below).

You will need to update your JS snippet as following:

docsearch({
  apiKey: '21cdc123c620ec4bb81259c32e90c08f',
  indexName: 'veui',
  inputSelector: '### REPLACE ME ####',
  algoliaOptions: { 'facetFilters': ["lang:$LANG"] },
  debug: false // Set debug to true if you want to inspect the dropdown
});

• Replace $LANG with the lang you want to search on. The list of possible lang is extracted from your website according to your global lang selector. So as of today you have: en-US, zh-Hans

  For example if you want to refine the search to the lang en-US just specify:

 'facetFilters': ["lang:en-US"]

[Justineo]

@s-pace

Thanks! I have a further question: how can I properly re-initialize the docsearch after it's initialized? My site is using a front-end router so that I need to switch language at runtime.

[s-pace]

Your index will be updated every 24H. You will need to wait for the next crawl to be able to update your front. You can run our crawler on your own if you want more control. You will need you own algolia account

[Justineo]

@s-pace

I mean the docsearch.js API in the browser. I cannot find an API to change facetFilters setting or just dispose the old instance so that I can initialize again.