Skip to content

Commit cf56314

Browse files
authored
Fix some RTL issues in CONTRIBUTING.md
1 parent 507fd96 commit cf56314

1 file changed

Lines changed: 5 additions & 16 deletions

File tree

CONTRIBUTING.md

Lines changed: 5 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -49,18 +49,12 @@
4949
## فرایند ترجمه
5050

5151
1. پرونده‌ای را انتخاب کنید و بررسی کنید آیا [ایشوی](https://github.com/python/python-docs-fa/issues) مربوط به آن باز شده است یا نه (قالب «درخواست ترجمه‌ی صفحه»). اگر باز شده و ترجمه‌ی کامل آن در حال انجام است، پرونده‌ی دیگری را انتخاب کنید؛ در غیر این صورت یک ایشو باز کرده و شروع به کار کنید.
52-
5352
2. پرونده‌ی `.po` مورد نظر را با [Poedit](https://poedit.net) یا هر ویرایشگر متنی باز کنید.
5453
- در Poedit رشته‌های ترجمه‌نشده یا `fuzzy` را از پنل فیلتر (Filter) پیدا کنید.
55-
5654
3. متن `msgid` را ترجمه کنید و در `msgstr` وارد کنید.
57-
5855
4. برای پیدا کردن ترجمه‌ی مناسب برای کلمات و عبارات تخصصی، از [این پیوند](http://python.github.io/python-docs-fa/glossary-searcher) به واژه‌یاب پایتون رفته و واژه/عبارت موردنظر خود را جست‌جو کنید.
59-
6056
5. **نشانه‌گذاری‌های Sphinx** مثل `` :class:`int` ``، `` :func:`repr` ``، `` :ref:`...` ``، `` ``code`` `` و **جای‌گذارها** مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود. در `` :term:`target` ``، اگر عبارت داخل بک‌تیک با شناسه‌ی واژه‌نامه یکی است، می‌توانید آن را به شکل `` :term:`ترجمه <target>` `` بنویسید تا هم متن ترجمه‌شده نمایش داده شود و هم لینک درست کار کند؛ در این حالت فقط بخش نمایشی (پیش از `<`) ترجمه می‌شود و `target` داخل `<>` باید دقیقاً همان شناسه‌ی انگلیسی اصلی (بدون تغییر) باقی بماند، چون تغییر آن لینک را خراب می‌کند.
61-
6257
6. داخل کدها (بلوک‌های `code-block`) نام متغیرها، توابع، کلمات کلیدی و **کامنت‌ها** ترجمه نمی‌شوند؛ چون کد از راست به چپ نوشته نمی‌شود و وجود متن فارسی داخل آن، کد را ناخوانا می‌کند. فقط رشته‌های متنی (string) قابل‌ترجمه‌اند.
63-
6458
7. اگر به اصطلاحی برخوردید که در واژه‌نامه نبود و فکر میکنید که باید در واژه‌نامه باشد، به بخش «افزودن واژه یا اصطلاح جدید به واژه‌نامه» همین پرونده بروید.
6559

6660
### بررسی‌ها قبل از ارسال پول‌ریکوئست
@@ -82,11 +76,8 @@ python3 scripts/check_markup.py your_file.po
8276
برای یکدست ماندن ترجمه‌ها، این نکات نگارشی را رعایت کنید:
8377

8478
- **«هٔ» در برابر «ه‌ی»:** از ترکیب «هٔ» (ه همزه‌دار/ سریا) استفاده نکنید؛ به‌جای آن از «ه‌ی» (با نیم‌فاصله) استفاده کنید. مثال درست: «برنامه‌ی پایتون». مثال نادرست: «برنامهٔ پایتون».
85-
8679
- **نیم‌فاصله (ZWNJ):** در جاهایی که نیم‌فاصله لازم است (مثل «می‌شود»، «می‌کنید»، جمع با «ها» نظیر «پرونده‌ها»، یا پیشوندهایی مثل «بی‌» و «نا‌») از کاراکتر نیم‌فاصله‌ی واقعی (U+200C) استفاده کنید، نه فاصله‌ی معمولی یا بدون فاصله. مثال درست: «پرونده‌های ترجمه‌نشده». مثال نادرست: «پرونده های ترجمه نشده» یا «فایلهای ترجمه‌نشده».
87-
8880
- **اعداد فارسی در برابر اعداد لاتین:** در متن روایی فارسی از ارقام فارسی (۰۱۲۳۴۵۶۷۸۹) استفاده کنید (مثلاً «در نسخه‌ی ۳ پایتون»). اما داخل کد، شماره‌ی نسخه‌ی پایتون، مسیر پرونده‌ها، لینک‌ها و هر جایی که عدد بخشی از یک شناسه‌ی فنی است (مثل `v3.14.6`)، همیشه از ارقام لاتین استفاده کنید و آن‌ها را تغییر ندهید.
89-
9081
- **علائم نگارشی فارسی در برابر انگلیسی:** در متن فارسی از علائم فارسی استفاده کنید: «،» به‌جای «,» و «؟» به‌جای «?». علائمی که داخل کد، نشانه‌گذاری‌های Sphinx، یا جای‌گذارها هستند دست‌نخورده باقی می‌مانند (چون بخشی از متن انگلیسی اصلی محسوب نمی‌شوند و نباید تغییر کنند).
9182

9283
## سطح رسمیت و لحن نوشتار
@@ -175,8 +166,6 @@ python3 scripts/update_python_version.py v3.15.0 --keep-src
175166
- محل دقیق ترجمه‌ی مشکل‌دار (مسیر پرونده یا لینک صفحه)
176167
- در صورت نیاز، تصویری از ترجمه
177168
- در صورت دسترسی، متن msgid و msgstr مربوطه
178-
179-
180169
## پیشنهاد تغییر در واژه یا شیوه‌ی نگارش
181170

182171
اگر می‌خواهید تغییری در ترجمه‌ی یک واژه‌ی موجود در واژه‌نامه یا در یکی از شیوه‌های نگارشی رایج پروژه پیشنهاد دهید، این فرایند را دنبال کنید:
@@ -186,16 +175,16 @@ python3 scripts/update_python_version.py v3.15.0 --keep-src
186175
3. نظرسنجی به مدت **دو هفته** باز می‌ماند. در پایان این بازه، نتیجه‌ی نظرسنجی به‌عنوان نظر جامعه‌ی مشارکت‌کنندگان درباره‌ی پیشنهاد در نظر گرفته می‌شود و نگهدارندگان پروژه بر اساس آن، و با توجه به قوانین و استانداردهای فنی و نگارشی پروژه، درباره‌ی اجرای پیشنهاد تصمیم می‌گیرند.
187176
4. نگهدارندگان پروژه تنها در صورتی می‌توانند اجرای نتیجه‌ی نظرسنجی را به تعویق بیندازند یا از اجرای آن خودداری کنند که نتیجه با یکی از موارد زیر تعارض داشته باشد:
188177

189-
* معنای فنی یا مفهومی متن اصلی؛
190-
* الزامات فنی مستندات یا نشانه‌گذاری‌های Sphinx؛
191-
* قوانین و شیوه‌نامه‌های مصوب پروژه؛
192-
* یا صحت و یکپارچگی فنی مستندات.
178+
- معنای فنی یا مفهومی متن اصلی؛
179+
- الزامات فنی مستندات یا نشانه‌گذاری‌های Sphinx؛
180+
- قوانین و شیوه‌نامه‌های مصوب پروژه؛
181+
- یا صحت و یکپارچگی فنی مستندات.
193182

194183
در چنین مواردی، دلیل تصمیم باید به‌صورت عمومی در همان ایشو توضیح داده شود و در صورت امکان، پیشنهاد برای بررسی دوباره یا اصلاح به جامعه بازگردانده شود.
184+
195185
5. اگر پیشنهاد تغییر رأی موافق کسب نکند، همان پیشنهاد را می‌توان پس از گذشت **چهار هفته** دوباره به رأی گذاشت؛ مشروط بر اینکه در این فاصله دلیل یا شواهد جدیدی برای بازنگری در آن ارائه شده باشد.
196186
6. اگر پیشنهاد تغییر پذیرفته شود، به یک ایشوی اصلی (master issue) که فهرست کارها و تغییرات قابل‌انجام را پیگیری می‌کند اضافه خواهد شد تا هر مشارکت‌کننده‌ای که مایل باشد بتواند اجرای آن را بر عهده بگیرد.
197187

198-
199188
## افزودن واژه یا اصطلاح جدید به واژه‌نامه
200189

201190
اگر واژه یا اصطلاحی در واژه‌نامه‌ی پروژه وجود ندارد و می‌خواهید معادل پیشنهادی برای آن اضافه شود، یک ایشو با قالب **«پیشنهاد تغییرات در ترجمه»** باز کنید و واژه‌ی انگلیسی، معادل پیشنهادی، و دلیل انتخاب آن را توضیح دهید.

0 commit comments

Comments
 (0)