GitHub - python/python-docs-pl: Polskie tłumaczenie dokumentacji Pythona
Read this in another language:
Jak sprawdzić, co jest do przetłumaczenia?
Służy do tego paczka
. Wywołaj ją w głównym katalogu projektu, na przykład uvx potodo.
Jeżeli interesują cię podstawowe artykuły, użyj filtrowania. Przykład:
$ 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 Propozycje priorytetowych zasobów do tłumaczenia można znaleźć w
.
Jak tłumaczyć?
Wejdź na stronę projektu
na Transifeksie.
Naciśnij przycisk „Join this project”, aby dołączyć do projektu.
Utwórz konto Transifex.
Na stronie projektu wybierz język polski.
Po wysłaniu zgłoszenia do zespołu przedstaw się na kanale
Discord Python Polska #dokumentacja
. Pozwoli to szybciej potwierdzić Twoje zgłoszenie.
Po dołączeniu do zespołu wybierz zasób, który chcesz poprawić lub zaktualizować.
Zapoznaj się ze
, formatem dokumentacji.
Więcej informacji o używaniu Transifeksa znajdziesz w
lub
.
Jak lokalnie sprawdzić poprawność moich zmian?
i zapisz
do ~/.transifexrc, aby pobrać zmiany z Transifeksa. Pobierz zmieniony rozdział, np.:
$ 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) Uruchom
, aby sprawdzić poprawność zmian, na przykład:
$ uvx sphinx-lint library/turtle.po No problems found. Jak obejrzeć najnowszy build dokumentacji?
Pobierz ostatnią zbudowaną dokumentację z listy artefaktów w ostatniej GitHub Action (zakładka Actions). Tłumaczenia pobierane są z Transifeksa do tego repozytorium co około godzinę. Dokumentacja na
aktualizowana jest około raz dziennie.
Jak zbudować dokumentację?
Aby zbudować dokumentację potrzebujesz mieć kopię repozytorium CPythona.
Zrób link symboliczny (Unix) lub kopię (Windows) zawartości projektu python-docs-pl w katalogu Doc/locales/pl/LC_MESSAGES w repozytorium CPython.
Następnie uruchom make -C Doc SPHINXOPTS="-D language=pl" html w projekcie CPython, aby zbudować dokumentację.
Kanały komunikacji
Discord Python Polska #dokumentacja
Python Documentation Community
Python Documentation Special Interest Group
Postęp tłumaczenia
Licencja
Zapraszając do współtworzenia projektu na platformie Transifex, proponujemy umowę na przekazanie twoich tłumaczeń Python Software Foundation
. W zamian będzie widoczne, że jesteś tłumaczem(-ką) części, którą przetłumaczyłeś(-łaś). Wyrażasz akceptację tej umowy, przesyłając swoją pracę do włączenia do dokumentacji.
Aktualizacje w repozytorium
./manage_translation.py recreate_tx_config
./manage_translation.py fetch
cog -rP README.md
Przydatne materiały
Python Developer's Guide: Translating
Python docs Transifex: Documentation
Podobne projekty
projekty Python Packaging Authority
Scientific Python Translations