این پروژه گروهی از علاقهمندان به پایتون است که مستندات رسمی پایتون را به فارسی ترجمه میکنند. هدف این است که کاربرانی که تسلط کاملی به زبان انگلیسی ندارند نیز بتوانند با استفاده از راهنماییهای دقیق و بهروز، اصول برنامهنویسی پایتون را بهراحتی یاد بگیرند.
ترجمهها مطابق 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 پیروی کنند.
با تشکر از همراهی شما در گسترش و بهبود مستندات پایتون به زبان فارسی!
