python-docs-pl/README.en.md at 3.15 · python/python-docs-pl
Polish Translation of Python Documentation
Przeczytaj to w innym języku:
How do I check what needs translating?
Use the
package. Run it in the project's root directory, for example: uvx potodo.
If you are interested in the core articles, use filtering. For example:
$ uvx potodo --exclude '**/*' '!tutorial/*' '!bugs.po' '!library/functions.po' 1 directory 99.68% done └── python-docs-pl/ 99.68% done ├── library/ 98.61% done │ └── functions.po 99.0% translated 535/536 └── tutorial/ 100.00% done Suggested priority resources for translation can be found in
.
How do I translate?
Go to the
on Transifex.
Click the "Join this project" button.
Create an account on Transifex.
Select Polish on the project page.
After submitting your request to join the team, introduce yourself on the
Python Polska #dokumentacja Discord channel
. This will help us approve your request sooner.
After joining the team, select the resource you want to improve or update.
Get familiar with
, the documentation format.
You can find more information about using Transifex in
or
.
How do I check my changes locally?
and save your
to ~/.transifexrc so that you can download changes from Transifex. Download the changed chapter, for example:
$ tx pull --languages pl python-newest.library--turtle # Getting info about resources python-newest.library--turtle - Done [##############################] (1 / 1) # Pulling files python-newest.library--turtle [pl] - Done [##############################] (1 / 1) Run
to check your changes, for example:
$ uvx sphinx-lint library/turtle.po No problems found. How do I see the latest build of the documentation?
Download the latest build from the list of artefacts in the latest GitHub Action (Actions Tab). Translations are pulled from Transifex around once an hour. The documentation at
is updated around once daily.
How do I build the documentation?
Communication channels
Discord Python Polska #dokumentacja
Python Documentation Community
Python Documentation Special Interest Group
Translation progress
License
By inviting you to work on a project on the Transifex platform, we offer a contract for donating your translations to the Python Software Foundation
. In return, it will be visible that you are the translator of the part you translated. You signify your acceptance of this agreement by submitting your work for inclusion in the documentation.
Repository updates
./manage_translation.py recreate_tx_config
./manage_translation.py fetch
cog -rP README.en.md
Useful materials
Python Developer's Guide: Translating
Python docs Transifex: Documentation
Similar projects
Projects of the Python Packaging Authority
Scientific Python Translations