From f89e05fd3c2cdbbb78f2dcf306736cbb7d06b582 Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 13:08:34 +0300 Subject: [PATCH 1/9] Use venv in docs build command --- .github/workflows/transifex-pull.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/transifex-pull.yml b/.github/workflows/transifex-pull.yml index d3dcfe3e..36f2d576 100644 --- a/.github/workflows/transifex-pull.yml +++ b/.github/workflows/transifex-pull.yml @@ -49,7 +49,7 @@ jobs: p = Path("transifex-util.py") old = '_call("make -C cpython/Doc/ gettext")' - new = '_call("make -C cpython/Doc/ JOBS=1 gettext || make -C cpython/Doc/ JOBS=1 build BUILDER=gettext")' + new = '_call("make -C cpython/Doc/ venv")\n _call("make -C cpython/Doc/ JOBS=1 gettext || make -C cpython/Doc/ JOBS=1 build BUILDER=gettext")' s = p.read_text() if old not in s: raise SystemExit("Expected pattern was not found in transifex-util.py") From 4755b840a828086326d7f1e332b2ab1bd79161dc Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Thu, 13 Aug 2026 11:08:49 +0100 Subject: [PATCH 2/9] Fix link to TX --- README.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.rst b/README.rst index 84c8ca0c..7f11ef59 100644 --- a/README.rst +++ b/README.rst @@ -1,8 +1,7 @@ RU Translation of the Python Documentation ============================================= -All translations are done on transifex. -https://www.transifex.com/python-doc/public/ +All translations are done on [Transifex](https://www.transifex.com/python-doc/python-newest/). Documentation Contribution Agreement ------------------------------------ From bb304b19cdc91db5ec5cc023bf111ae7943e3c4e Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 13:49:46 +0300 Subject: [PATCH 3/9] fix git diff command to check for untracked files --- .github/workflows/transifex-pull.yml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/.github/workflows/transifex-pull.yml b/.github/workflows/transifex-pull.yml index 36f2d576..8ddc3fe9 100644 --- a/.github/workflows/transifex-pull.yml +++ b/.github/workflows/transifex-pull.yml @@ -67,12 +67,13 @@ jobs: run: | git config --local user.email github-actions@github.com git config --local user.name "GitHub Action's update-translation job" + - run: git add -N . ':!transifex-util.py' - name: Filter files run: | - ! git diff -I'^"POT-Creation-Date: ' \ - -I'^"Language-Team: ' \ - -I'^# ' -I'^"Last-Translator: ' \ - --exit-code \ + ! git diff --cached -I'^"POT-Creation-Date: ' \ + -I'^"Language-Team: ' \ + -I'^# ' -I'^"Last-Translator: ' \ + --exit-code \ && echo "SIGNIFICANT_CHANGES=1" >> $GITHUB_ENV || exit 0 - run: git add . ':!transifex-util.py' - run: git commit -m 'Update translation from Transifex' From 08f981293b736fc73dd1e5728d7144585921d899 Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 13:58:51 +0300 Subject: [PATCH 4/9] add debug --- .github/workflows/transifex-pull.yml | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/.github/workflows/transifex-pull.yml b/.github/workflows/transifex-pull.yml index 8ddc3fe9..40480c51 100644 --- a/.github/workflows/transifex-pull.yml +++ b/.github/workflows/transifex-pull.yml @@ -63,6 +63,19 @@ jobs: env: TX_TOKEN: ${{ secrets.TX_TOKEN }} - run: ./transifex-util.py delete_obsolete_files --language ru --project-slug python-newest --version ${{ matrix.version }} + - name: Debug fetched files + run: | + set -euxo pipefail + echo "== git status ==" + git status --short --ignored + echo "== untracked files ==" + git ls-files -o --exclude-standard + echo "== ignored files ==" + git ls-files -oi --exclude-standard + echo "== worktree diff ==" + git diff --name-status -- . ':!transifex-util.py' + echo "== cached diff ==" + git diff --cached --name-status -- . ':!transifex-util.py' - name: Set up Git run: | git config --local user.email github-actions@github.com From 67af8abf50ca308c938cd3ceb53225475f318354 Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 14:03:56 +0300 Subject: [PATCH 5/9] fix git add command to stage all changes --- .github/workflows/transifex-pull.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/.github/workflows/transifex-pull.yml b/.github/workflows/transifex-pull.yml index 40480c51..184233e5 100644 --- a/.github/workflows/transifex-pull.yml +++ b/.github/workflows/transifex-pull.yml @@ -80,7 +80,11 @@ jobs: run: | git config --local user.email github-actions@github.com git config --local user.name "GitHub Action's update-translation job" - - run: git add -N . ':!transifex-util.py' + - run: git add . ':!transifex-util.py' + - name: Debug staged files + run: | + echo "== staged after git add ==" + git diff --cached --name-status -- . ':!transifex-util.py' - name: Filter files run: | ! git diff --cached -I'^"POT-Creation-Date: ' \ @@ -88,7 +92,6 @@ jobs: -I'^# ' -I'^"Last-Translator: ' \ --exit-code \ && echo "SIGNIFICANT_CHANGES=1" >> $GITHUB_ENV || exit 0 - - run: git add . ':!transifex-util.py' - run: git commit -m 'Update translation from Transifex' if: env.SIGNIFICANT_CHANGES == '1' - uses: ad-m/github-push-action@master From 513cfeaf3ef66351189da0512b888d5b767247d5 Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 14:15:14 +0300 Subject: [PATCH 6/9] add installation step for SVG converter in LaTeX build --- .github/workflows/test-build.yml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/.github/workflows/test-build.yml b/.github/workflows/test-build.yml index 76405528..0abbc1af 100644 --- a/.github/workflows/test-build.yml +++ b/.github/workflows/test-build.yml @@ -32,6 +32,11 @@ jobs: path: Doc/locales/ru/LC_MESSAGES - run: git pull working-directory: ./Doc/locales/ru/LC_MESSAGES + - name: Install SVG converter for LaTeX build + if: matrix.format == 'latex' + run: | + sudo apt-get update + sudo apt-get install -y librsvg2-bin - uses: sphinx-doc/github-problem-matcher@v1.1 - run: make -e SPHINXOPTS="--color -D language='ru' -W --keep-going" ${{ matrix.format }} working-directory: ./Doc From 05eb0da1e804ce8de0075b221e7756cdb6cffb75 Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 14:19:13 +0300 Subject: [PATCH 7/9] remove debug steps from Transifex pull workflow --- .github/workflows/transifex-pull.yml | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/.github/workflows/transifex-pull.yml b/.github/workflows/transifex-pull.yml index 184233e5..25a11255 100644 --- a/.github/workflows/transifex-pull.yml +++ b/.github/workflows/transifex-pull.yml @@ -55,7 +55,6 @@ jobs: raise SystemExit("Expected pattern was not found in transifex-util.py") p.write_text(s.replace(old, new)) PY - grep -n "JOBS=1" transifex-util.py - run: ./transifex-util.py recreate_tx_config --language ru --project-slug python-newest --version ${{ matrix.version }} env: TX_TOKEN: ${{ secrets.TX_TOKEN }} @@ -63,28 +62,11 @@ jobs: env: TX_TOKEN: ${{ secrets.TX_TOKEN }} - run: ./transifex-util.py delete_obsolete_files --language ru --project-slug python-newest --version ${{ matrix.version }} - - name: Debug fetched files - run: | - set -euxo pipefail - echo "== git status ==" - git status --short --ignored - echo "== untracked files ==" - git ls-files -o --exclude-standard - echo "== ignored files ==" - git ls-files -oi --exclude-standard - echo "== worktree diff ==" - git diff --name-status -- . ':!transifex-util.py' - echo "== cached diff ==" - git diff --cached --name-status -- . ':!transifex-util.py' - name: Set up Git run: | git config --local user.email github-actions@github.com git config --local user.name "GitHub Action's update-translation job" - run: git add . ':!transifex-util.py' - - name: Debug staged files - run: | - echo "== staged after git add ==" - git diff --cached --name-status -- . ':!transifex-util.py' - name: Filter files run: | ! git diff --cached -I'^"POT-Creation-Date: ' \ From c475c4fe8e8d0799acb8593aed214977124697ec Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Thu, 13 Aug 2026 12:22:10 +0100 Subject: [PATCH 8/9] Fixup link --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 7f11ef59..a61eb5bf 100644 --- a/README.rst +++ b/README.rst @@ -1,7 +1,7 @@ RU Translation of the Python Documentation ============================================= -All translations are done on [Transifex](https://www.transifex.com/python-doc/python-newest/). +All translations are done on [Transifex](https://explore.transifex.com/python-doc/python-newest/). Documentation Contribution Agreement ------------------------------------ From 06317c76f3ab6a39258779a736a5911a9209e5cc Mon Sep 17 00:00:00 2001 From: MLGRussianXP Date: Thu, 13 Aug 2026 14:26:25 +0300 Subject: [PATCH 9/9] rewrite README in markdown --- README.rst => README.md | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) rename README.rst => README.md (78%) diff --git a/README.rst b/README.md similarity index 78% rename from README.rst rename to README.md index a61eb5bf..1cb142bf 100644 --- a/README.rst +++ b/README.md @@ -1,10 +1,8 @@ -RU Translation of the Python Documentation -============================================= +# RU Translation of the Python Documentation All translations are done on [Transifex](https://explore.transifex.com/python-doc/python-newest/). -Documentation Contribution Agreement ------------------------------------- +## Documentation Contribution Agreement NOTE REGARDING THE LICENSE FOR TRANSLATIONS: Python's documentation is maintained using a global network of volunteers. By posting this @@ -25,12 +23,9 @@ Python community is welcomed and appreciated. You signify acceptance of this agreement by submitting your work to the PSF for inclusion in the documentation. -Contributing to the Translation -------------------------------- +## Contributing to the Translation -Join the Russian team on transifex to start. +Join the Russian team on Transifex to start. You're recommended to join -`our Telegram channel`__ first. - -__ https://t.me/py_docs_ru +[our Telegram channel](https://t.me/py_docs_ru) first.