From 31a419b218b41175df6ff3d133d13722a7b4e777 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Tue, 2 Dec 2025 11:17:26 +0100 Subject: [PATCH 1/4] Create virtual environment for gettext build when updating tx config --- manage_translation.py | 1 + 1 file changed, 1 insertion(+) diff --git a/manage_translation.py b/manage_translation.py index dc930ae922..55c936ded0 100755 --- a/manage_translation.py +++ b/manage_translation.py @@ -90,6 +90,7 @@ def _clone_cpython_repo(version: str): def _build_gettext(): + _call("make -C cpython/Doc/ venv") _call("make -C cpython/Doc/ gettext") From c679ac453b9bb7571c74a27e6f0ec97c862e45e7 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Mon, 2 Dec 2024 19:32:12 +0100 Subject: [PATCH 2/4] Install six in CI Workarounds https://github.com/transifex/transifex-python/issues/121. Closes #46. --- .github/workflows/update-lint-and-build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/update-lint-and-build.yml b/.github/workflows/update-lint-and-build.yml index 86286cd543..2bf684afe6 100644 --- a/.github/workflows/update-lint-and-build.yml +++ b/.github/workflows/update-lint-and-build.yml @@ -19,7 +19,7 @@ jobs: with: python-version: 3 - run: sudo apt-get install -y gettext - - run: pip install requests cogapp polib transifex-python sphinx-intl blurb + - run: pip install requests cogapp polib transifex-python sphinx-intl blurb six - run: curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash working-directory: /usr/local/bin - uses: actions/checkout@master From 47c0f6288c80464a97f665b5fea5c13a841cfc55 Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Tue, 2 Dec 2025 18:27:01 +0100 Subject: [PATCH 3/4] Use current branch for testing --- .github/workflows/update-lint-and-build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/update-lint-and-build.yml b/.github/workflows/update-lint-and-build.yml index 2bf684afe6..6e5bf177d6 100644 --- a/.github/workflows/update-lint-and-build.yml +++ b/.github/workflows/update-lint-and-build.yml @@ -24,7 +24,7 @@ jobs: working-directory: /usr/local/bin - uses: actions/checkout@master with: - ref: ${{ matrix.version }} + ref: ${{ github.ref_name }} - run: ./manage_translation.py recreate_tx_config env: TX_TOKEN: ${{ secrets.TX_TOKEN }} From 6327988733adb43478ab1b81a72d5c6fcb5b4f9c Mon Sep 17 00:00:00 2001 From: Maciej Olko Date: Tue, 2 Dec 2025 23:00:49 +0100 Subject: [PATCH 4/4] Revert removing README --- README.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000000..486eb6f5d3 --- /dev/null +++ b/README.md @@ -0,0 +1,73 @@ +Polskie tłumaczenie dokumentacji Pythona +======================================== + +![build](https://github.com/python/python-docs-pl/workflows/.github/workflows/update-lint-and-build.yml/badge.svg) +![97.94% przełącznika języków](https://img.shields.io/badge/przełącznik_języków-97.94%25-0.svg) +![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-5.07%25-0.svg) +![6 tłumaczy](https://img.shields.io/badge/tłumaczy-6-0.svg) + + +Jeśli znalazłeś(-aś) błąd lub masz sugestię, +[dodaj zgłoszenie](https://github.com/python/python-docs-pl/issues) w tym projekcie lub +napraw go sam(a): + +* Wejdź na stronę +projektu [dokumentacji Pythona](https://explore.transifex.com/python-doc/python-newest/). +* Naciśnij przycisk „Join this project”, aby dołączyć do projektu. +* Utwórz konto Transifex. +* Na stronie projektu wybierz język polski. +* Po dołączeniu do zespołu, wybierz zasób, który chcesz poprawić/zaktualizować. + +Więcej informacji o używaniu Transifeksa znajdziesz w +[jego dokumentacji](https://docs.transifex.com/getting-started-1/translators). + +**Postęp tłumaczenia** + +![postęp tłumaczenia do przełącznika języków](language-switcher-progress.svg) + +Język polski pojawi się w przełączniku języków na docs.python.org, +[kiedy w pełni przetłumaczone będą](https://www.python.org/dev/peps/pep-0545/#add-translation-to-the-language-switcher): +* `bugs`, +* wszystkie zasoby z katalogu `tutorial`, +* `library/functions`. + +**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 pół godziny. +Dokumentacja na python.org aktualizowana jest około raz dziennie. + +**Kanały komunikacji** + +* [python-docs-pl Discord](https://discord.gg/3faJmGKhta) +* [Python translations working group](https://mail.python.org/mailman3/lists/translation.python.org/) +* [Python Documentation Special Interest Group](https://www.python.org/community/sigs/current/doc-sig/) + +**Licencja** + +Zapraszając do współtworzenia projektu na platformie Transifex, proponujemy umowę na +przekazanie twoich tłumaczeń Python Software Foundation +[na licencji CC0](https://creativecommons.org/publicdomain/zero/1.0/deed.pl). +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 fetch` +* `cog -rP README.md` + +**Potencjalnie przydatne materiały** +* [polskie tłumaczenie dokumentacji Pythona 2.3](https://pl.python.org/docs/).