# 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
#
#, 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: 2021-06-28 01:49+0000\n"
"Last-Translator: khosro azimi, 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
"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"

#: ../../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
#, fuzzy
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 ""
"در ویندوز یا سیستم های یونیکس مانند با پشتیبانی از :mod:`curses`، به صورت "
"پیش فرض از یک شل تعاملی جدید استفاده می شود. این شل از رنگ، ویرایش چندخطی، "
"مرور تاریخچه، و حالت چسباندن «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` است) در اعلان "
"اصلی یا فرعی، ورودی را لغو کرده و کاربر را به اعلان اصلی بازمی‌گرداند. [#]_ \n"
"فشردن کلید وقفه در حین اجرای یک دستور، استثنای :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» ممکن است مانع این کار شود."