"Language-Team: Persian (https://github.com/python/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"
msgid"Installing Python modules"
msgstr"نصب ماژول‌های پایتون"
msgid"As a popular open source development project, Python has an active supporting community of contributors and users that also make their software available for other Python developers to use under open-source license terms."
msgstr"پایتون به عنوان یک پروژه توسعه متن‌باز محبوب، دارای کامیونیتی پشتیبان فعالی از مشارکت‌کنندگان و کاربران است که نرم‌افزار خود را نیز تحت شرایط مجوز متن‌باز برای استفاده‌ی سایر توسعه‌دهندگان پایتون در دسترس قرار می‌دهند."
msgid"This allows Python users to share and collaborate effectively, benefiting from the solutions others have already created to common (and sometimes even rare!) problems, as well as potentially contributing their own solutions to the common pool."
msgstr"این به کاربران پایتون امکان می‌دهد تا به‌طور مؤثر به اشتراک‌گذاری و همکاری بپردازند؛ هم از راه‌حل‌هایی که دیگران پیش‌تر برای مشکلات رایج (و گاهی حتی نادر!) ایجاد کرده‌اند بهره ببرند و هم به‌طور بالقوه راه‌حل‌های خود را به استخر مشترک بیفزایند."
msgid"This guide covers the installation part of the process. For a guide to creating and sharing your own Python projects, refer to the `Python packaging user guide`_."
msgstr"این راهنما بخش نصب این فرایند را در بر می‌گیرد. برای راهنمایی درباره‌ی ایجاد و اشتراک‌گذاری پروژه‌های پایتون خودتان، به `Python packaging user guide`_ مراجعه کنید."
msgid"For corporate and other institutional users, be aware that many organisations have their own policies around using and contributing to open source software. Please take such policies into account when making use of the distribution and installation tools provided with Python."
msgstr"برای کاربران شرکتی و سایر کاربران سازمانی، آگاه باشید که بسیاری از سازمان‌ها سیاست‌های خاص خود را در زمینه استفاده از نرم‌افزارهای متن‌باز و مشارکت در آن‌ها دارند. لطفاً هنگام استفاده از ابزارهای توزیع و نصب ارائه‌شده به همراه پایتون، این سیاست‌ها را در نظر بگیرید."
msgid"Key terms"
msgstr"اصطلاحات کلیدی"
msgid":program:`pip` is the preferred installer program. It is included by default with the Python binary installers."
msgstr":program:`pip` برنامه‌ی نصب‌کننده‌ی ترجیحی است. این برنامه به‌صورت پیش‌فرض در نصب‌کننده‌های دودویی پایتون گنجانده شده است."
msgid"A *virtual environment* is a semi-isolated Python environment that allows packages to be installed for use by a particular application, rather than being installed system wide."
msgstr"*محیط مجازی* یک محیط نیمه‌ایزوله‌ی پایتون است که اجازه می‌دهد بسته‌ها برای استفاده‌ی یک برنامه‌ی خاص نصب شوند، نه به‌صورت سراسری در کل سیستم."
msgid"``venv`` is the standard tool for creating virtual environments. It defaults to installing :program:`pip` into all created virtual environments."
msgstr"``venv`` ابزار استاندارد برای ایجاد محیط‌های مجازی است. این ابزار به‌طور پیش‌فرض :program:`pip` را در تمام محیط‌های مجازی ایجادشده نصب می‌کند."
msgid"``virtualenv`` is a third-party alternative (and predecessor) to ``venv``."
msgstr"``virtualenv`` یک جایگزین شخص ثالث (و پیشینی) برای ``venv`` است."
msgid"The `Python Package Index (PyPI) <https://pypi.org>`__ is a public repository of open source licensed packages made available for use by other Python users."
msgstr"`شاخص بسته‌های پایتون (PyPI) <https://pypi.org>`__ یک مخزن عمومی از بسته‌های دارای مجوز متن‌باز است که برای استفاده‌ی سایر کاربران پایتون در دسترس قرار گرفته‌اند."
msgid"The `Python Packaging Authority <https://www.pypa.io/>`__ is the group of developers and documentation authors responsible for the maintenance and evolution of the standard packaging tools and the associated metadata and file format standards. They maintain a variety of tools, documentation, and issue trackers on `GitHub <https://github.com/pypa>`__."
msgstr"`Python Packaging Authority <https://www.pypa.io/>`__ گروهی از توسعه‌دهندگان و نویسندگان مستندات است که مسئولیت نگهداری و تکامل ابزارهای استاندارد بسته‌بندی و استانداردهای مرتبط با فراداده و قالب پرونده را بر عهده دارند. آن‌ها ابزارها، مستندات و ردیاب‌های مشکل (issue tracker) گوناگونی را در `GitHub <https://github.com/pypa>`__ نگهداری می‌کنند."
msgid"The use of ``venv`` is now recommended for creating virtual environments."
msgstr"استفاده از ``venv`` اکنون برای ایجاد محیط‌های مجازی توصیه می‌شود."
msgid"`Python Packaging User Guide: Creating and using virtual environments <https://packaging.python.org/installing/#creating-virtual-environments>`__"
msgstr"`راهنمای کاربری بسته‌بندی پایتون: ساخت و استفاده از محیط‌های مجازی <https://packaging.python.org/installing/#creating-virtual-environments>`__"
msgid"Basic usage"
msgstr"استفاده پایه"
msgid"The standard packaging tools are all designed to be used from the command line."
msgstr"همه‌ی ابزارهای استاندارد بسته‌بندی برای استفاده از طریق خط فرمان طراحی شده‌اند."
msgid"The following command will install the latest version of a module and its dependencies from PyPI::"
msgstr"دستور زیر آخرین نسخه‌ی یک ماژول و وابستگی‌های آن را از PyPI نصب می‌کند::"
msgid"python -m pip install SomePackage"
msgstr"python -m pip install SomePackage"
msgid"For POSIX users (including macOS and Linux users), the examples in this guide assume the use of a :term:`virtual environment`."
msgstr"برای کاربران POSIX (از جمله کاربران macOS و Linux)، مثال‌های این راهنما فرض می‌کنند که از :term:`محیط مجازی <virtual environment>` استفاده می‌شود."
msgid"For Windows users, the examples in this guide assume that the option to adjust the system PATH environment variable was selected when installing Python."
msgstr"برای کاربران ویندوز، مثال‌های این راهنما فرض می‌کنند که هنگام نصب پایتون، گزینه‌ی تنظیم متغیر محیطی PATH سیستم انتخاب شده باشد."
msgid"It's also possible to specify an exact or minimum version directly on the command line. When using comparator operators such as ``>``, ``<`` or some other special character which get interpreted by shell, the package name and the version should be enclosed within double quotes::"
msgstr"همچنین می‌توانید نسخه‌ی دقیق یا حداقلی را مستقیماً در خط فرمان مشخص کنید. هنگام استفاده از عملگرهای مقایسه‌ای مانند ``>`` و ``<`` یا هر نویسه‌ی خاص دیگری که توسط پوسته تفسیر می‌شود، باید نام بسته و نسخه را داخل علامت نقل‌قول دوتایی قرار دهید::"
msgid""
"python -m pip install SomePackage==1.0.4 # specific version\n"
msgid"Normally, if a suitable module is already installed, attempting to install it again will have no effect. Upgrading existing modules must be requested explicitly::"
msgstr"معمولاً، اگر ماژول مناسب از قبل نصب‌شده باشد، تلاش برای نصب مجدد آن هیچ اثری نخواهد داشت. ارتقای ماژول‌های موجود باید صریحاً درخواست شود::"
msgid"More information and resources regarding :program:`pip` and its capabilities can be found in the `Python Packaging User Guide <https://packaging.python.org>`__."
msgstr"اطلاعات و منابع بیشتر درباره‌ی :program:`pip` و قابلیت‌های آن را می‌توانید در `راهنمای کاربری بسته‌بندی پایتون <https://packaging.python.org>`__ بیابید."
msgid"Creation of virtual environments is done through the :mod:`venv` module. Installing packages into an active virtual environment uses the commands shown above."
msgstr"ایجاد محیط‌های مجازی از طریق ماژول :mod:`venv` انجام می‌شود. نصب بسته‌ها در یک محیط مجازی فعال از دستورهای نشان‌داده‌شده در بالا استفاده می‌کند."
msgid"`Python Packaging User Guide: Installing Python Distribution Packages <https://packaging.python.org/installing/>`__"
msgid"These are quick answers or links for some common tasks."
msgstr"این‌ها پاسخ‌های سریع یا پیوندهایی برای برخی از کارهای رایج هستند."
msgid"... install packages just for the current user?"
msgstr"... بسته‌ها را فقط برای کاربر فعلی نصب کنم؟"
msgid"Passing the ``--user`` option to ``python -m pip install`` will install a package just for the current user, rather than for all users of the system."
msgstr"با دادن گزینه‌ی ``--user`` به ``python -m pip install``، بسته‌ای فقط برای کاربر فعلی نصب می‌شود، نه برای همه‌ی کاربران سیستم."
msgid"... install scientific Python packages?"
msgstr"... بسته‌های علمی پایتون را نصب کنم؟"
msgid"A number of scientific Python packages have complex binary dependencies, and aren't currently easy to install using :program:`pip` directly. It will often be easier for users to install these packages by `other means <https://packaging.python.org/science/>`__ rather than attempting to install them with :program:`pip`."
msgstr"تعدادی از بسته‌های علمی پایتون وابستگی‌های دودویی پیچیده‌ای دارند و در حال حاضر نصب مستقیم آن‌ها با :program:`pip` آسان نیست. اغلب برای کاربران آسان‌تر خواهد بود که این بسته‌ها را از طریق `روش‌های دیگر <https://packaging.python.org/science/>`__ نصب کنند، به‌جای تلاش برای نصب آن‌ها با :program:`pip`."
msgid"`Python Packaging User Guide: Installing Scientific Packages <https://packaging.python.org/science/>`__"
msgstr"`راهنمای کاربر بسته‌بندی پایتون: نصب بسته‌های علمی <https://packaging.python.org/science/>`__"
msgid"... work with multiple versions of Python installed in parallel?"
msgstr"... با چندین نسخه از پایتون که به‌صورت موازی نصب شده‌اند کار کنم؟"
msgid"On Linux, macOS, and other POSIX systems, use the versioned Python commands in combination with the ``-m`` switch to run the appropriate copy of :program:`pip`::"
msgstr"در لینوکس، macOS و دیگر سیستم‌های POSIX، از دستورهای پایتون نسخه‌دار در ترکیب با سوییچ ``-m`` برای اجرای کپی مناسب :program:`pip` استفاده کنید::"
msgid"On Linux systems, a Python installation will typically be included as part of the distribution. Installing into this Python installation requires root access to the system, and may interfere with the operation of the system package manager and other components of the system if a component is unexpectedly upgraded using :program:`pip`."
msgstr"در سامانه‌های لینوکسی، معمولاً یک نصب پایتون به عنوان بخشی از توزیع گنجانده می‌شود. نصب در این نصب پایتون نیازمند دسترسی root به سامانه است و در صورت ارتقای غیرمنتظره‌ی یک جزء با استفاده از :program:`pip`، ممکن است در عملکرد مدیر بسته‌ی سامانه و سایر اجزای سامانه اختلال ایجاد کند."
msgid"On such systems, it is often better to use a virtual environment or a per-user installation when installing packages with :program:`pip`."
msgstr"در چنین سیستم‌هایی، هنگام نصب بسته‌ها با :program:`pip`، اغلب بهتر است از یک محیط مجازی یا نصب در سطح کاربر استفاده کنید."
msgid"Pip not installed"
msgstr"Pip نصب نشده است"
msgid"It is possible that :program:`pip` does not get installed by default. One potential fix is::"
msgstr"ممکن است :program:`pip` به‌صورت پیش‌فرض نصب نشود. یک راه‌حل احتمالی این است::"
msgid"python -m ensurepip --default-pip"
msgstr"python -m ensurepip --default-pip"
msgid"There are also additional resources for `installing pip <https://packaging.python.org/en/latest/tutorials/installing-packages/#ensure-pip-setuptools-and-wheel-are-up-to-date>`__."
msgstr"همچنین منابع اضافی برای `نصب pip <https://packaging.python.org/en/latest/tutorials/installing-packages/#ensure-pip-setuptools-and-wheel-are-up-to-date>`__ وجود دارد."
msgid"Installing binary extensions"
msgstr"نصب ماژول‌های توسعه‌ای دودویی"
msgid"Python once relied heavily on source-based distribution, with end users being expected to compile extension modules from source as part of the installation process."
msgstr"پایتون زمانی تکیه‌ی سنگینی بر توزیع مبتنی بر کد منبع داشت و از کاربران نهایی انتظار می‌رفت که ماژول‌های توسعه‌ای را به عنوان بخشی از فرایند نصب، از کد منبع کامپایل کنند."
msgid"With the introduction of the binary wheel format, and the ability to publish wheels through PyPI, this problem is diminishing, as users are more regularly able to install pre-built extensions rather than needing to build them themselves."
msgstr"با معرفی قالب چرخ (wheel) دودویی و امکان انتشار چرخ‌ها از طریق PyPI، این مشکل در حال کاهش است، زیرا کاربران به‌طور منظم‌تری می‌توانند افزونه‌های پیش‌ساخته را نصب کنند، به‌جای اینکه ناچار باشند خودشان آن‌ها را بسازند."
msgid"Some of the solutions for installing `scientific software <https://packaging.python.org/science/>`__ that are not yet available as pre-built wheel files may also help with obtaining other binary extensions without needing to build them locally."
msgstr"برخی از راه‌حل‌های نصب `نرم‌افزار علمی <https://packaging.python.org/science/>`__ که هنوز به‌صورت پرونده‌های wheel پیش‌ساخته در دسترس نیست، ممکن است در به‌دست آوردن سایر توسعه‌های دودویی بدون نیاز به ساخت آن‌ها به‌طور محلی نیز کمک کنند."
msgid"`Python Packaging User Guide: Binary Extensions <https://packaging.python.org/extensions/>`__"