Skip to content

Commit 89f82c3

Browse files
invincible627invincible627
authored
Merge branch 'python:3.14' into Translation_of_part_of_library_files
2 parents 0915fa5 + 41007b3 commit 89f82c3

542 files changed

Lines changed: 39254 additions & 168318 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

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

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,12 +41,15 @@ jobs:
4141
with:
4242
path: Doc/locales/fa/LC_MESSAGES
4343

44+
- name: Strip stray fuzzy markers
45+
run: python3 Doc/locales/fa/LC_MESSAGES/scripts/strip_fuzzy.py $(find Doc/locales/fa/LC_MESSAGES -name "*.po" -not -path "*/.git/*")
46+
4447
- name: Install gettext
4548
run: sudo apt-get install -y gettext
4649

4750
- name: Compile .po files to .mo
4851
run: |
49-
find Doc/locales/fa/LC_MESSAGES -name "*.po" | while read f; do
52+
find Doc/locales/fa/LC_MESSAGES -name "*.po" -not -path "*/.git/*" | while read f; do
5053
msgfmt "$f" -o "${f%.po}.mo"
5154
done
5255
@@ -74,4 +77,4 @@ jobs:
7477
steps:
7578
- name: Deploy to GitHub Pages
7679
id: deployment
77-
uses: actions/deploy-pages@v4
80+
uses: actions/deploy-pages@v4

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

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ jobs:
7070
rel="${f#.pot-templates/}"
7171
po="${rel%.pot}.po"
7272
if [ -f "$po" ]; then
73-
msgmerge --update --backup=off --no-location "$po" "$f"
73+
msgmerge --update --backup=off --no-location --no-wrap "$po" "$f"
7474
fi
7575
done
7676
@@ -149,16 +149,31 @@ jobs:
149149
- name: Clean up scratch files
150150
run: rm -rf .cpython-src .pot-templates
151151

152+
- name: Stage changes
153+
run: git add --all
154+
155+
- name: Unstage POT-Creation-Date-only changes
156+
run: |
157+
git diff --staged --name-only | while read f; do
158+
if git diff --staged -U0 -- "$f" \
159+
| grep '^[+-]' \
160+
| grep -v '^[+-][+-][+-]' \
161+
| grep -qv 'POT-Creation-Date'; then
162+
: # has real changes, keep staged
163+
else
164+
git restore --staged "$f"
165+
git restore "$f"
166+
fi
167+
done
168+
152169
- name: Commit if changed
153170
run: |
154171
git config user.name "github-actions[bot]"
155172
git config user.email "github-actions[bot]@users.noreply.github.com"
156-
git add --all
157-
git diff --staged -U0 \
158-
| grep '^[+-]' \
159-
| grep -v '^[+-][+-][+-]' \
160-
| grep -qv 'POT-Creation-Date' \
161-
|| { echo "Only POT-Creation-Date changed, skipping commit."; exit 0; }
173+
if git diff --staged --quiet; then
174+
echo "Nothing to commit, skipping."
175+
exit 0
176+
fi
162177
git commit -m \
163178
"chore: sync msgids with CPython ${{ github.event.inputs.cpython_tag || 'v3.14.6' }}"
164179
git push

‎.readthedocs.yml‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
version: 2
2+
3+
build:
4+
os: ubuntu-24.04
5+
tools:
6+
python: "3.12"
7+
8+
commands:
9+
- git clone --depth 1 --branch v3.14.6 https://github.com/python/cpython venv/cpython
10+
- pip install -r venv/cpython/Doc/requirements.txt
11+
- mkdir -p venv/cpython/Doc/locales/fa/LC_MESSAGES
12+
- cp --parents *.po venv/cpython/Doc/locales/fa/LC_MESSAGES/
13+
- find */ -name "*.po" -not -path "venv/*" | xargs -I{} cp --parents {} venv/cpython/Doc/locales/fa/LC_MESSAGES/
14+
- find venv/cpython/Doc/locales/fa/LC_MESSAGES -name "*.po" | xargs python3 scripts/strip_fuzzy.py
15+
- find venv/cpython/Doc/locales/fa/LC_MESSAGES -name "*.po" | while read f; do python venv/cpython/Tools/i18n/msgfmt.py -o "${f%.po}.mo" "$f"; done
16+
- python -m sphinx -T -j auto -b html
17+
-d $READTHEDOCS_OUTPUT/doctrees
18+
-D language=fa
19+
-D locale_dirs=locales
20+
-D gettext_compact=0
21+
-D gettext_allow_fuzzy_translations=1
22+
-D html_theme_options.is_rtl=1
23+
venv/cpython/Doc
24+
$READTHEDOCS_OUTPUT/html

‎Makefile‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121

2222
CPYTHON_CURRENT_COMMIT := d26c2fe7a2833606b3fb8d9789149d8696978d86
2323
LANGUAGE := fa
24-
BRANCH := 3.13
24+
BRANCH := 3.14
2525

2626
EXCLUDED := \
2727
whatsnew/2.?.po \

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,5 +62,5 @@ python3 scripts/translation_status.py --only-incomplete
6262
<!-- STATS_START -->
6363
### مشارکت‌های کاربران
6464
![نمودار مشارکت‌های کاربران؛ 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)
65-
(به‌روزرسانی: 2026-08-16)
65+
(به‌روزرسانی: 2026-08-18)
6666
<!-- STATS_END -->

‎STATUS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<!-- TRANSLATION_STATUS_START -->
22
### وضعیت ترجمه فایل‌ها
3-
(به‌روزرسانی: 2026-08-16)
3+
(به‌روزرسانی: 2026-08-18)
44

55
| File | Translated | Fuzzy |
66
|:-----|:-----------:|:-----------:|
@@ -34,7 +34,7 @@
3434
| tutorial/stdlib2.po | 100.0% | 0.0% |
3535
| tutorial/venv.po | 100.0% | 0.0% |
3636
| tutorial/whatnow.po | 100.0% | 0.0% |
37-
| c-api/dict.po | 1.8% | 0.9% |
37+
| c-api/dict.po | 2.8% | 0.0% |
3838
| library/json.po | 1.1% | 0.0% |
3939
| c-api/arg.po | 0.0% | 0.0% |
4040
| c-api/buffer.po | 0.0% | 0.0% |

‎about.po‎

Lines changed: 15 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ msgid ""
1414
msgstr ""
1515
"Project-Id-Version: Python 3.14\n"
1616
"Report-Msgid-Bugs-To: \n"
17-
"POT-Creation-Date: 2026-08-16 08:01+0000\n"
17+
"POT-Creation-Date: 2026-08-18 04:30+0000\n"
1818
"PO-Revision-Date: 2021-06-28 00:47+0000\n"
1919
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
2020
"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n"
@@ -27,65 +27,29 @@ msgstr ""
2727
msgid "About this documentation"
2828
msgstr "دربارهٔ این مستندات"
2929

30-
msgid ""
31-
"Python's documentation is generated from `reStructuredText`_ sources using "
32-
"`Sphinx`_, a documentation generator originally created for Python and now "
33-
"maintained as an independent project."
34-
msgstr ""
35-
"مستندات پایتون از طریق منابع `reStructuredText`_ با استفاده از `Sphinx`_ "
36-
"تولید می‌شوند، که یک تولیدگر مستندات است که در ابتدا برای پایتون ساخته شد "
37-
"و اکنون به‌عنوان یک پروژه مستقل نگهداری می‌شود."
30+
msgid "Python's documentation is generated from `reStructuredText`_ sources using `Sphinx`_, a documentation generator originally created for Python and now maintained as an independent project."
31+
msgstr "مستندات پایتون از طریق منابع `reStructuredText`_ با استفاده از `Sphinx`_ تولید می‌شوند، که یک تولیدگر مستندات است که در ابتدا برای پایتون ساخته شد و اکنون به‌عنوان یک پروژه مستقل نگهداری می‌شود."
3832

39-
msgid ""
40-
"Development of the documentation and its toolchain is an entirely volunteer "
41-
"effort, just like Python itself. If you want to contribute, please take a "
42-
"look at the :ref:`reporting-bugs` page for information on how to do so. New "
43-
"volunteers are always welcome!"
44-
msgstr ""
45-
"توسعهٔ مستندات و زنجیرهٔ ابزارهایش، همانند خود پایتون تلاشی کاملاً داوطلبانه "
46-
"است. اگر می‌خواهید مشارکت کنید برای اطّلاعات در مورد چگونگی آن نگاهی به صفحهٔ :"
47-
"ref:`reporting-bugs` بیندازید. همیشه از داوطلبان جدید استقبال می‌شود!"
33+
msgid "Development of the documentation and its toolchain is an entirely volunteer effort, just like Python itself. If you want to contribute, please take a look at the :ref:`reporting-bugs` page for information on how to do so. New volunteers are always welcome!"
34+
msgstr "توسعهٔ مستندات و زنجیرهٔ ابزارهایش، همانند خود پایتون تلاشی کاملاً داوطلبانه است. اگر می‌خواهید مشارکت کنید برای اطّلاعات در مورد چگونگی آن نگاهی به صفحهٔ :ref:`reporting-bugs` بیندازید. همیشه از داوطلبان جدید استقبال می‌شود!"
4835

4936
msgid "Many thanks go to:"
5037
msgstr "سپاس بسیار از:"
5138

52-
msgid ""
53-
"Fred L. Drake, Jr., the creator of the original Python documentation toolset "
54-
"and author of much of the content;"
55-
msgstr ""
56-
"فرد ال. درک جونیور خالق مجموعه ابزارهای اصلی مستندات پایتون و نویسنده بسیاری "
57-
"از محتواها:"
39+
msgid "Fred L. Drake, Jr., the creator of the original Python documentation toolset and author of much of the content;"
40+
msgstr "فرد ال. درک جونیور خالق مجموعه ابزارهای اصلی مستندات پایتون و نویسنده بسیاری از محتواها:"
5841

59-
msgid ""
60-
"the `Docutils <https://docutils.sourceforge.io/>`_ project for creating "
61-
"reStructuredText and the Docutils suite;"
62-
msgstr ""
63-
"پروژه `Docutils <https://docutils.sourceforge.io/>`_ برای ایجاد "
64-
"reStructuredText و مجموعهٔ Docutils؛"
42+
msgid "the `Docutils <https://docutils.sourceforge.io/>`_ project for creating reStructuredText and the Docutils suite;"
43+
msgstr "پروژه `Docutils <https://docutils.sourceforge.io/>`_ برای ایجاد reStructuredText و مجموعهٔ Docutils؛"
6544

66-
msgid ""
67-
"Fredrik Lundh for his Alternative Python Reference project from which Sphinx "
68-
"got many good ideas."
69-
msgstr ""
70-
"فردریک لوند (Fredrik Lundh) برای پروژه‌ی \"Alternative Python "
71-
"Reference\" (مرجع جایگزین پایتون) که از آن بسیاری از ایده‌های خوب برای Sphinx "
72-
"(اسفینکس) گرفته شد."
45+
msgid "Fredrik Lundh for his Alternative Python Reference project from which Sphinx got many good ideas."
46+
msgstr "فردریک لوند (Fredrik Lundh) برای پروژه‌ی \"Alternative Python Reference\" (مرجع جایگزین پایتون) که از آن بسیاری از ایده‌های خوب برای Sphinx (اسفینکس) گرفته شد."
7347

7448
msgid "Contributors to the Python documentation"
7549
msgstr "مشارکت کنندگان مستندات پایتون"
7650

77-
msgid ""
78-
"Many people have contributed to the Python language, the Python standard "
79-
"library, and the Python documentation. See :source:`Misc/ACKS` in the "
80-
"Python source distribution for a partial list of contributors."
81-
msgstr ""
82-
"افراد زیادی در توسعه زبان پایتون، کتابخانه استاندارد پایتون، و مستندات "
83-
"پایتون مشارکت داشته‌اند. برای مشاهده فهرستی از برخی از این مشارکت‌کنندگان، به :"
84-
"source:`Misc/ACKS` در توزیع سورس پایتون مراجعه کنید."
51+
msgid "Many people have contributed to the Python language, the Python standard library, and the Python documentation. See :source:`Misc/ACKS` in the Python source distribution for a partial list of contributors."
52+
msgstr "افراد زیادی در توسعه زبان پایتون، کتابخانه استاندارد پایتون، و مستندات پایتون مشارکت داشته‌اند. برای مشاهده فهرستی از برخی از این مشارکت‌کنندگان، به :source:`Misc/ACKS` در توزیع سورس پایتون مراجعه کنید."
8553

86-
msgid ""
87-
"It is only with the input and contributions of the Python community that "
88-
"Python has such wonderful documentation -- Thank You!"
89-
msgstr ""
90-
"فقط با مشارکت‌ها و کمک‌های جامعه پایتون است که پایتون چنین مستندات فوق‌العاده‌ای "
91-
"دارد -- سپاس از شما!"
54+
msgid "It is only with the input and contributions of the Python community that Python has such wonderful documentation -- Thank You!"
55+
msgstr "فقط با مشارکت‌ها و کمک‌های جامعه پایتون است که پایتون چنین مستندات فوق‌العاده‌ای دارد -- سپاس از شما!"

0 commit comments

Comments
 (0)