WIP: Farsi translation of the Python documentation corpus

.github/ISSUE_TEMPLATE/page_request.md

@@ -1,6 +1,6 @@
 ---
-name: درخواست ترجمهٔ صفحه
-about: درخواست ترجمه یا اولویت‌دادن به ترجمهٔ یک صفحهٔ خاص
+name: درخواست ترجمه‌ی صفحه
+about: درخواست ترجمه یا اولویت‌دادن به ترجمه‌ی یک صفحه‌ی خاص
 title: "[ترجمه] "
 labels: enhancement
 assignees: ''
@@ -16,10 +16,10 @@ assignees: ''
 
 ## اولویت
 
-<!-- آیا این صفحه برای فعال‌سازی فارسی در تغییردهندهٔ زبان (language switcher) لازم است؟ -->
+<!-- آیا این صفحه برای فعال‌سازی فارسی در تغییردهنده‌ی زبان (language switcher) لازم است؟ -->
 
-- [ ] بله، از فایل‌های ضروری است
+- [ ] بله، از پرونده‌های ضروری است
 - [ ] خیر
 
 ## آیین‌نامه رفتاری
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.

.github/ISSUE_TEMPLATE/question.md

@@ -1,6 +1,6 @@
 ---
 name: پرسش یا پیشنهاد واژه‌نامه
-about: سؤال دربارهٔ قواعد ترجمه یا پیشنهاد اصطلاح برای واژه‌نامه
+about: سؤال درباره‌ی قواعد ترجمه یا پیشنهاد اصطلاح برای واژه‌نامه
 title: ""
 labels: question
 assignees: ''
@@ -12,12 +12,12 @@ assignees: ''
 
 ## اصطلاح (در صورت پیشنهاد برای واژه‌نامه)
 
-<!-- انگلیسی و ترجمهٔ فارسی پیشنهادی -->
+<!-- انگلیسی و ترجمه‌ی فارسی پیشنهادی -->
 
 ## منابع
 
-<!-- در صورت وجود، لینک مستندات مرجع یا نمونهٔ استفاده -->
+<!-- در صورت وجود، لینک مستندات مرجع یا نمونه‌ی استفاده -->
 
 ## آیین‌نامه رفتاری
 
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.

.github/ISSUE_TEMPLATE/translation_bug.md

@@ -6,32 +6,32 @@ labels: bug
 assignees: ''
 ---
 
-## صفحه / فایل
+## صفحه / پرونده
 
-<!-- مسیر فایل .po یا لینک صفحهٔ فارسی -->
+<!-- مسیر پرونده .po یا لینک صفحه‌ی فارسی -->
 
 ## متن اصلی (msgid)
 
 ```
 
 ```
 
-## ترجمهٔ فعلی (msgstr)
+## ترجمه‌ی فعلی (msgstr)
 
 ```
 
 ```
 
-## ترجمهٔ پیشنهادی
+## ترجمه‌ی پیشنهادی
 
 ```
 
 ```
 
 ## دلیل / توضیح
 
-<!-- چرا ترجمهٔ فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->
+<!-- چرا ترجمه‌ی فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->
 
 ## آیین‌نامه رفتاری
 
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,9 +2,9 @@
 
 <!-- خلاصهای از ترجمه یا تغییری که انجام دادهاید بنویسید. -->
 
-## فایل‌های تغییر یافته
+## پرونده‌های تغییر یافته
 
-<!-- فایل‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
+<!-- پرونده‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
 - `library/functions.po`
 - `tutorial/controlflow.po`
 -->
@@ -15,11 +15,11 @@
 
 ## چک‌لیست
 <!-- در هر براکتی که انجام شده، یک x قرار دهید.-->
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
-- [ ] `msgfmt --check` روی فایل‌های تغییر یافته با موفقیت اجرا شده است
-- [ ] `python3 scripts/check_markup.py` روی فایل‌های تغییر یافته اجرا شده است
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] `msgfmt --check` روی پرونده‌های تغییر یافته با موفقیت اجرا شده است
+- [ ] `python3 scripts/check_markup.py` روی پرونده‌های تغییر یافته اجرا شده است
 - [ ] نشانه‌گذاری‌های Sphinx (`:class:`، `:func:`، کد درون‌خطی) و جای‌گذارها (`%s`، `{name}`) دست‌نخورده مانده‌اند
 - [ ] ترجمه‌ها با [واژه‌نامه (GLOSSARY.md)](https://github.com/python/python-docs-fa/blob/3.14/GLOSSARY.md) هماهنگ است
 - [ ] رشته‌های `fuzzy` بررسی و در صورت لزوم بازنویسی شده‌اند
-- [ ] فایل [CONTRIBUTING.md](https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md) با دقت خوانده شده است.
+- [ ] پرونده [CONTRIBUTING.md](https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md) با دقت خوانده شده است.
 <!-- یادآوری: بررسی‌های خودکار (sphinx-lint ،msgfmt ،check_markup و ساخت کامل) در GitHub Actions روی پول‌ریکوئست اجرا می‌شوند. -->

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

@@ -50,7 +50,7 @@ jobs:
         uses: sphinx-doc/github-problem-matcher@v1.1
 
       - name: Build documentation
-        run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 --keep-going" html
+        run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -D suppress_warnings=misc.highlighting_failure -D html_theme_options.is_rtl=true --keep-going" html
         working-directory: ./Doc
 
       - name: Setup Pages

.readthedocs.yml

@@ -5,42 +5,20 @@ build:
   tools:
     python: "3.12"
   commands:
-    - |
-      set +e
-      if git rev-parse --verify -q HEAD^ >/dev/null; then
-        CHANGED_FILES=$(git diff --name-only HEAD^ HEAD)
-      else
-        CHANGED_FILES=""
-      fi
-      echo "Changed files: $CHANGED_FILES"
-
-      SKIP=1
-      for f in $CHANGED_FILES; do
-        case "$f" in
-          *.po|*.yaml|*.yml)
-            SKIP=0
-            ;;
-        esac
-      done
-
-      if [ -n "$CHANGED_FILES" ] && [ "$SKIP" -eq 1 ]; then
-        echo "No documentation-relevant files changed, skipping build."
-        exit 183
-      fi
-      echo "Continuing build."
-      exit 0
     - 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/
     - find */ -name "*.po" -not -path "venv/*" | xargs -I{} cp --parents {} venv/cpython/Doc/locales/fa/LC_MESSAGES/
     - find venv/cpython/Doc/locales/fa/LC_MESSAGES -name "*.po" | python3 scripts/compile_mo.py
     - python -m sphinx -T -j auto -b html
+        --color
         -d $READTHEDOCS_OUTPUT/doctrees
         -D language=fa
-        -D locale_dirs=locales
-        -D gettext_compact=0
         -D gettext_allow_fuzzy_translations=1
-        -D html_theme_options.is_rtl=1
+        -D suppress_warnings=misc.highlighting_failure
+        -D gettext_compact=0
+        -D html_theme_options.is_rtl=true
+        --keep-going
         venv/cpython/Doc
-        $READTHEDOCS_OUTPUT/html
+        $READTHEDOCS_OUTPUT/html