Supporting translations for site/docs #74

New Issue

decentral1se · 2021-06-17T20:27:05Z

decentral1se commented

2021-06-17 20:27:05 +00:00

We probably want to allow translation to happen in:

How to do that with a workflow that is not crap? Idk how mkdocs/hugo integrate there.

I remember people telling me to use https://www.transifex.com/.

We probably want to allow translation to happen in: - https://coopcloud.tech - https://docs.coopcloud.tech How to do that with a workflow that is not crap? Idk how mkdocs/hugo integrate there. I remember people telling me to use https://www.transifex.com/.

decentral1se added this to the (deleted) milestone 2021-06-17 20:27:05 +00:00

decentral1se added the

documentation

label 2021-06-17 20:27:05 +00:00

decentral1se referenced this issue

2021-06-19 08:38:03 +00:00

Designing the documentation #78

decentral1se added this to the (deleted) milestone 2021-09-09 14:29:41 +00:00

3wordchant commented

2021-10-31 12:56:43 +00:00

No strong preferences Transifex vs Weblate, I've used Weblate and it was fine.

The main challenge, for docs and our site, seems to be getting Markdown files into Gettext format.

Some research:

Hugo: https://invent.kde.org/websites/hugo-i18n
README files (maybe?) using po4a: https://github.com/WeblateOrg/weblate/issues/3106

Mkdocs seems to support language translations for themes using Gettext already: https://www.mkdocs.org/dev-guide/translations/ For translating content we'd probably need a separate plugin: https://pypi.org/project/mkdocs-translations/

Issue tracking adding i18n to mkdocs core https://github.com/mkdocs/mkdocs/issues/211

No strong preferences Transifex vs Weblate, I've used Weblate and it was fine. The main challenge, for docs and our site, seems to be getting Markdown files into Gettext format. Some research: Hugo: https://invent.kde.org/websites/hugo-i18n README files (maybe?) using `po4a`: https://github.com/WeblateOrg/weblate/issues/3106 Mkdocs seems to support language translations for themes using Gettext already: https://www.mkdocs.org/dev-guide/translations/ For translating content we'd probably need a separate plugin: https://pypi.org/project/mkdocs-translations/ Issue tracking adding i18n to mkdocs core https://github.com/mkdocs/mkdocs/issues/211

decentral1se added this to the Beta release (software) project 2022-01-03 17:51:55 +00:00

decentral1se removed this from the (deleted) milestone 2022-02-09 17:49:36 +00:00

decentral1se removed this from the Beta release (software) project 2022-02-09 17:49:38 +00:00

3wordchant added this to the (deleted) project 2023-01-11 16:14:56 +00:00

3wordchant modified the project from (deleted) to Federation & abra fixes

2023-01-11 16:18:32 +00:00

knoflook commented

2023-02-10 18:13:53 +00:00

I started some work on this in https://git.coopcloud.tech/coop-cloud/docs.coopcloud.tech/src/branch/translation, seems like we can only have one nav statement meaning the main navigation on top will always be in english? I think i found a workaround for it here: https://github.com/squidfunk/mkdocs-material/discussions/2346 but it would require us to mkdocs generate instead of just mkdocs serve so it would need a change in Dockerfile, compose.yml and maybe other files too? I'm down to work further on that.

I started some work on this in https://git.coopcloud.tech/coop-cloud/docs.coopcloud.tech/src/branch/translation, seems like we can only have one `nav` statement meaning the main navigation on top will always be in english? I think i found a workaround for it here: https://github.com/squidfunk/mkdocs-material/discussions/2346 but it would require us to `mkdocs generate` instead of just `mkdocs serve` so it would need a change in `Dockerfile`, `compose.yml` and maybe other files too? I'm down to work further on that.

decentral1se modified the project from Federation & abra fixes to (deleted)

2023-06-08 09:32:58 +00:00

decentral1se added this to the Documentation project 2025-04-20 06:04:31 +00:00

Sign in to join this conversation.

3 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: toolshed/organising#74