Support for multilingual pages

chucker commented 2 years ago

This will require some brainstorming.

Goal

Translating an entire wiki is probably impractical, but it should be possible for individual pages to be available in multiple languages.

Design idea

If a page is named My-Document.en-us.md instead of My-Document.md, consider that the US English version.
If this matches the browser's Accept-Language header, default to showing that.
If additional languages exist, show flags in the top right to switch to those, e.g. a German flag for My-Document.de-de.md.

Considerations:

will this suck to use in Azure DevOps itself?
how does the search know which language to filter for?

ricardoboss commented 2 years ago

For the search: we could introduce multiple indexes, one for each language found in the sources. The API can then provide a way to select which languages to search.

chucker commented 2 years ago

Yes, but each language's index should also contain the fallback pages, where necessary.

chucker commented 1 year ago

I'm confused how this differs from #8. :)

ricardoboss commented 1 year ago

You tell me, you're the author of both :D

chucker commented 1 year ago

I know 😂

trenz-gmbh / trenz-docs