Supporting translations for site/docs #74
Labels
No Label
abra
abra-gandi
awaiting-feedback
backups
bug
build
ci/cd
community organising
contributing
coopcloud.tech
democracy
design
documentation
duplicate
enhancement
finance
funding
good first issue
help wanted
installer
kadabra
performance
proposal
question
recipes.coopcloud.tech
security
test
wontfix
No Milestone
No project
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: coop-cloud/organising#74
Loading…
Reference in New Issue
No description provided.
Delete Branch "%!s(<nil>)"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
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/.
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/3106Mkdocs 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
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 tomkdocs generate
instead of justmkdocs serve
so it would need a change inDockerfile
,compose.yml
and maybe other files too? I'm down to work further on that.