این پروژه گروهی از علاقهمندان به پایتون است که مستندات رسمی پایتون را به فارسی ترجمه میکنند. هدف این است که کاربرانی که تسلط کاملی به زبان انگلیسی ندارند نیز بتوانند با استفاده از راهنماییهای دقیق و بهروز، اصول برنامهنویسی پایتون را بهراحتی یاد بگیرند.
ترجمهها مطابق PEP 545 تحت مجوز CC0 1.0 Universal منتشر میشوند؛ یعنی در مالکیت عمومی (Public Domain) قرار دارند و میتوانید بدون هیچ محدودیتی از آنها استفاده، کپی و بازنشر کنید.
راهنمای کامل مشارکت به پروژه، از جمله نکات نگارشی و تایپوگرافی فارسی، در CONTRIBUTING.md آمده است.
پیش از شروع، حتماً نگاهی به این فایلها بیندازید:
- CONTRIBUTING.md — راهنمای کامل مشارکت: انواع ایشیو، نکات نگارشی و تایپوگرافی فارسی، سطح رسمیت و لحن نوشتار، اندازهٔ پولریکوئست، فرایند بازبینی و تأیید پولریکوئست، همگامسازی با نسخههای جدید پایتون (
scripts/update_python_version.py)، پاکسازی رشتههایfuzzyو نگهداری اعتبار مترجمان در سربرگ فایلهای.po. - GLOSSARY.md — واژهنامهٔ معادلهای فارسی اصطلاحات تخصصی؛ هنگام ترجمه باید به آن پایبند باشید.
- TEAM.md — فهرست هماهنگکنندهها، بازبینها و مترجمان بههمراه آمار مشارکت.
- STATUS.md — جدول وضعیت ترجمهٔ فایلها که بهصورت خودکار بهروزرسانی میشود.
ترجمهها بهازای هر نسخهٔ پایتون در یک شاخهٔ جدا نگهداری میشوند. شاخهٔ فعلی و پیشفرض، نسخهٔ 3.14 است و پولریکوئستها باید روی همین شاخه باز شوند (برای مثال روی فایلهای tutorial/، library/، c-api/ و غیره). هنگام انتشار نسخهٔ جدید پایتون، هماهنگکنندهها شاخهٔ جدیدی ایجاد و ترجمهها را به آن منتقل میکنند.
برای بحث، هماهنگی و بهروزرسانیهای مرتبط با ترجمه، میتوانید از کانالهای زیر استفاده کنید:
- Discord مستندات پایتون به فارسی
- بخش Issues در این مخزن جهت گزارش مشکلات یا پیشنهادات؛ سه قالب موجود است: درخواست ترجمهٔ صفحه، پرسش یا پیشنهاد واژهنامه، و گزارش اشکال در ترجمه.
تمام مشارکتکنندگان موظفاند از آییننامهٔ رفتاری PSF پیروی کنند.
با تشکر از همراهی شما در گسترش و بهبود مستندات پایتون به زبان فارسی!
