Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
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