Translate all of Python documentation files

sepehr-rs · Sep 16, 2026 · Aug 26, 2026 · Aug 27, 2026 · Sep 5, 2026 · Sep 6, 2026
commit 1ed7e5b90d8426719d396e7b8aa30351c14ab414
diff --git a/.github/ISSUE_TEMPLATE/page_request.md b/.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/) پیروی کنم.
diff --git a/.github/ISSUE_TEMPLATE/question.md b/.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/) پیروی کنم.
diff --git a/.github/ISSUE_TEMPLATE/translation_bug.md b/.github/ISSUE_TEMPLATE/translation_bug.md
@@ -8,30 +8,30 @@ assignees: ''
 
 ## صفحه / فایل
 
-<!-- مسیر فایل .po یا لینک صفحهٔ فارسی -->
+<!-- مسیر فایل .po یا لینک صفحه‌ی فارسی -->
 
 ## متن اصلی (msgid)
 
 ```
 
 ```
 
-## ترجمهٔ فعلی (msgstr)
+## ترجمه‌ی فعلی (msgstr)
 
 ```
 
 ```
 
-## ترجمهٔ پیشنهادی
+## ترجمه‌ی پیشنهادی
 
 ```
 
 ```
 
 ## دلیل / توضیح
 
-<!-- چرا ترجمهٔ فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->
+<!-- چرا ترجمه‌ی فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->
 
 ## آیین‌نامه رفتاری
 
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -15,7 +15,7 @@
 
 ## چک‌لیست
 <!-- در هر براکتی که انجام شده، یک x قرار دهید.-->
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
 - [ ] `msgfmt --check` روی فایل‌های تغییر یافته با موفقیت اجرا شده است
 - [ ] `python3 scripts/check_markup.py` روی فایل‌های تغییر یافته اجرا شده است
 - [ ] نشانه‌گذاری‌های Sphinx (`:class:`، `:func:`، کد درون‌خطی) و جای‌گذارها (`%s`، `{name}`) دست‌نخورده مانده‌اند

diff --git a/.github/workflows/build-and-deploy.yml b/.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

diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -36,11 +36,13 @@ build:
     - 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