Updates on Beginner's Guide translation procedures
Hello,
As per Moini's request a few weeks ago (on the inkscape-docs mailing list), I explored documentation of Sphinx and ReadTheDocs, and researched a bit on the current Inkscape translation procedure. It seems like a good idea to manage the translations of the Beginners' Guide the same way as the main application:
- clone the repo - translate with local software - create a branch with new .po files - create merge requests
I've successfully created .po files for the Beginner's Guide, but I'm having trouble generating them into translated HTML files. Does anyone here have experience with translating Sphinx books? I'm wondering if it's possible to push to a branch in the guide (or somewhere else, I'm no developer😅) so that someone could investigate.
Also, are there any official procedures or software to manage coordination between translators of the same language, or is it up to individual coordinators? Asking because I plan to form a small local team (3-4 people) to help with the translations.
(BTW I'm planning to create a branch and do translations first, to separate from updates to the main version, then afterwards pull in the changes and translate them.)
Cheers, ltlnx
Readthedocs has some documentation about how it works with their website here: https://docs.readthedocs.io/en/stable/guides/manage-translations-sphinx.html
Probably you've already seen that, though?
Maren
Am 10.10.23 um 08:57 schrieb Wen-Wei Kao:
Hello,
As per Moini's request a few weeks ago (on the inkscape-docs mailing list), I explored documentation of Sphinx and ReadTheDocs, and researched a bit on the current Inkscape translation procedure. It seems like a good idea to manage the translations of the Beginners' Guide the same way as the main application:
- clone the repo
- translate with local software
- create a branch with new .po files
- create merge requests
I've successfully created .po files for the Beginner's Guide, but I'm having trouble generating them into translated HTML files. Does anyone here have experience with translating Sphinx books? I'm wondering if it's possible to push to a branch in the guide (or somewhere else, I'm no developer😅) so that someone could investigate.
Also, are there any official procedures or software to manage coordination between translators of the same language, or is it up to individual coordinators? Asking because I plan to form a small local team (3-4 people) to help with the translations.
(BTW I'm planning to create a branch and do translations first, to separate from updates to the main version, then afterwards pull in the changes and translate them.)
Cheers, ltlnx
Inkscape Translators mailing list -- inkscape-translator@lists.inkscape.org To unsubscribe send an email to inkscape-translator-leave@lists.inkscape.org
El martes, 10 de octubre de 2023 21:23:10 (CST) Maren Hachmann escribió:
Readthedocs has some documentation about how it works with their website here: https://docs.readthedocs.io/en/stable/guides/manage-translations-sphinx.html
Probably you've already seen that, though?
Maren
I have, yeah. However the paths are different from the ReadTheDocs tutorials, and I think I've got it: First of all, we need to add the locale_dirs variable to source/conf.py:
locale_dirs = ["../locale"]
The command to generate gettext files and generate a new language is:
make gettext sphinx-intl update -p build/gettext -l <LANGUAGE_CODE> and the command to generate translated html documents is:
sphinx-build -b html -D language=zh_TW source/ build/html/zh_TW
I think we could also modify the makefile to take e.g. "make translations" and run the command above, but that may be for another day.
Is it OK to create a merge request with these modifications for review?
Cheers, ltlnx
El miércoles, 11 de octubre de 2023 15:57:38 (CST) Wen-Wei Kao escribió:
Is it OK to create a merge request with these modifications for review?
Cheers, ltlnx
I've created the merge request. Also the pipeline needs to be updated to generate translated documents, but I'm no expert in editing pipelines. Is there a canonical way of adding translation pipelines, or should I copy the beginners_guide:html pipeline and replace the commands? Thanks in advance.
Cheers, ltlnx
Hi ltlnx,
thanks for the MR!
I've replied on GitLab, see you there!
Kind Regards, Maren
Am 11.10.23 um 11:13 schrieb Wen-Wei Kao:
El miércoles, 11 de octubre de 2023 15:57:38 (CST) Wen-Wei Kao escribió:
Is it OK to create a merge request with these modifications for review?
Cheers, ltlnx
I've created the merge request. Also the pipeline needs to be updated to generate translated documents, but I'm no expert in editing pipelines. Is there a canonical way of adding translation pipelines, or should I copy the beginners_guide:html pipeline and replace the commands? Thanks in advance.
Cheers, ltlnx
Inkscape Translators mailing list -- inkscape-translator@lists.inkscape.org To unsubscribe send an email to inkscape-translator-leave@lists.inkscape.org
participants (2)
-
Maren Hachmann -
Wen-Wei Kao