Merge branch '3.14' into Translation_of_the_library/__main__.po_file

Author: invincible627

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,5 @@
 blank_issues_enabled: true
 contact_links:
   - name: راهنمای مشارکت (CONTRIBUTING.md)
-    url: https://github.com/revisto/python-docs-fa/blob/3.14/CONTRIBUTING.md
+    url: https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md
     about: پیش از ثبت issue، لطفاً راهنمای مشارکت و README را مطالعه کنید

.github/workflows/build-and-deploy.yml

@@ -25,7 +25,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           repository: python/cpython
-          ref: v3.14.6
+          ref: v3.14.7
 
       - name: Set up Python
         uses: actions/setup-python@v4

.github/workflows/lint.yml

@@ -19,7 +19,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           repository: python/cpython
-          ref: v3.14.6
+          ref: v3.14.7
 
       - name: Set up Python
         uses: actions/setup-python@v4

.github/workflows/sync-with-cpython.yml

@@ -6,9 +6,9 @@ on:
   workflow_dispatch:
     inputs:
       cpython_tag:
-        description: 'CPython tag to sync against (e.g. v3.14.6)'
+        description: 'CPython tag to sync against (e.g. v3.14.7)'
         required: false
-        default: 'v3.14.6'
+        default: 'v3.14.7'
 
 permissions:
   contents: write
@@ -21,6 +21,8 @@ concurrency:
 jobs:
   sync:
     runs-on: ubuntu-latest
+    env:
+      CPYTHON_TAG: ${{ github.event.inputs.cpython_tag || 'v3.14.7' }}
     steps:
       - name: Checkout translation repo
         uses: actions/checkout@v4
@@ -38,41 +40,12 @@ jobs:
       - name: Install Python dependencies
         run: pip install sphinx sphinx-intl
 
-      - name: Checkout CPython docs only (sparse)
-        run: |
-          git clone \
-            --depth 1 \
-            --filter=blob:none \
-            --sparse \
-            --branch ${{ github.event.inputs.cpython_tag || 'v3.14.6' }} \
-            https://github.com/python/cpython.git \
-            .cpython-src
-          cd .cpython-src
-          git sparse-checkout set Doc Include
-
-      - name: Install CPython doc dependencies
-        run: |
-          python -m venv .cpython-src/Doc/venv
-          .cpython-src/Doc/venv/bin/pip install \
-            -r .cpython-src/Doc/requirements.txt
-
-      - name: Build .pot templates
-        run: |
-          cd .cpython-src/Doc
-          ./venv/bin/sphinx-build \
-            -b gettext \
-            . \
-            ../../.pot-templates
-
-      - name: Merge .pot into .po files
-        run: |
-          find .pot-templates -name "*.pot" | while read f; do
-            rel="${f#.pot-templates/}"
-            po="${rel%.pot}.po"
-            if [ -f "$po" ]; then
-              msgmerge --update --backup=off --no-location --no-wrap "$po" "$f"
-            fi
-          done
+      # Item 4: fetch/build/merge/validate now all live in one shared
+      # module (scripts/po_sync.py) instead of inline bash/awk here, so
+      # this workflow can't drift from update_python_version.py the way
+      # it did before (missing --no-location --no-wrap on one side).
+      - name: Sync msgids (fetch, build gettext, merge, validate)
+        run: python scripts/po_sync.py sync-only "$CPYTHON_TAG"
 
       - name: Ensure translation label exists
         env:
@@ -87,7 +60,6 @@ jobs:
       - name: Open issue for fuzzy strings
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          CPYTHON_TAG: ${{ github.event.inputs.cpython_tag || 'v3.14.6' }}
         run: |
           tmpfile=$(mktemp)
           while IFS= read -r f; do
@@ -130,41 +102,11 @@ jobs:
           fi
           rm -f "$tmpfile"
 
-      - name: Validate .po files
-        run: |
-          tmpfile=$(mktemp)
-          find . -name "*.po" \
-            -not -path "./.git/*" \
-            -not -path "./.cpython-src/*" \
-            -not -path "./.pot-templates/*" | while read f; do
-            msgfmt --check "$f" -o /dev/null || echo "FAIL: $f" >> "$tmpfile"
-          done
-          if [ -s "$tmpfile" ]; then
-            cat "$tmpfile"
-            rm -f "$tmpfile"
-            exit 1
-          fi
-          rm -f "$tmpfile"
-
-      - name: Clean up scratch files
-        run: rm -rf .cpython-src .pot-templates
-
       - name: Stage changes
         run: git add --all
 
       - name: Unstage POT-Creation-Date-only changes
-        run: |
-          git diff --staged --name-only | while read f; do
-            if git diff --staged -U0 -- "$f" \
-                | grep '^[+-]' \
-                | grep -v '^[+-][+-][+-]' \
-                | grep -qv 'POT-Creation-Date'; then
-              : # has real changes, keep staged
-            else
-              git restore --staged "$f"
-              git restore "$f"
-            fi
-          done
+        run: python scripts/unstage_cosmetic.py
 
       - name: Commit if changed
         run: |
@@ -174,6 +116,5 @@ jobs:
             echo "Nothing to commit, skipping."
             exit 0
           fi
-          git commit -m \
-            "chore: sync msgids with CPython ${{ github.event.inputs.cpython_tag || 'v3.14.6' }}"
+          git commit -m "chore: sync msgids with CPython $CPYTHON_TAG"
           git push

.readthedocs.yml

@@ -29,7 +29,7 @@ build:
       fi
       echo "Continuing build."
       exit 0
-    - git clone --depth 1 --branch v3.14.6 https://github.com/python/cpython venv/cpython
+    - git clone --depth 1 --branch v3.14.7 https://github.com/python/cpython venv/cpython
     - pip install -r venv/cpython/Doc/requirements.txt
     - mkdir -p venv/cpython/Doc/locales/fa/LC_MESSAGES
     - cp --parents *.po venv/cpython/Doc/locales/fa/LC_MESSAGES/

CONTRIBUTING.md

@@ -10,7 +10,7 @@
    ```bash
    git clone https://github.com/<username>/python-docs-fa.git
    cd python-docs-fa
-   git remote add upstream https://github.com/revisto/python-docs-fa.git
+   git remote add upstream https://github.com/python/python-docs-fa.git
    ```
 2. یک شاخه برای کارتان بسازید (نام شاخه باید گویا باشد، مثلاً `translate-something`):
    ```bash
@@ -45,7 +45,7 @@
 2. فایل `.po` مورد نظر را با [Poedit](https://poedit.net) یا هر ویرایشگر متنی باز کنید.
    - در Poedit رشته‌های ترجمه‌نشده یا `fuzzy` را از پنل فیلتر (Filter) پیدا کنید.
 3. متن `msgid` را ترجمه کنید و در `msgstr` وارد کنید.
-4. **نشانه‌گذاری‌های Sphinx** مثل `` :class:`int` `` ، `` :func:`repr` `` ، `` :ref:`...` `` ، `` ``code`` `` و **جای‌گذارها** مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود. ترجمهٔ `target` در `` :term:`text <target>` `` ممنوع است چون لینک را خراب می‌کند.
+4. **نشانه‌گذاری‌های Sphinx** مثل `` :class:`int` `` ، `` :func:`repr` `` ، `` :ref:`...` `` ، `` ``code`` `` و **جای‌گذارها** مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود. در `` :term:`target` ``، اگر عبارت داخل بک‌تیک با شناسهٔ واژه‌نامه یکی است، می‌توانید آن را به شکل `` :term:`ترجمه <target>` `` بنویسید تا هم متن ترجمه‌شده نمایش داده شود و هم لینک درست کار کند؛ در این حالت فقط بخش نمایشی (پیش از `<`) ترجمه می‌شود و `target` داخل `<>` باید دقیقاً همان شناسهٔ انگلیسی اصلی (بدون تغییر) باقی بماند، چون تغییر آن لینک را خراب می‌کند.
 5. داخل کدها (بلوک‌های `code-block`) نام متغیرها، توابع و کلمات کلیدی را ترجمه نکنید؛ فقط رشته‌ها و کامنت‌ها را می‌توانید ترجمه کنید.
 6. از [واژه‌نامهٔ پروژه (GLOSSARY.md)](GLOSSARY.md) برای ثابت نگه‌داشتن اصطلاحات استفاده کنید.
 7. اگر به اصطلاحی برخوردید که در واژه‌نامه نبود، ترجمه‌ای برای آن انتخاب کنید و به واژه‌نامه اضافه کنید.
@@ -105,7 +105,7 @@ python3 scripts/update_po_headers.py --dry-run
 
 # فقط اصلاح فیلد Language-Team بدون دست‌زدن به اعتبارها
 python3 scripts/update_po_headers.py --no-credits \
-    --language-team "Persian (https://github.com/revisto/python-docs-fa/)" \
+    --language-team "Persian (https://github.com/python/python-docs-fa/)" \
     bugs.po tutorial/
 
 # ادغام نام‌های جدید با فهرست موجود (نام‌های قبلی حذف نمی‌شوند)

README.md

@@ -44,6 +44,6 @@
 
 <!-- STATS_START -->
 ### مشارکت‌های کاربران
-![نمودار مشارکت‌های کاربران؛ Revisto 3984، sepehr-rs 1630، danialbehzadi 677، invincible627 358، khosro_o 63، ParhamF 41، Ariyan_Bolandi 37، nikovinix7878 13، thaghgoo 12، Ramiz_222 10](reports/contributor_stats_latest.png)
-(به‌روزرسانی: 2026-08-21)
+![نمودار مشارکت‌های کاربران؛ Revisto 3984، sepehr-rs 2210، danialbehzadi 677، invincible627 358، khosro_o 63، ParhamF 41، Ariyan_Bolandi 37، nikovinix7878 13، thaghgoo 12، Ramiz_222 10](reports/contributor_stats_latest.png)
+(به‌روزرسانی: 2026-08-27)
 <!-- STATS_END -->