appendix.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# khosro azimi, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
# invincible627 <fatemehzahra810@gmail.com>, 2026
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-07-25 12:59+0330\n"
"PO-Revision-Date: 2026-07-25 18:35+0330\n"
"Last-Translator: invincible627 <fatemehzahra810@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/revisto/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"X-Generator: Poedit 3.6\n"

#: ../../tutorial/appendix.rst:5
msgid "Appendix"
msgstr "پیوست"

#: ../../tutorial/appendix.rst:11
msgid "Interactive Mode"
msgstr "حالت تعاملی"

#: ../../tutorial/appendix.rst:13
msgid ""
"There are two variants of the interactive :term:`REPL`.  The classic basic "
"interpreter is supported on all platforms with minimal line control "
"capabilities."
msgstr ""
"دو نوع از حالت تعاملی :term:`REPL` وجود دارد. مفسر پایه‌ی کلاسیک در تمامی "
"پلتفرم‌ها با حداقل امکانات برای ویرایش خط فرمان پشتیبانی می‌شود."

#: ../../tutorial/appendix.rst:17
msgid ""
"Since Python 3.13, a new interactive shell is used by default. This one "
"supports color, multiline editing, history browsing, and paste mode.  To "
"disable color, see :ref:`using-on-controlling-color` for details.  Function "
"keys provide some additional functionality. :kbd:`F1` enters the interactive "
"help browser :mod:`pydoc`. :kbd:`F2` allows for browsing command-line history "
"with neither output nor the :term:`>>>` and :term:`...` prompts. :kbd:`F3` "
"enters \"paste mode\", which makes pasting larger blocks of code easier. "
"Press :kbd:`F3` to return to the regular prompt."
msgstr ""
"در ویندوز یا سیستم‌های یونیکس‌مانند با پشتیبانی از، به صورت پیش‌فرض از یک شل "
"تعاملی جدید استفاده می‌شود. این شل از رنگ، ویرایش چندخطی، مرور تاریخچه، و حالت "
"چسباندن «paste mode» پشتیبانی می‌کند. برای غیرفعال کردن رنگ، جزئیات را "
"در :ref:`using-on-controlling-color` ببینید. کلیدهای تابعی برخی از قابلیت‌های "
"اضافی را فراهم می‌کنند. :kbd:`F1` مرورگر تعاملی راهنما :mod:`pydoc` را فعال می "
"کند. :kbd:`F2` اجازه می‌دهد تاریخچه خط فرمان را بدون خروجی و بدون اعلان "
"های :term:`>>>` و :term:`...` مرور کنید. :kbd:`F3` حالت \"چسباندن\" را فعال می "
"کند که چسباندن بلوک‌های بزرگ‌تر کد را آسان‌تر می‌سازد. برای بازگشت به اعلان "
"معمولی، :kbd:`F3` را فشار دهید."

#: ../../tutorial/appendix.rst:27
msgid ""
"When using the new interactive shell, exit the shell by typing :kbd:`exit` "
"or :kbd:`quit`. Adding call parentheses after those commands is not required."
msgstr ""
"وقتی از پوسته‌ی تعاملی جدید استفاده می‌کنید، با تایپ :kbd:`exit` یا :kbd:`quit` "
"از پوسته خارج شوید. اضافه‌کردن پرانتز پس از این دستورات ضروری نیست."

#: ../../tutorial/appendix.rst:31
msgid ""
"If the new interactive shell is not desired, it can be disabled via "
"the :envvar:`PYTHON_BASIC_REPL` environment variable."
msgstr ""
"اگر پوسته‌ی تعاملی جدید مطلوب نباشد، می‌توان آن را از طریق متغیر "
"محیطی :envvar:`PYTHON_BASIC_REPL` غیرفعال کرد."

#: ../../tutorial/appendix.rst:37
msgid "Error Handling"
msgstr "مدیریت خطاها"

#: ../../tutorial/appendix.rst:39
msgid ""
"When an error occurs, the interpreter prints an error message and a stack "
"trace. In interactive mode, it then returns to the primary prompt; when input "
"came from a file, it exits with a nonzero exit status after printing the stack "
"trace. (Exceptions handled by an :keyword:`except` clause in a :keyword:`try` "
"statement are not errors in this context.)  Some errors are unconditionally "
"fatal and cause an exit with a nonzero exit status; this applies to internal "
"inconsistencies and some cases of running out of memory.  All error messages "
"are written to the standard error stream; normal output from executed commands "
"is written to standard output."
msgstr ""
"زمان بروز خطا، مفسر یک پیام خطا و «گزارش پشته» «stack trace» چاپ می‌کند. در "
"حالت تعاملی، بعد از نمایش خطا، برنامه به حالت آماده‌باش برای دریافت دستورات "
"جدید بازمی‌گردد؛ اما اگر ورودی از یک فایل آمده باشد، پس از چاپ گزارش پشته با یک "
"کد خروجی غیر صفر از برنامه خارج می‌شود. (استثناهایی که با بخش :keyword:`except` "
"در یک دستور :keyword:`try` مدیریت می‌شوند، در این زمینه خطا محسوب نمی‌شوند.) "
"بعضی خطاها به‌طور قطعی باعث خروج از برنامه می‌شوند و کد خروجی غیر صفر دارند؛ این "
"در مورد ناسازگاری‌های داخلی یا در برخی موارد کمبود حافظه صدق می‌کند. تمام "
"پیام‌های خطا در جریان خروجی خطا «standard error» نوشته می‌شوند؛ خروجی معمول "
"دستورات اجراشده نیز در جریان خروجی استاندارد «standard output» نوشته می‌شود."

#: ../../tutorial/appendix.rst:49
msgid ""
"Typing the interrupt character (usually :kbd:`Control-C` or :kbd:`Delete`) to "
"the primary or secondary prompt cancels the input and returns to the primary "
"prompt. [#]_ Typing an interrupt while a command is executing raises "
"the :exc:`KeyboardInterrupt` exception, which may be handled by "
"a :keyword:`try` statement."
msgstr ""
"فشردن کلید وقفه (که معمولاً :kbd:`Control-C` یا :kbd:`Delete` است) در اعلان "
"اصلی یا فرعی، ورودی را لغو کرده و کاربر را به اعلان اصلی بازمی‌گرداند. [#]_ "
"فشردن کلید وقفه در حین اجرای یک دستور، استثنای :exc:`KeyboardInterrupt` را "
"ایجاد می‌کند که می‌توان آن را با دستور :keyword:`try` مدیریت کرد."

#: ../../tutorial/appendix.rst:59
msgid "Executable Python Scripts"
msgstr "اسکریپتهای اجرایی پایتون"

#: ../../tutorial/appendix.rst:61
msgid ""
"On BSD'ish Unix systems, Python scripts can be made directly executable, like "
"shell scripts, by putting the line ::"
msgstr ""
"در سیستم‌عامل‌های یونیکس مبتنی بر BSD، اسکریپتهای پایتون می‌توانند مانند "
"اسکریپتهای شل به صورت مستقیم اجرایی شوند، با قرار دادن خط ::"

#: ../../tutorial/appendix.rst:64
msgid "#!/usr/bin/env python3"
msgstr "#!/usr/bin/env python3"

#: ../../tutorial/appendix.rst:66
msgid ""
"(assuming that the interpreter is on the user's :envvar:`PATH`) at the "
"beginning of the script and giving the file an executable mode.  The ``#!`` "
"must be the first two characters of the file.  On some platforms, this first "
"line must end with a Unix-style line ending (``'\\n'``), not a Windows "
"(``'\\r\\n'``) line ending.  Note that the hash, or pound, character, ``'#'``, "
"is used to start a comment in Python."
msgstr ""
"(با فرض اینکه مفسر در :envvar:`PATH` کاربر قرار دارد) در ابتدای اسکریپت باید "
"قرار گیرد و فایل باید به حالت قابل اجرا تنظیم شود. ``#!`` باید نخستین دو "
"نویسه‌ی فایل باشند. در برخی پلتفرم‌ها، این خط اول باید با پایان خط به سبک یونیکس "
"(``'\\n'``) تمام شود، نه پایان خط ویندوزی (``'\\r\\n'``). توجه داشته باشید که "
"نویسه‌ی ``'#'`` برای آغاز یک توضیح (کامنت) در پایتون به کار می‌رود."

#: ../../tutorial/appendix.rst:73
msgid ""
"The script can be given an executable mode, or permission, using "
"the :program:`chmod` command."
msgstr ""
"با استفاده از دستور :program:`chmod` می‌توان به اسکریپت حالت اجرایی یا مجوز "
"اجرا داد."

#: ../../tutorial/appendix.rst:76
msgid "$ chmod +x myscript.py"
msgstr "$ chmod +x myscript.py"

#: ../../tutorial/appendix.rst:80
msgid ""
"On Windows systems, there is no notion of an \"executable mode\".  The Python "
"installer automatically associates ``.py`` files with ``python.exe`` so that a "
"double-click on a Python file will run it as a script.  The extension can also "
"be ``.pyw``, in that case, the console window that normally appears is "
"suppressed."
msgstr ""
"در سیستم‌عامل ویندوز، مفهوم «حالت اجرایی» \"executable mode\" وجود ندارد. "
"نصب‌کننده‌ی پایتون به‌طور خودکار فایل‌های ``.py`` را به ``python.exe`` مرتبط می‌کند "
"تا با دوبار کلیک روی فایل پایتون، به‌عنوان اسکریپت اجرا شود. پسوند فایل همچنین "
"می‌تواند ``.pyw`` باشد که در این صورت پنجره کنسولی که معمولاً ظاهر می‌شود، نمایش "
"داده نمی‌شود."

#: ../../tutorial/appendix.rst:90
msgid "The Interactive Startup File"
msgstr "پرونده‌ی آغازین تعاملی «The Interactive Startup File»"

#: ../../tutorial/appendix.rst:92
msgid ""
"When you use Python interactively, it is frequently handy to have some "
"standard commands executed every time the interpreter is started.  You can do "
"this by setting an environment variable named :envvar:`PYTHONSTARTUP` to the "
"name of a file containing your start-up commands.  This is similar to "
"the :file:`.profile` feature of the Unix shells."
msgstr ""
"هنگامی که به صورت تعاملی از پایتون استفاده می‌کنید، اجرای برخی دستورات "
"استاندارد در هر بار شروع مفسر می‌تواند مفید باشد. شما می‌توانید این کار را با "
"تنظیم متغیر محیطی با نام :envvar:`PYTHONSTARTUP` به نام فایلی که حاوی دستورات "
"شروع شما است انجام دهید. این قابلیت شبیه به ویژگی :file:`.profile` در شل‌های "
"یونیکس است."

#: ../../tutorial/appendix.rst:98
msgid ""
"This file is only read in interactive sessions, not when Python reads commands "
"from a script, and not when :file:`/dev/tty` is given as the explicit source "
"of commands (which otherwise behaves like an interactive session).  It is "
"executed in the same namespace where interactive commands are executed, so "
"that objects that it defines or imports can be used without qualification in "
"the interactive session. You can also change the prompts ``sys.ps1`` and "
"``sys.ps2`` in this file."
msgstr ""
"این فایل فقط در جلسات تعاملی خوانده می‌شود، نه زمانی که پایتون دستورات را از "
"یک اسکریپت می‌خواند، و نه زمانی که :file:`/dev/tty` به عنوان منبع صریح دستورات "
"داده می‌شود (که در غیر این صورت همچون یک جلسه‌ی تعاملی رفتار می‌کند). این فایل "
"در همان فضای نامی که در آن دستورات تعاملی اجرا می‌شوند، اجرا می‌گردد بنابراین "
"اشیایی که تعریف یا وارد می‌کند می‌توانند بدون مشخص شدن در جلسه تعاملی مورد "
"استفاده قرار گیرند. شما می‌توانید درخواست‌ها ``sys.ps1`` و ``sys.ps2`` را نیز "
"در این فایل تغییر دهید."

#: ../../tutorial/appendix.rst:106
msgid ""
"If you want to read an additional start-up file from the current directory, "
"you can program this in the global start-up file using code like ``if "
"os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``. If you "
"want to use the startup file in a script, you must do this explicitly in the "
"script::"
msgstr ""
"اگر می‌خواهید یک فایل راه‌اندازی اضافی از دایرکتوری فعلی بخوانید، "
"می‌توانید این کار را در فایل راه‌اندازی عمومی با کدی مشابه ``if "
"os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``. اگر "
"می‌خواهید از فایل راه‌اندازی در یک اسکریپت استفاده کنید، باید این کار را به‌طور صریح در "
"اسکریپت انجام دهید::"

#: ../../tutorial/appendix.rst:112
msgid ""
"import os\n"
"filename = os.environ.get('PYTHONSTARTUP')\n"
"if filename and os.path.isfile(filename):\n"
"    with open(filename) as fobj:\n"
"        startup_file = fobj.read()\n"
"    exec(startup_file)"
msgstr ""
"import os\n"
"filename = os.environ.get('PYTHONSTARTUP')\n"
"if filename and os.path.isfile(filename):\n"
"    with open(filename) as fobj:\n"
"        startup_file = fobj.read()\n"
"    exec(startup_file)"

#: ../../tutorial/appendix.rst:123
msgid "The Customization Modules"
msgstr "ماژول‌های سفارشی‌سازی"

#: ../../tutorial/appendix.rst:125
msgid ""
"Python provides two hooks to let you customize it: :index:`sitecustomize` "
"and :index:`usercustomize`.  To see how it works, you need first to find the "
"location of your user site-packages directory.  Start Python and run this "
"code::"
msgstr ""
"پایتون دو نقطه‌ی اتصال برای سفارشی سازی ارائه می‌دهد: :index:`sitecustomize` "
"و :index:`usercustomize`. برای دیدن چگونگی کارکرد آن، ابتدا باید مکان "
"دایرکتوری user site-packages خود را پیدا کنید. پایتون را اجرا کرده و این کد را "
"اجرا کنید:"

#: ../../tutorial/appendix.rst:129
msgid ""
">>> import site\n"
">>> site.getusersitepackages()\n"
"'/home/user/.local/lib/python3.x/site-packages'"
msgstr ""
">>> import site\n"
">>> site.getusersitepackages()\n"
"'/home/user/.local/lib/python3.x/site-packages'"

#: ../../tutorial/appendix.rst:133
msgid ""
"Now you can create a file named :file:`usercustomize.py` in that directory and "
"put anything you want in it.  It will affect every invocation of Python, "
"unless it is started with the :option:`-s` option to disable the automatic "
"import."
msgstr ""
"حالا می‌توانید فایلی به نام :file:`usercustomize.py` در آن دایرکتوری ایجاد کرده "
"و هر چیزی که می‌خواهید در آن قرار دهید. این فایل روی هر بار اجرای پایتون تأثیر "
"خواهد گذاشت، مگر اینکه پایتون با گزینه :option:`-s` اجرا شود تا وارد کردن "
"خودکار غیرفعال گردد."

#: ../../tutorial/appendix.rst:137
msgid ""
":index:`sitecustomize` works in the same way, but is typically created by an "
"administrator of the computer in the global site-packages directory, and is "
"imported before :index:`usercustomize`.  See the documentation of "
"the :mod:`site` module for more details."
msgstr ""
":index:`sitecustomize` به همان صورت کار می‌کند، اما به‌طور معمول توسط مدیر "
"سیستم در دایرکتوری global site-packages ایجاد می‌شود و قبل "
"از :index:`usercustomize` وارد می‌شود. برای جزئیات بیشتر به مستندات "
"ماژول :mod:`site` مراجعه کنید."

#: ../../tutorial/appendix.rst:144
msgid "Footnotes"
msgstr "پاورقی‌ها"

#: ../../tutorial/appendix.rst:145
msgid "A problem with the GNU Readline package may prevent this."
msgstr "یک مشکل در بسته‌ی «GNU Readline» ممکن است مانع این کار شود."