Read this in another language: English

Służy do tego paczka potodo. 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 issue #50.

• 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ć lub zaktualizować.
• Zapoznaj się ze składnią reStructuredText, formatem dokumentacji.
• Więcej informacji o używaniu Transifeksa znajdziesz w jego artykułach pomocy lub w naszym przewodniku.

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, na przykład:

$ uvx sphinx-lint library/turtle.po
No problems found.

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.

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ę.

• Discord Python Polska #dokumentacja
• Python Documentation Community
• Python Documentation Special Interest Group

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.

• ./manage_translation.py recreate_tx_config
• ./manage_translation.py fetch
• cog -rP README.md

• Python Developer's Guide: Translating
• Python docs Transifex: Documentation
• statystyki oglądalności

• projekty Python Packaging Authority
• Scientific Python Translations
• micro:bit translation programme
• tłumaczenie Sphinksa
• Localizing Django