Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
156 changes: 78 additions & 78 deletions GLOSSARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,81 +5,81 @@
> این واژه‌نامه با الهام از واژه‌نامه پروژهٔ ترجمه مستندات Vue.js به فارسی تهیه شده و از ساختار و توضیحات دقیق اون استفاده شده. با تشکر از مشارکت‌کنندگان این پروژه برای زحماتشون:
> https://github.com/vuejs-translations/docs-fa/blob/main/GLOSSARY.md

| English | فارسی |
| ------------- | ------------------------ |
| variable | متغیر |
| value | مقدار |
| type | نوع، نوع داده، تایپ |
| string | رشته |
| integer | عدد صحیح |
| boolean | بولی |
| list | فهرست |
| dictionary | دیکشنری |
| function | تابع |
| argument | آرگومان |
| return | بازگشت، برگرداندن |
| expression | عبارت |
| statement | دستور |
| method | متد |
| attribute | ویژگی، صفت، شاخصه |
| property | ویژگی، پراپرتی، خصوصیت |
| class | کلاس |
| object | شیء |
| instance | نمونه |
| loop | حلقه |
| iterable | تکرارپذیر |
| index | اندیس، شماره |
| module | ماژول |
| package | بسته |
| import | ایمپورت |
| built-in | توکار، درونی، درون‌ساخته |
| exception | استثنا |
| debugging | اشکال‌زدایی، دیباگ کردن |
| mock | ماک |
| unit test | یونیت تست |
| syntax | سینتکس، نحو |
| command line | خط فرمان |
| interface | رابط |
| custom | سفارشی، اختصاصی |
| local | محلی |
| global | سراسری |
| load | بارگذاری |
| loader | بارگذار |
| async | ناهمگام، غیرهمگام |
| wrapper | پوششی، دربرگیرنده |
| element | المان، عنصر |
| event | رویداد |
| endpoint | پایانه |
| DOM | DOM |
| component | کامپوننت |
| ecosystem | اکوسیستم |
| accessibility | دسترسی‌پذیری |
| runtime | ران‌تایم |
| dependency | وابستگی |
| community | کامیونیتی |
| namespace | نام‌فضا |
| Tracking | پیگیری |
| method | روش |
| parameter | پارامتر |
| iterator | تکرارگر |
| generator | تولیدگر |
| decorator | دکوراتور، آراینده |
| keyword | کلیدواژه |
| operator | عملگر |
| interpreter | مفسر |
| mutable | تغییرپذیر |
| immutable | تغییرناپذیر |
| callback | کال‌بک، فراخوانی بازگشتی |
| deprecated | منسوخ، از رده خارج شده |
| character | نویسه |
| scope | محدوده |
| keyword argument | آرگومان کلیدواژه‌ای |
| raise | پرتاب |
| list comprehension | درک فهرستی |
| directory | پوشه |
| stack traceback | ردگیری پشته |
| item | آیتم |
| quotation | علامت نقل‌وقول |
| escape | خنثی کردن |
| unpacking | واگشایی |
| shadowing | پوشاندن |
| English | فارسی |
| ---------------- | ------------------------ |
| accessibility | دسترسی‌پذیری |
| argument | آرگومان |
| async | ناهمگام، غیرهمگام |
| attribute | ویژگی، صفت، شاخصه |
| boolean | بولی |
| built-in | توکار، درونی، درون‌ساخته |
| callback | کال‌بک، فراخوانی بازگشتی |
| character | نویسه |
| class | کلاس |
| command line | خط فرمان |
| community | کامیونیتی |
| component | کامپوننت |
| custom | سفارشی، اختصاصی |
| decorator | دکوراتور، آراینده |
| debugging | اشکال‌زدایی، دیباگ کردن |
| deprecated | منسوخ، از رده خارج شده |
| dependency | وابستگی |
| dictionary | دیکشنری |
| directory | پوشه |
| DOM | DOM |
| element | المان، عنصر |
| endpoint | پایانه |
| escape | خنثی کردن |
| ecosystem | اکوسیستم |
| event | رویداد |
| exception | استثنا |
| expression | عبارت |
| function | تابع |
| generator | تولیدگر |
| global | سراسری |
| import | ایمپورت |
| immutable | تغییرناپذیر |
| index | اندیس، شماره |
| instance | نمونه |
| integer | عدد صحیح |
| interface | رابط |
| interpreter | مفسر |
| item | آیتم |
| iterable | تکرارپذیر |
| keyword | کلیدواژه |
| keyword argument | آرگومان کلیدواژه‌ای |
| list | فهرست |
| list comprehension | درک فهرستی |
| load | بارگذاری |
| loader | بارگذار |
| local | محلی |
| loop | حلقه |
| method | متد |
| method | روش |
| mock | ماک |
| module | ماژول |
| mutable | تغییرپذیر |
| namespace | نام‌فضا |
| object | شیء |
| operator | عملگر |
| package | بسته |
| parameter | پارامتر |
| positional | جایگاهی |
| property | ویژگی، پراپرتی، خصوصیت |
| quotation | علامت نقل‌وقول |
| raise | پرتاب |
| return | بازگشت، برگرداندن |
| runtime | ران‌تایم |
| scope | محدوده |
| shadowing | پوشاندن |
| stack traceback | ردگیری پشته |
| statement | دستور |
| string | رشته |
| syntax | سینتکس، نحو |
| Tracking | پیگیری |
| type | نوع، نوع داده، تایپ |
| unit test | یونیت تست |
| unpacking | واگشایی |
| value | مقدار |
| variable | متغیر |
| wrapper | پوششی، دربرگیرنده |
28 changes: 3 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# ترجمهٔ مستندات پایتون به فارسی 🐍💛

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

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

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

## راهنمای مشارکت 🌱

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

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

1. مخزن را فورک و کلون کنید.
2. اگر ایشیوی مربوط به فایل مورد نظرتان باز نشده، یک ایشیوی «درخواست ترجمهٔ صفحه» باز کنید تا دیگران بدانند آن فایل در حال انجام است.
3. فایل `.po` مورد نظر را با [Poedit](https://poedit.net/) باز کنید (رشته‌های ترجمه‌نشده یا `fuzzy` را می‌توانید از پنل فیلتر پیدا کنید).
4. متن انگلیسی (`msgid`) را ترجمه کنید و در بخش ترجمه (`msgstr`) وارد کنید. ترجمه باید در سطح رسمی و با خطاب «شما» نوشته شود.
5. نشانه‌گذاری‌های Sphinx مثل `` :class:`int` ``، `` :func:`repr` ``، `` ``code`` ``، و جای‌گزین‌هایی مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود.
6. پیش از ارسال پول‌ریکوئست، بررسی کنید فایل‌ها مشکلی ندارند:
```bash
msgfmt --check your_file.po
python3 scripts/check_markup.py your_file.po
```
7. پول‌ریکوئست را باز کنید (حداکثر تا ۴ فایل `.po` در هر پول‌ریکوئست) — روی هر پول‌ریکوئست به‌صورت خودکار بررسی‌های لازم اجرا می‌شود و ری‌دتردکس (Read the Docs) نسخهٔ پیش‌نمایش مستندات را می‌سازد. اگر بررسی‌ها رد شدند، از تب Actions در گیت‌هاب ببینید کدام مورد مشکل داشته و همان اسکریپت را به‌صورت محلی اجرا کنید.

برای دیدن این‌که کدام فایل‌ها هنوز نیاز به ترجمه دارند و چقدر از هرکدام باقی مانده:
```bash
python3 scripts/translation_status.py --only-incomplete
```

راهنمای کامل‌تر این مراحل، از جمله نکات نگارشی و تایپوگرافی فارسی، در [CONTRIBUTING.md](CONTRIBUTING.md) آمده است.
## راهنمای مشارکت
راهنمای کامل مشارکت به پروژه، از جمله نکات نگارشی و تایپوگرافی فارسی، در [CONTRIBUTING.md](CONTRIBUTING.md) آمده است.

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

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

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

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`."
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` را پرتاب خواهد کرد."
Expand Down Expand Up @@ -914,7 +914,7 @@ msgid "If *base* is not an instance of :class:`int` and the *base* object has a
msgstr "اگر *base* نمونه‌ای از :class:`int` نباشد و شیء *base* متد :meth:`base.__index__ <object.__index__>` را تعریف کرده باشد، آن متد برای به‌دست آوردن یک عدد صحیح به‌عنوان مبنا فراخوانی می‌شود. در نسخه‌های پیشین، به‌جای :meth:`base.__index__ <object.__index__>` از :meth:`base.__int__ <object.__int__>` استفاده می‌شد."

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

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