|
1 | 1 | # ترجمهٔ مستندات پایتون به فارسی 🐍💛 |
2 | 2 |
|
3 | | -[](https://discord.gg/yeqtNeaFYf) |
| 3 | +[](https://t.me/python_docs_farsi) |
4 | 4 | [](https://www.youtube.com/watch?v=DH5c5ZutTCo) |
5 | 5 |
|
6 | 6 | ## دربارهٔ پروژه |
|
11 | 11 |
|
12 | 12 | ترجمهها مطابق [PEP 545](https://peps.python.org/pep-0545/) تحت مجوز [CC0 1.0 Universal](LICENSE) منتشر میشوند؛ یعنی در مالکیت عمومی (Public Domain) قرار دارند و میتوانید بدون هیچ محدودیتی از آنها استفاده، کپی و بازنشر کنید. |
13 | 13 |
|
14 | | -## راهنمای مشارکت 🌱 |
15 | | - |
16 | | -ترجمهها دیگر روی Transifex انجام نمیشوند و مستقیماً از طریق پولریکوئست در همین مخزن (Repository) مدیریت میشوند. فایلهای `.po` هر کدام به بخشی از مستندات پایتون (مثل `tutorial/`، `library/` یا `c-api/`) مربوطاند و میتوانید هرکدام را جداگانه ویرایش و پولریکوئست بزنید. |
17 | | - |
18 | | -خلاصهٔ فرایند مشارکت: |
19 | | - |
20 | | -1. مخزن را فورک و کلون کنید. |
21 | | -2. اگر ایشیوی مربوط به فایل مورد نظرتان باز نشده، یک ایشیوی «درخواست ترجمهٔ صفحه» باز کنید تا دیگران بدانند آن فایل در حال انجام است. |
22 | | -3. فایل `.po` مورد نظر را با [Poedit](https://poedit.net/) باز کنید (رشتههای ترجمهنشده یا `fuzzy` را میتوانید از پنل فیلتر پیدا کنید). |
23 | | -4. متن انگلیسی (`msgid`) را ترجمه کنید و در بخش ترجمه (`msgstr`) وارد کنید. ترجمه باید در سطح رسمی و با خطاب «شما» نوشته شود. |
24 | | -5. نشانهگذاریهای Sphinx مثل `` :class:`int` ``، `` :func:`repr` ``، `` ``code`` ``، و جایگزینهایی مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آنها ترجمه میشود. |
25 | | -6. پیش از ارسال پولریکوئست، بررسی کنید فایلها مشکلی ندارند: |
26 | | - ```bash |
27 | | - msgfmt --check your_file.po |
28 | | - python3 scripts/check_markup.py your_file.po |
29 | | - ``` |
30 | | -7. پولریکوئست را باز کنید (حداکثر تا ۴ فایل `.po` در هر پولریکوئست) — روی هر پولریکوئست بهصورت خودکار بررسیهای لازم اجرا میشود و ریدتردکس (Read the Docs) نسخهٔ پیشنمایش مستندات را میسازد. اگر بررسیها رد شدند، از تب Actions در گیتهاب ببینید کدام مورد مشکل داشته و همان اسکریپت را بهصورت محلی اجرا کنید. |
31 | | - |
32 | | -برای دیدن اینکه کدام فایلها هنوز نیاز به ترجمه دارند و چقدر از هرکدام باقی مانده: |
33 | | -```bash |
34 | | -python3 scripts/translation_status.py --only-incomplete |
35 | | -``` |
36 | | - |
37 | | -راهنمای کاملتر این مراحل، از جمله نکات نگارشی و تایپوگرافی فارسی، در [CONTRIBUTING.md](CONTRIBUTING.md) آمده است. |
| 14 | +## راهنمای مشارکت |
| 15 | +راهنمای کامل مشارکت به پروژه، از جمله نکات نگارشی و تایپوگرافی فارسی، در [CONTRIBUTING.md](CONTRIBUTING.md) آمده است. |
38 | 16 |
|
39 | 17 | ### منابع پیشنهادی |
40 | 18 |
|
|
0 commit comments