ما توی این پروژه گروهی از علاقه‌مندان به پایتون هستیم که روی ترجمه مستندات رسمی پایتون به فارسی می‌کنیم. هدف ما این است که حتی کاربرانی که تسلط کامل به زبان انگلیسی ندارند، بتوانند با استفاده از راهنمایی‌های دقیق و به‌روز، اصول برنامه‌نویسی پایتون را به راحتی یاد بگیرند.

ترجمه‌ها مطابق PEP 545 تحت مجوز CC0 1.0 Universal منتشر می‌شوند؛ یعنی در مالکیت عمومی (Public Domain) قرار دارند و می‌توانید بدون هیچ محدودیتی از آن‌ها استفاده، کپی و بازنشر کنید.

ترجمه‌ها دیگر روی Transifex انجام نمی‌شوند و مستقیماً از طریق پول‌ریکوئست در همین ریپازیتوری مدیریت می‌شوند. فایل‌های .po هر کدام به بخشی از مستندات پایتون (مثل tutorial/، library/ یا c-api/) مربوط‌اند و می‌توانید هرکدام را جداگانه ویرایش و پول‌ریکوئست بزنید.

خلاصه فرایند مشارکت:

1. ریپازیتوری را فورک و کلون کنید.
2. فایل .po مورد نظر رو با Poedit باز کنید (رشته‌های ترجمه‌نشده یا fuzzy را می‌توانید از پنل فیلتر پیدا کنید).
3. متن انگلیسی (msgid) را ترجمه کنید و در بخش ترجمه (msgstr) وارد کنید.
4. نشانه‌گذاری‌های Sphinx مثل :class:`int`، :func:`repr`، code ، و جای‌گزین‌هایی مثل %s یا {name} را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود.
5. پیش از ارسال پول‌ریکوئست، بررسی کنید فایل‌ها مشکلی ندارند:

   msgfmt --check your_file.po
   python3 scripts/check_markup.py your_file.po

6. پول‌ریکوئست را باز کنید — روی هر پول‌ریکوئست به‌صورت خودکار بررسی‌های لازم اجرا می‌شود.

برای دیدن این‌که کدام فایل‌ها هنوز نیاز به ترجمه دارند و چقدر از هرکدام باقی مانده:

python3 scripts/translation_status.py --only-incomplete

قبل از شروع، حتماً نگاهی به این فایل‌ها بیندازید:

• CONTRIBUTING.md — راهنمای کامل مشارکت: فرایند بازبینی و تأیید پول‌ریکوئست، همگام‌سازی با نسخه‌های جدید پایتون (scripts/update_python_version.py)، پاک‌سازی رشته‌های fuzzy و نگهداری اعتبار مترجمان در سربرگ فایل‌های .po.
• GLOSSARY.md — واژه‌نامهٔ معادل‌های فارسی اصطلاحات تخصصی؛ هنگام ترجمه باید به آن پایبند باشیم.
• TEAM.md — فهرست هماهنگ‌کننده‌ها، بازبین‌ها و مترجمان به‌همراه آمار مشارکت.
• STATUS.md — جدول وضعیت ترجمهٔ فایل‌ها که به‌صورت خودکار به‌روزرسانی می‌شود.

ترجمه‌ها به‌ازای هر نسخهٔ پایتون در یک شاخهٔ جدا نگهداری می‌شوند. شاخهٔ فعلی و پیش‌فرض، نسخهٔ 3.14 است و پول‌ریکوئست‌ها باید روی همین شاخه باز شوند (برای مثال روی فایل‌های tutorial/، library/، c-api/ و غیره). هنگام انتشار نسخهٔ جدید پایتون، هماهنگ‌کننده‌ها شاخهٔ جدیدی ایجاد و ترجمه‌ها را به آن منتقل می‌کنند.

برای بحث، هماهنگی و به‌روزرسانی‌های مرتبط با ترجمه، می‌توانید از کانال‌های زیر استفاده کنید:

• Discord مستندات پایتون به فارسی
• بخش Issues در این ریپازیتوری جهت گزارش مشکلات یا پیشنهادات

با تشکر از همراهی شما در گسترش و بهبود مستندات پایتون به زبان فارسی!

(به‌روزرسانی: 2026-08-16)