Mailman 3 - Doc-SIG - python.org

Discussion on Translation Platform for Python Docs
by Maciek Olko Feb. 13, 2025

Feb. 13, 2025

Hello, I would like to reach out to the coordinators of Python docs translation teams that currently use Transifex as their translation platform. For some time, I have been considering Weblate as an alternative. In October 2022, Transifex disabled shared translation memory for open-source projects. [1] Switching platforms would impact all projects using Transifex, so it would be helpful to gather input from the coordinators before discussing funding for hosted Weblate projects with the PSF. Weblate is Python-based, actively maintained, and follows a libre distribution model. Could you please share your thoughts on this? Should we consider some other translation tools or platforms? Best regards, Maciej Olko [1] https://discuss.python.org/t/docs-translation-platform/29940

2 1

Bulgarian Translation Documentation
by cyberthread July 13, 2023

July 13, 2023

Hello guys, currently I have spare time and I'd like to use it to translate the official documentation for python 3.*. Can you recommend me a tool if you're using one regarding the writing itself, not the translation process. Thanks in advance! Regards, """ Is all that we see or seem but a dream within a dream? """ Sent with [Proton Mail](https://proton.me/) secure email.

2 1

Docs translations stats and new Transifex API
by Maciek Olko Feb. 26, 2023

Feb. 26, 2023

Hi Shengjing Zhu, On 15th of February Transifex switched to API v3 while sunsetting their current API. Your app gce.zhsj.me/python/ with translations statistics stopped working. Would you consider sharing sources of the app, to enable others to make a PR with an update? For what it's worth, I'm linking commits I did to update similar functonalities we have in Polish translation repo. https://github.com/python/python-docs-pl/commit/7709c4b476f21caca780b13efe4… https://github.com/python/python-docs-pl/commit/dc2f73315118aa42c0f29c981b4… Kind regards, Maciej

2 1

Transifex resources priority
by Maciek Olko Oct. 19, 2022

Oct. 19, 2022

Hello all, I am wondering if it would be possible to revise Transifex priority values of resources. There are three possible values for resource priority on Transifex: - medium - high - and urgent. [1] Currently all resources on Transifex have priority "high". PEP 545 prioritizes resources that are required for the translation to be included in language switcher, namely: - "bugs", - starting with "tutorial--", - "library--functions". [2] Would it be possible to preserve "high" only for those resources plus "sphinx" resource (messages from Sphinx template) and lower priority of all other resources to "medium"? >From my experience resources priority affect the choice of a translator for an order of translation. Looking forward to your opinion, Kind regards, Maciej [1] https://docs.transifex.com/projects/categorizing-and-prioritizing-resources… [2] https://www.python.org/dev/peps/pep-0545/#add-translation-to-the-language-s…

2 3

Transifex is out of sync
by Shengjing Zhu Nov. 22, 2021

Nov. 22, 2021

Hi tomo, We notice the English pot files are not synced to Transifex for some months. Could you take a look? Probably due to Travis CI is no longer available? And do you need some help? Thanks. -- Regards, Shengjing Zhu

4 6

Japanese Python documentation has been left not built and old
by tomo cocoa Aug. 29, 2021

Aug. 29, 2021

Hi, All I don't know why, but no Japanese Python documentation has been built. The python-docs-ja repository has been updated, so I think there is something else wrong. Please let me know if you have any ideas. Regards, cocoatomo -- class Cocoatomo: name = 'cocoatomo' email_address = 'cocoatomo77(a)gmail.com' twitter_id = '@cocoatomo'

1 0

Multiple coordinators for one language?
by Wey-Han Liaw Aug. 16, 2021

Aug. 16, 2021

Hi there, This is Wey-Han (adrianliaw) from zh-tw team, and as described in the subject: Is it ok to have multiple coordinators for one language? For our team which I'm currently calling for a new coordinator to take over my role, it would help a lot if we can do that :) Regards, Wey-Han

2 2

Fwd: New Transifex API
by Marco Rougeth Aug. 7, 2021

Aug. 7, 2021

Hi there! The Brazilian translation community uses Transifex API for quite a few tasks and, the recently released version of it will break a couple of our use cases. For example, we have scripts that generate weekly reports, where we can see the progress of the week and the areas in the doc recently changed. This helps us to keep track of our work and to focus on missing translation sections. Another example is a bot we created to send a random string to everybody that wants to participate. It runs daily and, the best part is that for simple or small phrases, the user can reply the translated version directly to the bot without ever going to the Transifex website. We have done all of that using version 2.5 of the official Transifex API. The problem is that they've released version 3 of the API, which is not backwards compatible with the one we are currently using. One of the breaking changes is that in the new API, listing the resources (or *.po files) is allowed only for maintainers of the project on Transifex. We’ve confirmed this issue with their support: Only Project Maintainers can add/remove resources, thus resources can only > be queried by Project Maintainers and Administrators. So, if you grant > access to this role, you will have access to that list. > With that said, I’d like to know if we can have someone from our community promoted as a maintainer of the python-doc project on Transifex. This will allow us to migrate to the new API version without losing our tools. Cheers, Marco. --- Originally sent to translation(a)python.org. Thanks Shengjing Zhu reminding me about doc-sig mailing list.

1 0

Heads up for stepping down as the coordinator of zh-tw translation
by Wey-Han Liaw Aug. 2, 2021

Aug. 2, 2021

Hi, This is Wey-Han (adrianliaw), the coordinator of the zh-tw translation. I want to give an advance notification that I may hand the zh-tw translation project over to someone else in the near future, because I'm currently not in a good state where I'm able to lead the team whilst there are increasing efforts in Taiwan to contribute recently. For the time before somebody volunteers to be the new coordinator, I'll still be responsible if the docs failed to build somehow because of the translation (very unlikely, I assume). I'll also help making sure the new coordinator understands PEP 545, and I'll make an announcement when it happens. Please let me know if there's anything I need to do or pay attention to when switching the coordinator. Thank you :) Regards, Wey-Han "Adrian" Liaw

2 1

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