Cleanup parentheses and improve translations

Author: sepehr-rs

.github/ISSUE_TEMPLATE/page_request.md

@@ -18,7 +18,7 @@ assignees: ''
 
 <!-- آیا این صفحه برای فعال‌سازی فارسی در تغییردهنده‌ی زبان (language switcher) لازم است؟ -->
 
-- [ ] بله، از فایل‌های ضروری است
+- [ ] بله، از پرونده‌های ضروری است
 - [ ] خیر
 
 ## آیین‌نامه رفتاری

.github/ISSUE_TEMPLATE/translation_bug.md

@@ -6,9 +6,9 @@ labels: bug
 assignees: ''
 ---
 
-## صفحه / فایل
+## صفحه / پرونده
 
-<!-- مسیر فایل .po یا لینک صفحه‌ی فارسی -->
+<!-- مسیر پرونده .po یا لینک صفحه‌ی فارسی -->
 
 ## متن اصلی (msgid)
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,9 +2,9 @@
 
 <!-- خلاصهای از ترجمه یا تغییری که انجام دادهاید بنویسید. -->
 
-## فایل‌های تغییر یافته
+## پرونده‌های تغییر یافته
 
-<!-- فایل‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
+<!-- پرونده‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
 - `library/functions.po`
 - `tutorial/controlflow.po`
 -->
@@ -16,10 +16,10 @@
 ## چک‌لیست
 <!-- در هر براکتی که انجام شده، یک x قرار دهید.-->
 - [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
-- [ ] `msgfmt --check` روی فایل‌های تغییر یافته با موفقیت اجرا شده است
-- [ ] `python3 scripts/check_markup.py` روی فایل‌های تغییر یافته اجرا شده است
+- [ ] `msgfmt --check` روی پرونده‌های تغییر یافته با موفقیت اجرا شده است
+- [ ] `python3 scripts/check_markup.py` روی پرونده‌های تغییر یافته اجرا شده است
 - [ ] نشانه‌گذاری‌های Sphinx (`:class:`، `:func:`، کد درون‌خطی) و جای‌گذارها (`%s`، `{name}`) دست‌نخورده مانده‌اند
 - [ ] ترجمه‌ها با [واژه‌نامه (GLOSSARY.md)](https://github.com/python/python-docs-fa/blob/3.14/GLOSSARY.md) هماهنگ است
 - [ ] رشته‌های `fuzzy` بررسی و در صورت لزوم بازنویسی شده‌اند
-- [ ] فایل [CONTRIBUTING.md](https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md) با دقت خوانده شده است.
+- [ ] پرونده [CONTRIBUTING.md](https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md) با دقت خوانده شده است.
 <!-- یادآوری: بررسی‌های خودکار (sphinx-lint ،msgfmt ،check_markup و ساخت کامل) در GitHub Actions روی پول‌ریکوئست اجرا می‌شوند. -->

CONTRIBUTING.md

@@ -14,6 +14,7 @@
 | action | اکشن، کنش |
 | anchor | لنگر |
 | annotate | حاشیه‌نویسی کردن |
+| arena | آرنا |
 | annotation | حاشیه‌نویسی |
 | API | API |
 | argument | آرگومان |
@@ -43,6 +44,7 @@
 | bind | مقید کردن |
 | bitmap | بیت‌مپ |
 | bitmask | نقاب بیتی |
+| backport | بک‌پورت |
 | bitwise mask | نقاب بیتی |
 | blob | بلاب |
 | boilerplate | کد پیش‌ساخته، متن قالبی |
@@ -57,6 +59,7 @@
 | broadcast (network/event) | پخش |
 | broadcasting (array) | بسط‌دهی |
 | buffer | بافر |
+| build  | ساخت |
 | built-in | توکار، درونی، درون‌ساخته |
 | by-name | نام‌محور |
 | bytecode | بایت‌کد |
@@ -80,6 +83,7 @@
 | chunked | بخش‌بندی‌شده |
 | cipher | رمز |
 | class | کلاس |
+| client | کلاینت |
 | class method | متد کلاس |
 | class variable | متغیر کلاس |
 | classmethod | classmethod |
@@ -120,7 +124,9 @@
 | dataclass | دیتاکلاس |
 | debugging | اشکال‌زدایی، دیباگ کردن |
 | decoding | کدگشایی |
+| deallocater | آزادساز حافظه |
 | decompressor | واگشا |
+| decompression | واگشایی |
 | decorator | دکوراتور، آراینده |
 | deferred reference counting | شمارش ارجاعِ معوق |
 | delegation | واگذاری |
@@ -129,6 +135,7 @@
 | dependency resolution | حل وابستگی |
 | deprecated | منسوخ، از رده خارج شده |
 | deque | صف دوطرفه |
+| deleter | deleter |
 | descriptor | توصیف‌گر |
 | deserialization | سریال‌زدایی |
 | deserialize | سریال‌زدایی کردن |
@@ -160,13 +167,17 @@
 | entitlement | حق دسترسی |
 | entity | موجودیت |
 | enum | enum |
+| embed | تعبیه کردن |
+| embedded | تعبیه‌شده |
+| embedding | تعبیه |
 | envelope | پاکت |
 | EOF | EOF، پایان پرونده |
 | epoch | مبدأ زمان |
 | escape | خنثی کردن، گریز |
 | event | رویداد |
 | exception | استثنا |
 | executor | اجراکننده |
+| export | اکسپورت |
 | expression | عبارت |
 | extended hex alphabet | الفبای مبنای شانزده‌ی توسعه‌یافته |
 | extension module | ماژول توسعه‌ای |
@@ -175,10 +186,15 @@
 | facility | امکان، دسته گزارش |
 | factory function | تابع کارخانه‌ای |
 | fallback | جایگزین |
+| frame | فریم |
+| frame (GUI) | قاب |
+| folder | پوشه |
+| file | پرونده |
 | file object | شیء پرونده |
 | file-like object | شیء شبه‌پرونده |
 | filesystem encoding | کدگذاری فایل‌سیستم |
 | finalizer | نهایی‌ساز |
+| frozen | فریزشده |
 | finder | یابنده |
 | fixture | ثابت آزمایشی |
 | flattening | تخت‌سازی |
@@ -201,6 +217,8 @@
 | futures | آینده‌نماها، فیوچرز |
 | garbage collection | زباله‌روبی |
 | generator | تولیدگر |
+| getatter | getatter |
+| getter | getter |
 | generator expression | عبارت تولیدگر |
 | generic | عام |
 | generic function | تابع عام، تابع عمومی |
@@ -223,6 +241,9 @@
 | idempotent | هم‌توان |
 | IDN | IDN، دامنه اینترنتی بین‌المللی |
 | immortal | نامیرا |
+| intern | درونی‌سازی کردن |
+| interning | درونی‌سازی |
+| interned | درونی‌سازی‌شده |
 | immutable | تغییرناپذیر |
 | import | ایمپورت |
 | import path | مسیر ایمپورت |
@@ -237,8 +258,10 @@
 | interpreted | تفسیرشده |
 | interpreter | مفسر |
 | invariant | ناوردا |
+| isolate | ایزوله کردن |
 | IPC | ارتباط بین‌فرایندی |
 | item | آیتم |
+| introspection | درون‌نگری |
 | iterable | پیمایش‌پذیر |
 | iterate | پیمایش کردن |
 | iteration | پیمایش |
@@ -258,6 +281,7 @@
 | literal | لفظی |
 | literals | مقادیر لفظی |
 | little-endian | کوچک‌اندیان |
+| linker | پیونددهنده |
 | load | بارگذاری |
 | loader | بارگذار |
 | local | محلی |
@@ -335,6 +359,7 @@
 | pipe | پایپ |
 | placeholder | جای‌نگهدار |
 | poll | پایش |
+| pool | استخر |
 | polling | پایش |
 | portion | بخش |
 | positional | جایگاهی |
@@ -388,9 +413,12 @@
 | scheme | طرح‌واره، طرح |
 | scope | محدوده |
 | seal | مهر و موم |
+| server | سرور |
 | seed | بذر |
 | seek | مکان‌یابی کردن |
 | seeking | مکان‌یابی |
+| setatter | setatter |
+| setter | setter |
 | segmentation fault | خطای قطعه‌بندی (segmentation fault) |
 | sentinel | نشانگر |
 | sequence | دنباله |
@@ -412,6 +440,7 @@
 | spec | مشخصات |
 | special method | متد ویژه |
 | spinbox | اسپین‌باکس |
+| shebang | خط مفسر |
 | stack traceback | ردگیری پشته |
 | state | وضعیت |
 | statement | دستور |
@@ -465,20 +494,23 @@
 | unary | یک‌عملوندی |
 | undo buffer | بافر لغو |
 | unhashable | هش‌ناپذیر |
+| URL | URL، نشانی‌وب |
 | unicode | یونیکد |
 | unit test | آزمون واحد |
 | universal | همگانی |
 | universal newlines | سطرهای جدید همگانی |
 | unmarshal | مارشال‌گشایی کردن |
 | unmarshaling | مارشال‌گشایی |
 | unpacking | واگشایی |
+| unraisable | غیرقابل‌پرتاب |
 | unpacking assignments | انتساب‌های واگشایی |
 | unpickle | پیکل‌گشایی |
 | UTC | UTC، زمان هماهنگ جهانی |
 | value | مقدار |
 | variable | متغیر |
 | variable annotation | حاشیه‌نویسی متغیر |
 | view | نما |
+| verbose | پرگو، پرجزئیات |
 | virtual environment | محیط مجازی |
 | walrus operator | عملگر گراز دریایی |
 | weak reference | ارجاع ضعیف |

GLOSSARY.md

@@ -16,16 +16,16 @@
 
 ### منابع پیشنهادی
 
-پیش از شروع، حتماً نگاهی به این فایل‌ها بیندازید:
+پیش از شروع، حتماً نگاهی به این پرونده‌ها بیندازید:
 
-- [CONTRIBUTING.md](CONTRIBUTING.md) — راهنمای کامل مشارکت: انواع ایشیو، نکات نگارشی و تایپوگرافی فارسی، سطح رسمیت و لحن نوشتار، اندازه‌ی پول‌ریکوئست، فرایند بازبینی و تأیید پول‌ریکوئست، همگام‌سازی با نسخه‌های جدید پایتون (`scripts/update_python_version.py`)، پاک‌سازی رشته‌های `fuzzy` و نگهداری اعتبار مترجمان در سرآیند فایل‌های `.po`.
+- [CONTRIBUTING.md](CONTRIBUTING.md) — راهنمای کامل مشارکت: انواع ایشیو، نکات نگارشی و تایپوگرافی فارسی، سطح رسمیت و لحن نوشتار، اندازه‌ی پول‌ریکوئست، فرایند بازبینی و تأیید پول‌ریکوئست، همگام‌سازی با نسخه‌های جدید پایتون (`scripts/update_python_version.py`)، پاک‌سازی رشته‌های `fuzzy` و نگهداری اعتبار مترجمان در سرآیند پرونده‌های `.po`.
 - [GLOSSARY.md](GLOSSARY.md) — واژه‌نامه‌ی معادل‌های فارسی اصطلاحات تخصصی؛ هنگام ترجمه باید به آن پایبند باشید.
 - [TEAM.md](TEAM.md) — فهرست هماهنگ‌کننده‌ها، بازبین‌ها و مترجمان به‌همراه آمار مشارکت.
-- [STATUS.md](STATUS.md) — جدول وضعیت ترجمه‌ی فایل‌ها که به‌صورت خودکار به‌روزرسانی می‌شود.
+- [STATUS.md](STATUS.md) — جدول وضعیت ترجمه‌ی پرونده‌ها که به‌صورت خودکار به‌روزرسانی می‌شود.
 
 ### شاخه‌های نسخه
 
-ترجمه‌ها به‌ازای هر نسخه‌ی پایتون در یک شاخه‌ی جدا نگهداری می‌شوند. شاخه‌ی فعلی و پیش‌فرض، نسخه‌ی `3.14` است و پول‌ریکوئست‌ها باید روی همین شاخه باز شوند (برای مثال روی فایل‌های `tutorial/`، `library/`، `c-api/` و غیره). هنگام انتشار نسخه‌ی جدید پایتون، هماهنگ‌کننده‌ها شاخه‌ی جدیدی ایجاد و ترجمه‌ها را به آن منتقل می‌کنند.
+ترجمه‌ها به‌ازای هر نسخه‌ی پایتون در یک شاخه‌ی جدا نگهداری می‌شوند. شاخه‌ی فعلی و پیش‌فرض، نسخه‌ی `3.14` است و پول‌ریکوئست‌ها باید روی همین شاخه باز شوند (برای مثال روی پرونده‌های `tutorial/`، `library/`، `c-api/` و غیره). هنگام انتشار نسخه‌ی جدید پایتون، هماهنگ‌کننده‌ها شاخه‌ی جدیدی ایجاد و ترجمه‌ها را به آن منتقل می‌کنند.
 
 ## ارتباط و هماهنگی
 

README.md

@@ -1,8 +1,8 @@
 <!-- TRANSLATION_STATUS_START -->
-### وضعیت ترجمه فایل‌ها
+### وضعیت ترجمه پرونده‌ها
 (به‌روزرسانی: 2026-09-05)
 
-| فایل | ترجمه‌شده | مبهم | تعداد ترجمه‌شده | تعداد ترجمه‌نشده |
+| پرونده | ترجمه‌شده | مبهم | تعداد ترجمه‌شده | تعداد ترجمه‌نشده |
 |:-----|:-----------:|:-----------:|:-----------:|:-----------:|
 | about.po | 100.0% | 0.0% | 10 | 0 |
 | bugs.po | 100.0% | 0.0% | 31 | 0 |

STATUS.md

@@ -98,7 +98,7 @@ msgid "The memory is initialized like :c:func:`PyObject_InitVar`."
 msgstr "حافظه، مانند :c:func:`PyObject_InitVar` مقداردهی اولیه می‌شود."
 
 msgid "This is useful for implementing objects like tuples, which are able to determine their size at construction time.  Embedding the array of fields into the same allocation decreases the number of allocations, improving the memory management efficiency."
-msgstr "این (روش) برای پیاده‌سازی اشیایی مثل تاپل‌ها مفید است، که می‌توانند اندازه‌ی خود را در زمان ساخت تعیین کنند. جاسازی آرایه‌ی فیلدها در همان تخصیص، تعداد تخصیص‌ها را کاهش می‌دهد و بازدهی مدیریت حافظه را بهبود می‌بخشد."
+msgstr "این (روش) برای پیاده‌سازی اشیایی مثل تاپل‌ها مفید است، که می‌توانند اندازه‌ی خود را در زمان ساخت تعیین کنند. تعبیه آرایه‌ی فیلدها در همان تخصیص، تعداد تخصیص‌ها را کاهش می‌دهد و بازدهی مدیریت حافظه را بهبود می‌بخشد."
 
 msgid "This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` instead."
 msgstr "این را نمی‌توان برای اشیایی که :c:macro:`Py_TPFLAGS_HAVE_GC` در :c:member:`~PyTypeObject.tp_flags` آنها تنظیم شده است، استفاده کرد؛ به جای آن از :c:macro:`PyObject_GC_NewVar` استفاده کنید."

c-api/allocation.po

@@ -34,7 +34,7 @@ msgid "Build-time version constants"
 msgstr "ثابتهای نسخه در زمان ساخت"
 
 msgid "CPython exposes its version number in the following macros. Note that these correspond to the version code is **built** with. See :c:var:`Py_Version` for the version used at **run time**."
-msgstr "CPython شماره‌ی نسخه‌ی خود را در ماکروهای زیر در معرض دید قرار می‌دهد. توجه داشته باشید که اینها مربوط به نسخه‌ای هستند که کد با آن **ساخته (build)** شده است. برای نسخه‌ای که در **زمان اجرا** استفاده می‌شود، به :c:var:`Py_Version` مراجعه کنید."
+msgstr "CPython شماره‌ی نسخه‌ی خود را در ماکروهای زیر در معرض دید قرار می‌دهد. توجه داشته باشید که اینها مربوط به نسخه‌ای هستند که کد با آن **ساخته ** شده است. برای نسخه‌ای که در **زمان اجرا** استفاده می‌شود، به :c:var:`Py_Version` مراجعه کنید."
 
 msgid "See :ref:`stable` for a discussion of API and ABI stability across versions."
 msgstr "برای بحث درباره‌ی پایداری API و ABI در میان نسخه‌ها، به :ref:`stable` مراجعه کنید."
@@ -218,7 +218,7 @@ msgstr ""
 "#endif"
 
 msgid "``Py_PACK_FULL_VERSION`` is primarily a macro, intended for use in ``#if`` directives, but it is also available as an exported function."
-msgstr "``Py_PACK_FULL_VERSION`` در درجه‌ی اول یک ماکرو است که برای استفاده در دستورات ``#if`` در نظر گرفته شده است، اما به‌عنوان یک تابع صادرشده نیز در دسترس است."
+msgstr "``Py_PACK_FULL_VERSION`` در درجه‌ی اول یک ماکرو است که برای استفاده در دستورات ``#if`` در نظر گرفته شده است، اما به‌عنوان یک تابع اکسپورتشده نیز در دسترس است."
 
 msgid "Equivalent to ``Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)``. The result does not correspond to any Python release, but is useful in numeric comparisons."
 msgstr "معادل ``Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)`` است. نتیجه با هیچ نسخه‌ی انتشار یافته‌ای از پایتون مطابقت ندارد، اما در مقایسه‌های عددی مفید است."

c-api/apiabiversion.po

@@ -1123,7 +1123,7 @@ msgstr ""
 "*keywords* در :c:func:`PyArg_ParseTupleAndKeywords` و "
 ":c:func:`PyArg_VaParseTupleAndKeywords` درج می‌شود. مقدار پیش‌فرض برای C "
 "خالی و برای C++ مقدار ``const`` است (:c:expr:`const char * const *`). برای "
-"تغییر این مقدار، آن را پیش از گنجاندن (include) :file:`Python.h` به مقدار "
+"تغییر این مقدار، آن را پیش از گنجاندن :file:`Python.h` به مقدار "
 "دلخواه تعریف کنید."
 
 msgid "Building values"