Docs localisation #14

It would be great to localise the documentation into different languages.
This is probably quite a long-term goal. The hardest part will be finding localisation teams for each locale.
This issue serves as a place to gather ideas on the subject.

Related: forgejo/website#4

IMHO this is where having a framework dedicated to documentation might help. I don't know if there is one that is natively supporting weblate?

Starlight supports localisation. I proposed adopting it for our docs, however on following up it will be a little more complicated than I initially thought to make it work at a subpath (forgejo.org/docs/) instead of a subdomain (docs.forgejo.org). But I will have another look at it, and other options, when I get a chance.

Thanks for the link, I missed it. Having sub-domains instead of sub-path is not too much of a problem, IMHO.

For the record Weblate is well integrated with Sphinx because both are python based https://docs.weblate.org/en/latest/devel/sphinx.html

Not very useful in the context of Forgejo

Having sub-domains instead of sub-path is not too much of a problem, IMHO.

Agreed. It would mean the docs site was entirely separate from the rest of the site architecturally, which would have both pros and cons... better discussed on forgejo/website#332.

Weblate is well integrated with Sphinx

I'd prefer to more or less stick with the stack we have for the site rather than switch to something totally different like Sphinx, unless there was a compelling reason. That's why I like the idea of Starlight if we can make it work, because it's based on Astro and maintained by the same people behind Astro itself.