[Doc-SIG] Tutorial

Julien Palard julien at palard.fr
Sun Dec 9 16:44:12 EST 2018


Hi!

> In the next few days I'll be start working on translating the Python (3.7) tutorial to Bulgarian language. It's my native language and not long ago, I saw that the only tutorial in this language (official, from python.org) is for version 2.0... little bit old.

Glad you're joining the translation effort! If your long-term goal is to publish your translation to docs.python.org/ please take a look at the PEP 545.

TL-DR:

- Use any tooling you want to translate the .po files that a `sphinx-build -b gettext` will give you from the cpython Doc/ directory (don't work directly on .rst files).
- At the end, you should publish the work as a github repository like https://github.com/python/python-docs-fr/ (some countries like fr are working as pull requests on the repo, some other are using external tooling like transifex and are pulling from transifex to the repo, like ja).

Don't hesitate to take a look at how different countries are working in their respective repo on github.com/python/python-docs-[language], typically in fr we have a Makefile that can help you building a local HTML version for proofreading.

I should do a cookiecutter to bootstrap a repo þ Not sure I have the time right now but I can try it.

-- 
Julien Palard
https://mdk.fr



More information about the Doc-SIG mailing list