Mailman 3 January 2020 - Doc-SIG

Status for Transifex-based translations
by Maciek Olko Aug. 1, 2021

Aug. 1, 2021

Hello, I want to share with you a small script that displays translation status for language switcher for Transifex-based translations. The script is using Transifex API [1] and requires Transifex API token. https://github.com/m-aciek/python-docs-pl-status/blob/master/checkstatus.py It generates README.md file with status. Currently, for Polish translation it is 5.17%. Regards, Maciej [1] https://docs.transifex.com/api/resources [2] https://github.com/m-aciek/python-docs-pl-status

3 6

Polish translation
by Maciek Olko Aug. 13, 2020

Aug. 13, 2020

Hello, I'd like to request a designation to coordinator role for Polish translation of Python documentation and a creation of GitHub repository for it. I am currently a Python developer at YouGov. I am coordinator of Django documentation translation into Polish. I am native Polish speaker, my English skills are about C2 CEFR [1]. In couple of days I'd like come up with a plan to efficiently encourage people to join the translation project. Regards, Maciej Olko [1] https://en.wikipedia.org/wiki/Common_European_Framework_of_Reference_for_La…

2 5

Make code blocks translatable
by Maciek Olko Jan. 28, 2020

Jan. 28, 2020

Hello, I'd like to set up discussion about making code blocks in documentation translatable. From my experience many of code blocks would benefit from being translated. Especially comments and string literals. For example this code block from tutorial: # this is the first commentspam = 1 # and this is the second comment # ... and now a third!text = "# This is not a comment because it's inside quotes." To enable their translation, it requires slight modification of Sphinx call – gettext_additional_targets = ['literal-block'] configuration option value would do this. The option has been introduced in Sphinx 1.3. If there would be consensus about that I'd willingly add pull request in docsbuild-scripts repository. Kind regards, Maciej

2 2

Revision of resources' Transifex priorities
by Maciek Olko Jan. 26, 2020

Jan. 26, 2020

Hello, I am wondering if it would be difficult to revise Transifex priority values of resources. Now all resources have the same priority value ("high"). Would it be possible to highlight resources: - bugs, - all in tutorial directory, - library/functions, [1] - and sphinx, among others by making their priority higher? In my opinion it would ease the work with resources e.g. being able to filter them by importance. Looking forward to your opinion, Kind regards, Maciej [1] Those first three are required for a translation to be in languge switcher, therefore they are already made priorities by PEP 545. https://www.python.org/dev/peps/pep-0545/#add-translation-to-the-language-s…

1 0

Python Documentation Translation to Bahasa Indonesia (Indonesian Language)
by oon arfiandwi Jan. 4, 2020

Jan. 4, 2020

Dear doc-sig members, hope this email finds you well. my name is oon arfiandwi, currently, I'm doing a sprint to translate Python Documentation to Bahasa Indonesia, and in the next few days, it will achieve the minimum requirement, which mentioned on PEP 545, to be able to add to Language Switcher. The translation synchronized between Transifex and my github repo [1]. I have several questions before I continue the process: a. according to devguide site [2], I need to finish `library/stdtypes` too, but it is not mentioned on (current PEP 545). can someone help me to clarify which one is the minimum? b. I saw on Python's github repo, many python-doc-{LANG} hosted there, how to request `python-doc-id` on that repository? c. Is it mandatory to have reviewer on Transifex? I saw not many languages doing reviews on the translation there. d. and what to do next, if I have completed the translations (a), to be included on language switcher? thank you for any help and explanation. [1]: https://github.com/oonid/python-docs-id [2]: https://devguide.python.org/documenting/#starting-a-new-translation -- sincerely, oon arfiandwi

3 12