Read this in another language: English
Jak sprawdzić, co jest do przetłumaczenia?
Służy do tego paczka potodo. Wywołaj ją w głównym katalogu projektu, np. 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 issue #50.
Jak tłumaczyć?
- Wejdź na stronę projektu dokumentacji Pythona 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ć/zaktualizować.
Więcej informacji o używaniu Transifeksa znajdziesz w jego artykułach pomocy lub w naszym przewodniku.
Jak lokalnie sprawdzić poprawność moich zmian?
Zainstaluj Transifex CLI i zapisz
klucz API Transifex 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 sphinx-lint, aby sprawdzić poprawność zmian, np.:
$ 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 https://docs.python.org/pl/ aktualizowana jest około raz dziennie.
Jak zbudować dokumentację?
Na Uniksach zrób link symboliczny projektu python-docs-pl w katalogu Doc/locales/pl on nazwie LC_MESSAGES.
Na Windowsie skopiuj zawartość katalogu projektu do podanej ścieżki.
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 na licencji CC0. 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.
Aktualizacja tłumaczeń
./manage_translation.py recreate_tx_config./manage_translation.py fetchcog -rP README.md
Przydatne materiały
Podobne projekty