Skip to content

Commit b857a94

Browse files
sepehr-rssepehr-rs
authored
Update "positional" translation and GLOSSARY (#52)
1 parent b137caf commit b857a94

5 files changed

Lines changed: 104 additions & 126 deletions

File tree

‎GLOSSARY.md‎

Lines changed: 78 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -5,81 +5,81 @@
55
> این واژه‌نامه با الهام از واژه‌نامه پروژهٔ ترجمه مستندات Vue.js به فارسی تهیه شده و از ساختار و توضیحات دقیق اون استفاده شده. با تشکر از مشارکت‌کنندگان این پروژه برای زحماتشون:
66
> https://github.com/vuejs-translations/docs-fa/blob/main/GLOSSARY.md
77
8-
| English | فارسی |
9-
| ------------- | ------------------------ |
10-
| variable | متغیر |
11-
| value | مقدار |
12-
| type | نوع، نوع داده، تایپ |
13-
| string | رشته |
14-
| integer | عدد صحیح |
15-
| boolean | بولی |
16-
| list | فهرست |
17-
| dictionary | دیکشنری |
18-
| function | تابع |
19-
| argument | آرگومان |
20-
| return | بازگشت، برگرداندن |
21-
| expression | عبارت |
22-
| statement | دستور |
23-
| method | متد |
24-
| attribute | ویژگی، صفت، شاخصه |
25-
| property | ویژگی، پراپرتی، خصوصیت |
26-
| class | کلاس |
27-
| object | شیء |
28-
| instance | نمونه |
29-
| loop | حلقه |
30-
| iterable | تکرارپذیر |
31-
| index | اندیس، شماره |
32-
| module | ماژول |
33-
| package | بسته |
34-
| import | ایمپورت |
35-
| built-in | توکار، درونی، درون‌ساخته |
36-
| exception | استثنا |
37-
| debugging | اشکال‌زدایی، دیباگ کردن |
38-
| mock | ماک |
39-
| unit test | یونیت تست |
40-
| syntax | سینتکس، نحو |
41-
| command line | خط فرمان |
42-
| interface | رابط |
43-
| custom | سفارشی، اختصاصی |
44-
| local | محلی |
45-
| global | سراسری |
46-
| load | بارگذاری |
47-
| loader | بارگذار |
48-
| async | ناهمگام، غیرهمگام |
49-
| wrapper | پوششی، دربرگیرنده |
50-
| element | المان، عنصر |
51-
| event | رویداد |
52-
| endpoint | پایانه |
53-
| DOM | DOM |
54-
| component | کامپوننت |
55-
| ecosystem | اکوسیستم |
56-
| accessibility | دسترسی‌پذیری |
57-
| runtime | ران‌تایم |
58-
| dependency | وابستگی |
59-
| community | کامیونیتی |
60-
| namespace | نام‌فضا |
61-
| Tracking | پیگیری |
62-
| method | روش |
63-
| parameter | پارامتر |
64-
| iterator | تکرارگر |
65-
| generator | تولیدگر |
66-
| decorator | دکوراتور، آراینده |
67-
| keyword | کلیدواژه |
68-
| operator | عملگر |
69-
| interpreter | مفسر |
70-
| mutable | تغییرپذیر |
71-
| immutable | تغییرناپذیر |
72-
| callback | کال‌بک، فراخوانی بازگشتی |
73-
| deprecated | منسوخ، از رده خارج شده |
74-
| character | نویسه |
75-
| scope | محدوده |
76-
| keyword argument | آرگومان کلیدواژه‌ای |
77-
| raise | پرتاب |
78-
| list comprehension | درک فهرستی |
79-
| directory | پوشه |
80-
| stack traceback | ردگیری پشته |
81-
| item | آیتم |
82-
| quotation | علامت نقل‌وقول |
83-
| escape | خنثی کردن |
84-
| unpacking | واگشایی |
85-
| shadowing | پوشاندن |
8+
| English | فارسی |
9+
| ---------------- | ------------------------ |
10+
| accessibility | دسترسی‌پذیری |
11+
| argument | آرگومان |
12+
| async | ناهمگام، غیرهمگام |
13+
| attribute | ویژگی، صفت، شاخصه |
14+
| boolean | بولی |
15+
| built-in | توکار، درونی، درون‌ساخته |
16+
| callback | کال‌بک، فراخوانی بازگشتی |
17+
| character | نویسه |
18+
| class | کلاس |
19+
| command line | خط فرمان |
20+
| community | کامیونیتی |
21+
| component | کامپوننت |
22+
| custom | سفارشی، اختصاصی |
23+
| decorator | دکوراتور، آراینده |
24+
| debugging | اشکال‌زدایی، دیباگ کردن |
25+
| deprecated | منسوخ، از رده خارج شده |
26+
| dependency | وابستگی |
27+
| dictionary | دیکشنری |
28+
| directory | پوشه |
29+
| DOM | DOM |
30+
| element | المان، عنصر |
31+
| endpoint | پایانه |
32+
| escape | خنثی کردن |
33+
| ecosystem | اکوسیستم |
34+
| event | رویداد |
35+
| exception | استثنا |
36+
| expression | عبارت |
37+
| function | تابع |
38+
| generator | تولیدگر |
39+
| global | سراسری |
40+
| import | ایمپورت |
41+
| immutable | تغییرناپذیر |
42+
| index | اندیس، شماره |
43+
| instance | نمونه |
44+
| integer | عدد صحیح |
45+
| interface | رابط |
46+
| interpreter | مفسر |
47+
| item | آیتم |
48+
| iterable | تکرارپذیر |
49+
| keyword | کلیدواژه |
50+
| keyword argument | آرگومان کلیدواژه‌ای |
51+
| list | فهرست |
52+
| list comprehension | درک فهرستی |
53+
| load | بارگذاری |
54+
| loader | بارگذار |
55+
| local | محلی |
56+
| loop | حلقه |
57+
| method | متد |
58+
| method | روش |
59+
| mock | ماک |
60+
| module | ماژول |
61+
| mutable | تغییرپذیر |
62+
| namespace | نام‌فضا |
63+
| object | شیء |
64+
| operator | عملگر |
65+
| package | بسته |
66+
| parameter | پارامتر |
67+
| positional | جایگاهی |
68+
| property | ویژگی، پراپرتی، خصوصیت |
69+
| quotation | علامت نقل‌وقول |
70+
| raise | پرتاب |
71+
| return | بازگشت، برگرداندن |
72+
| runtime | ران‌تایم |
73+
| scope | محدوده |
74+
| shadowing | پوشاندن |
75+
| stack traceback | ردگیری پشته |
76+
| statement | دستور |
77+
| string | رشته |
78+
| syntax | سینتکس، نحو |
79+
| Tracking | پیگیری |
80+
| type | نوع، نوع داده، تایپ |
81+
| unit test | یونیت تست |
82+
| unpacking | واگشایی |
83+
| value | مقدار |
84+
| variable | متغیر |
85+
| wrapper | پوششی، دربرگیرنده |

‎README.md‎

Lines changed: 3 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ترجمهٔ مستندات پایتون به فارسی 🐍💛
22

3-
[![discord](https://img.shields.io/badge/Discord-python--docs--fa-5865F2?style=for-the-badge&logo=Discord)](https://discord.gg/yeqtNeaFYf)
3+
[![discord](https://img.shields.io/badge/Telegram-python--docs--fa-00a5e0?style=for-the-badge&logo=telegram)](https://t.me/python_docs_farsi)
44
[![youtube](https://img.shields.io/badge/Youtube-Contribution--Guide-CD201F?style=for-the-badge&logo=Youtube)](https://www.youtube.com/watch?v=DH5c5ZutTCo)
55

66
## دربارهٔ پروژه
@@ -11,30 +11,8 @@
1111

1212
ترجمه‌ها مطابق [PEP 545](https://peps.python.org/pep-0545/) تحت مجوز [CC0 1.0 Universal](LICENSE) منتشر می‌شوند؛ یعنی در مالکیت عمومی (Public Domain) قرار دارند و می‌توانید بدون هیچ محدودیتی از آن‌ها استفاده، کپی و بازنشر کنید.
1313

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) آمده است.
3816

3917
### منابع پیشنهادی
4018

‎library/functions.po‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -376,7 +376,7 @@ msgid "Return a Boolean value, i.e. one of ``True`` or ``False``. The argument
376376
msgstr "یک مقدار بولی، یعنی یکی از ``True`` یا ``False`` را بر می‌گرداند. آرگومان با استفاده از استاندارد :ref:`truth testing procedure <truth>` تبدیل می شود. اگر آرگومان نادرست یا حذف شده باشد، ``False`` را برمی گرداند. در غیر این صورت، ``True`` را برمی گرداند. کلاس :class:`bool` یک زیر کلاس از :class:`int` است (به :ref:`typesnumeric` مراجعه کنید). این کلاس دیگر قابل زیرکلاس‌بندی نیست. تنها نمونه های آن ``False`` و ``True`` هستند (به :ref:`typebool` مراجعه کنید)."
377377

378378
msgid "The parameter is now positional-only."
379-
msgstr "این آرگومان اکنون صرفاً جایگاهی (positional-only) است."
379+
msgstr "این آرگومان اکنون فقط‌جایگاهی (positional-only) است."
380380

381381
msgid "This function drops you into the debugger at the call site. Specifically, it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight through. By default, ``sys.breakpointhook()`` calls :func:`pdb.set_trace` expecting no arguments. In this case, it is purely a convenience function so you don't have to explicitly import :mod:`pdb` or type as much code to enter the debugger. However, :func:`sys.breakpointhook` can be set to some other function and :func:`breakpoint` will automatically call that, allowing you to drop into the debugger of choice. If :func:`sys.breakpointhook` is not accessible, this function will raise :exc:`RuntimeError`."
382382
msgstr "این تابع، اجرای برنامه را در محل فراخوانی متوقف کرده و شما را وارد محیط اشکال‌زدا (debugger) می‌کند. به طور خاص، این تابع، :func:`sys.breakpointhook` را فراخوانی کرده و مقادیر ``args`` و ``kws`` مستقیماً به آن ارسال (pass) می‌کند. به طور پیش‌فرض، تابع ``sys.breakpointhook()`` بدون نیاز به هیچ آرگومانی :func:`pdb.set_trace` را فراخوانی می کند. در این حالت، این صرفاً یک تابع کمکی (convenience function) است تا مجبور نباشید ماژول :mod:`pdb` را به صراحت ایمپورت (import) کنید یا برای ورود به اشکال‌زدا، کد زیادی بنویسید. با این حال، می‌توان :func:`sys.breakpointhook` را روی تابع دیگری تنظیم کرد و در این صورت، :func:`breakpoint` به طور خودکار آن را فراخوانی می کند و به شما این امکان را می دهد که به اشکال‌زدای مورد نظر خود وارد شوید. اگر :func:`sys.breakpointhook` قابل دسترسی نباشد، این تابع، استثنای :exc:`RuntimeError` را پرتاب خواهد کرد."
@@ -914,7 +914,7 @@ msgid "If *base* is not an instance of :class:`int` and the *base* object has a
914914
msgstr "اگر *base* نمونه‌ای از :class:`int` نباشد و شیء *base* متد :meth:`base.__index__ <object.__index__>` را تعریف کرده باشد، آن متد برای به‌دست آوردن یک عدد صحیح به‌عنوان مبنا فراخوانی می‌شود. در نسخه‌های پیشین، به‌جای :meth:`base.__index__ <object.__index__>` از :meth:`base.__int__ <object.__int__>` استفاده می‌شد."
915915

916916
msgid "The first parameter is now positional-only."
917-
msgstr "پارامتر اول اکنون فقط به‌صورت موقعیتی قابل ارسال است."
917+
msgstr "پارامتر اول اکنون فقط به‌صورت فقط‌جایگاهی قابل ارسال است."
918918

919919
msgid "Falls back to :meth:`~object.__index__` if :meth:`~object.__int__` is not defined."
920920
msgstr "اگر :meth:`~object.__int__` تعریف نشده باشد، به :meth:`~object.__index__` بازمی‌گردد."

0 commit comments

Comments
 (0)