Skip to content

Commit 634180f

Browse files
committed
Update README.md
1 parent 51c5c5a commit 634180f

1 file changed

Lines changed: 21 additions & 1 deletion

File tree

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,27 @@
99

1010
## راهنمای مشارکت 🌱
1111

12-
تمام ترجمه‌ها بر روی [Transifex](https://explore.transifex.com/python-doc/python-newest/) انجام می‌شود. فرآیند ترجمه شامل بازبینی و اصلاح متونی است که به صورت خودکار توسط ابزارهای ترجمه ماشینی ترجمه شده‌اند.
12+
ترجمه‌ها دیگر روی Transifex انجام نمی‌شوند و مستقیماً از طریق پول‌ریکوئست در همین ریپازیتوری مدیریت می‌شوند. فایل‌های `.po` هر کدام به بخشی از مستندات پایتون (مثل `tutorial/`، `library/` یا `c-api/`) مربوط‌اند و می‌توانید هرکدام را جداگانه ویرایش و پول‌ریکوئست بزنید.
13+
14+
خلاصه فرایند مشارکت:
15+
16+
1. ریپازیتوری را فورک و کلون کنید.
17+
2. فایل `.po` مورد نظر را با [Poedit](https://poedit.net/) باز کنید (رشته‌های ترجمه‌نشده یا fuzzy را می‌توانید از پنل فیلتر پیدا کنید).
18+
3. متن انگلیسی (`msgid`) را ترجمه کنید و در بخش ترجمه (`msgstr`) وارد کنید.
19+
4. نشانه‌گذاری‌های Sphinx مثل `` :class:`int` ``، `` :func:`repr` ``، `` ``code`` ``، و جای‌گزین‌هایی مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود.
20+
5. پیش از ارسال پول‌ریکوئست، بررسی کنید فایل‌ها مشکلی ندارند:
21+
```bash
22+
msgfmt --check your_file.po
23+
python3 scripts/check_markup.py your_file.po
24+
```
25+
6. پول‌ریکوئست را باز کنید — روی هر پول‌ریکوئست به‌صورت خودکار بررسی‌های لازم اجرا می‌شود.
26+
27+
برای دیدن این‌که کدام فایل‌ها هنوز نیاز به ترجمه دارند و چقدر از هرکدام باقی مانده:
28+
```bash
29+
python3 scripts/translation_status.py --only-incomplete
30+
```
31+
32+
راهنمای کامل‌تر مشارکت (شامل نحوه‌ی همگام‌سازی با نسخه‌های جدید پایتون و اسکریپت‌های موجود در `scripts/`) در [RESOURCE.md](RESOURCE.md) موجود است.
1333

1434
## ارتباط و هماهنگی
1535

0 commit comments

Comments
 (0)