Polskie tumaczenie dokumentacji Pythona

[build] [podstawowe artykuy 100.00%] [postp tumaczenia caoci dokumentacji] [postp tumaczenia caoci dokumentacji] [liczba bdw lintowania]

Read this in another language: English

Suy do tego paczka potodo. Wywoaj j w gwnym katalogu projektu, na przykad uvx potodo.

Jeeli interesuj ci podstawowe artykuy, uyj filtrowania. Przykad:

$ 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 zasobw do tumaczenia mona znale w issue #50.

• Wejd na stron projektu dokumentacji Pythona na Transifeksie.
• Nacinij przycisk Join this project, aby doczy do projektu.
• Utwrz konto Transifex.
• Na stronie projektu wybierz jzyk polski.
• Po wysaniu zgoszenia do zespou przedstaw si na kanale Discord Python Polska #dokumentacja. Pozwoli to szybciej potwierdzi Twoje zgoszenie.
• Po doczeniu do zespou wybierz zasb, ktry chcesz poprawi lub zaktualizowa.
• Zapoznaj si ze skadni reStructuredText, formatem dokumentacji.
• Wicej informacji o uywaniu Transifeksa znajdziesz w jego artykuach 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 przykad:

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

Pobierz ostatni zbudowan dokumentacj z listy artefaktw w ostatniej GitHub Action (zakadka Actions). Tumaczenia pobierane s z Transifeksa do tego repozytorium co okoo godzin. Dokumentacja na https://docs.python.org/pl/ aktualizowana jest okoo raz dziennie.

Aby zbudowa dokumentacj potrzebujesz mie kopi repozytorium CPythona.

Zrb link symboliczny (Unix) lub kopi (Windows) zawartoci projektu python-docs-pl w katalogu Doc/locales/pl/LC_MESSAGES w repozytorium CPython.

Nastpnie 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

[Postp tumaczenia]

Zapraszajc do wsptworzenia projektu na platformie Transifex, proponujemy umow na przekazanie twoich tumacze Python Software Foundation na licencji CC0. W zamian bdzie widoczne, e jeste tumaczem(-k) czci, ktr przetumaczye(-a). Wyraasz akceptacj tej umowy, przesyajc swoj prac do wczenia 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 ogldalnoci

• projekty Python Packaging Authority
• Scientific Python Translations
• micro:bit translation programme
• tumaczenie Sphinksa
• Localizing Django