Skip to content

Commit ba62f9a

Browse files
github-actions[bot]sepehr-rs
github-actions[bot]
authored and
sepehr-rs
committed
Update workflows and fix translations
1 parent 93d2f32 commit ba62f9a

539 files changed

Lines changed: 36400 additions & 108977 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: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,12 +40,21 @@ jobs:
4040
uses: actions/checkout@v4
4141
with:
4242
path: Doc/locales/fa/LC_MESSAGES
43-
43+
44+
- name: Install gettext
45+
run: sudo apt-get install -y gettext
46+
47+
- name: Compile .po files to .mo
48+
run: |
49+
find Doc/locales/fa/LC_MESSAGES -name "*.po" | while read f; do
50+
msgfmt "$f" -o "${f%.po}.mo"
51+
done
52+
4453
- name: Setup problem matcher
4554
uses: sphinx-doc/github-problem-matcher@v1.1
4655

4756
- name: Build documentation
48-
run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -W --keep-going" html
57+
run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 --keep-going" html
4958
working-directory: ./Doc
5059

5160
- name: Setup Pages

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

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
name: Sync with CPython
2+
3+
on:
4+
schedule:
5+
- cron: '0 4 * * *'
6+
workflow_dispatch:
7+
inputs:
8+
cpython_tag:
9+
description: 'CPython tag to sync against (e.g. v3.14.6)'
10+
required: false
11+
default: 'v3.14.6'
12+
13+
permissions:
14+
contents: write
15+
issues: write
16+
17+
concurrency:
18+
group: sync
19+
cancel-in-progress: false
20+
21+
jobs:
22+
sync:
23+
runs-on: ubuntu-latest
24+
steps:
25+
- name: Checkout translation repo
26+
uses: actions/checkout@v4
27+
with:
28+
fetch-depth: 0
29+
30+
- name: Set up Python
31+
uses: actions/setup-python@v4
32+
with:
33+
python-version: '3.12'
34+
35+
- name: Install gettext
36+
run: sudo apt-get install -y gettext
37+
38+
- name: Install Python dependencies
39+
run: pip install sphinx sphinx-intl
40+
41+
- name: Checkout CPython docs only (sparse)
42+
run: |
43+
git clone \
44+
--depth 1 \
45+
--filter=blob:none \
46+
--sparse \
47+
--branch ${{ github.event.inputs.cpython_tag || 'v3.14.6' }} \
48+
https://github.com/python/cpython.git \
49+
.cpython-src
50+
cd .cpython-src
51+
git sparse-checkout set Doc Include
52+
53+
- name: Install CPython doc dependencies
54+
run: |
55+
python -m venv .cpython-src/Doc/venv
56+
.cpython-src/Doc/venv/bin/pip install \
57+
-r .cpython-src/Doc/requirements.txt
58+
59+
- name: Build .pot templates
60+
run: |
61+
cd .cpython-src/Doc
62+
./venv/bin/sphinx-build \
63+
-b gettext \
64+
. \
65+
../../.pot-templates
66+
67+
- name: Merge .pot into .po files
68+
run: |
69+
find .pot-templates -name "*.pot" | while read f; do
70+
rel="${f#.pot-templates/}"
71+
po="${rel%.pot}.po"
72+
if [ -f "$po" ]; then
73+
msgmerge --update --backup=off --no-location "$po" "$f"
74+
fi
75+
done
76+
77+
- name: Ensure translation label exists
78+
env:
79+
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
80+
run: |
81+
gh label create "translation" \
82+
--color "0075ca" \
83+
--description "Translation review needed" \
84+
--repo ${{ github.repository }} \
85+
2>/dev/null || true
86+
87+
- name: Open issue for fuzzy strings
88+
env:
89+
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
90+
CPYTHON_TAG: ${{ github.event.inputs.cpython_tag || 'v3.14.6' }}
91+
run: |
92+
tmpfile=$(mktemp)
93+
while IFS= read -r f; do
94+
fuzzy=$(msgattrib --only-fuzzy --no-obsolete "$f" 2>/dev/null)
95+
if [ -n "$fuzzy" ]; then
96+
entries=$(echo "$fuzzy" | awk '
97+
/^msgid / {
98+
first=$0; msg=$0"\n"; lines=1; incapture=1; next
99+
}
100+
incapture && /^"/ {
101+
msg = msg $0 "\n"; lines++; next
102+
}
103+
incapture && /^msgstr/ {
104+
incapture=0
105+
if (!(first == "msgid \"\"" && lines==1)) {
106+
printf "- %s\n", msg
107+
}
108+
next
109+
}
110+
')
111+
count=$(echo "$entries" | grep -c '^- ' || echo 0)
112+
if [ "$count" -gt 0 ]; then
113+
echo "### $f ($count fuzzy)" >> "$tmpfile"
114+
echo "$entries" | head -20 >> "$tmpfile"
115+
echo "" >> "$tmpfile"
116+
fi
117+
fi
118+
done < <(find . -name "*.po" \
119+
-not -path "./.git/*" \
120+
-not -path "./.cpython-src/*" \
121+
-not -path "./.pot-templates/*")
122+
if [ -s "$tmpfile" ]; then
123+
gh issue create \
124+
--title "🔍 Fuzzy strings need review after CPython sync ($(date +%Y-%m-%d))" \
125+
--body "$(cat "$tmpfile")
126+
127+
Triggered by sync with \`$CPYTHON_TAG\`." \
128+
--label "translation" \
129+
--repo ${{ github.repository }}
130+
fi
131+
rm -f "$tmpfile"
132+
133+
- name: Validate .po files
134+
run: |
135+
tmpfile=$(mktemp)
136+
find . -name "*.po" \
137+
-not -path "./.git/*" \
138+
-not -path "./.cpython-src/*" \
139+
-not -path "./.pot-templates/*" | while read f; do
140+
msgfmt --check "$f" -o /dev/null || echo "FAIL: $f" >> "$tmpfile"
141+
done
142+
if [ -s "$tmpfile" ]; then
143+
cat "$tmpfile"
144+
rm -f "$tmpfile"
145+
exit 1
146+
fi
147+
rm -f "$tmpfile"
148+
149+
- name: Clean up scratch files
150+
run: rm -rf .cpython-src .pot-templates
151+
152+
- name: Commit if changed
153+
run: |
154+
git config user.name "github-actions[bot]"
155+
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; }
162+
git commit -m \
163+
"chore: sync msgids with CPython ${{ github.event.inputs.cpython_tag || 'v3.14.6' }}"
164+
git push

‎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-15)
65+
(به‌روزرسانی: 2026-08-16)
6666
<!-- STATS_END -->

‎STATUS.md‎

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

55
| File | Translated | Fuzzy |
66
|:-----|:-----------:|:-----------:|

‎about.po‎

Lines changed: 9 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -14,22 +14,19 @@ msgid ""
1414
msgstr ""
1515
"Project-Id-Version: Python 3.14\n"
1616
"Report-Msgid-Bugs-To: \n"
17-
"POT-Creation-Date: 2026-07-25 12:59+0330\n"
17+
"POT-Creation-Date: 2026-08-16 08:01+0000\n"
1818
"PO-Revision-Date: 2021-06-28 00:47+0000\n"
1919
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
20-
"Language-Team: Persian (https://github.com/revisto/python-docs-fa/"
21-
"fa/)\n"
20+
"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n"
2221
"Language: fa\n"
2322
"MIME-Version: 1.0\n"
2423
"Content-Type: text/plain; charset=UTF-8\n"
2524
"Content-Transfer-Encoding: 8bit\n"
2625
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
2726

28-
#: ../../about.rst:3
2927
msgid "About this documentation"
3028
msgstr "دربارهٔ این مستندات"
3129

32-
#: ../../about.rst:6
3330
msgid ""
3431
"Python's documentation is generated from `reStructuredText`_ sources using "
3532
"`Sphinx`_, a documentation generator originally created for Python and now "
@@ -39,61 +36,53 @@ msgstr ""
3936
"تولید می‌شوند، که یک تولیدکننده مستندات است که در ابتدا برای پایتون ساخته شد "
4037
"و اکنون به‌عنوان یک پروژه مستقل نگهداری می‌شود."
4138

42-
#: ../../about.rst:16
4339
msgid ""
4440
"Development of the documentation and its toolchain is an entirely volunteer "
4541
"effort, just like Python itself. If you want to contribute, please take a "
4642
"look at the :ref:`reporting-bugs` page for information on how to do so. New "
4743
"volunteers are always welcome!"
4844
msgstr ""
4945
"توسعهٔ مستندات و زنجیرهٔ ابزارهایش، همانند خود پایتون تلاشی کاملاً داوطلبانه "
50-
"است. اگر می‌خواهید مشارکت کنید برای اطّلاعات در مورد چگونگی آن نگاهی به "
51-
"صفحهٔ :ref:`reporting-bugs` بیندازید. همیشه از داوطلبان جدید استقبال می‌شود!"
46+
"است. اگر می‌خواهید مشارکت کنید برای اطّلاعات در مورد چگونگی آن نگاهی به صفحهٔ :"
47+
"ref:`reporting-bugs` بیندازید. همیشه از داوطلبان جدید استقبال می‌شود!"
5248

53-
#: ../../about.rst:21
5449
msgid "Many thanks go to:"
5550
msgstr "سپاس بسیار از:"
5651

57-
#: ../../about.rst:23
5852
msgid ""
5953
"Fred L. Drake, Jr., the creator of the original Python documentation toolset "
6054
"and author of much of the content;"
6155
msgstr ""
6256
"فرد ال. درک جونیور خالق مجموعه ابزارهای اصلی مستندات پایتون و نویسنده بسیاری "
6357
"از محتواها:"
6458

65-
#: ../../about.rst:25
6659
msgid ""
6760
"the `Docutils <https://docutils.sourceforge.io/>`_ project for creating "
6861
"reStructuredText and the Docutils suite;"
6962
msgstr ""
7063
"پروژه `Docutils <https://docutils.sourceforge.io/>`_ برای ایجاد "
7164
"reStructuredText و مجموعهٔ Docutils؛"
7265

73-
#: ../../about.rst:27
7466
msgid ""
7567
"Fredrik Lundh for his Alternative Python Reference project from which Sphinx "
7668
"got many good ideas."
7769
msgstr ""
78-
"فردریک لوند (Fredrik Lundh) برای پروژه‌ی \"Alternative Python Reference\" "
79-
"(مرجع جایگزین پایتون) که از آن بسیاری از ایده‌های خوب برای Sphinx (اسفینکس) "
80-
"گرفته شد."
70+
"فردریک لوند (Fredrik Lundh) برای پروژه‌ی \"Alternative Python "
71+
"Reference\" (مرجع جایگزین پایتون) که از آن بسیاری از ایده‌های خوب برای Sphinx "
72+
"(اسفینکس) گرفته شد."
8173

82-
#: ../../about.rst:32
8374
msgid "Contributors to the Python documentation"
8475
msgstr "مشارکت کنندگان مستندات پایتون"
8576

86-
#: ../../about.rst:34
8777
msgid ""
8878
"Many people have contributed to the Python language, the Python standard "
8979
"library, and the Python documentation. See :source:`Misc/ACKS` in the "
9080
"Python source distribution for a partial list of contributors."
9181
msgstr ""
9282
"افراد زیادی در توسعه زبان پایتون، کتابخانه استاندارد پایتون، و مستندات "
93-
"پایتون مشارکت داشته‌اند. برای مشاهده فهرستی از برخی از این مشارکت‌کنندگان، "
94-
"به :source:`Misc/ACKS` در توزیع سورس پایتون مراجعه کنید."
83+
"پایتون مشارکت داشته‌اند. برای مشاهده فهرستی از برخی از این مشارکت‌کنندگان، به :"
84+
"source:`Misc/ACKS` در توزیع سورس پایتون مراجعه کنید."
9585

96-
#: ../../about.rst:38
9786
msgid ""
9887
"It is only with the input and contributions of the Python community that "
9988
"Python has such wonderful documentation -- Thank You!"

0 commit comments

Comments
 (0)