coopcycle-docs icon indicating copy to clipboard operation
coopcycle-docs copied to clipboard

Published 20 hours ago • verified publisher icon coopcycle

Translations

Open alexsegura opened this issue 5 years ago • 1 comments

The current system to manage translated docs is too complicated.

The directory structure needs to be replicated between all languages, making it difficult to maintain if the structure changes. Moreover, the complete markdown file needs to be copied from one language to another.

It would be easier to write the docs in a reference language (English), and just translate the base docs. We could use Weblate to manage translations, either with the JavaScript Localization CDN addon, or using po4a

alexsegura avatar Oct 31 '20 17:10 alexsegura

Like explained in df0e414fb217d7d9a326d117879e714feba0a96a, the way to go is to use html2po to translate the generated website.

It seems a lot of work to have the docs translated by a human via Weblate. The most scalable solution would be to use a translation API to make the process completely automated.

There are paid services like Deepl, Yandex, and of course Google. There is also LibreTranslate which seems very promising, and we could self-host it.

alexsegura avatar Mar 23 '23 16:03 alexsegura