python-docs-fa/installing/index.po at update-CI · python/python-docs-fa

338 lines (285 loc) · 10.3 KB
# 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:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Gigahertz ., 2025
"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 00:54+0000\n"
"Last-Translator: Gigahertz ., 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
"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"
#: ../../installing/index.rst:7
msgid "Installing Python modules"
#: ../../installing/index.rst:9
"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."
#: ../../installing/index.rst:13
"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."
#: ../../installing/index.rst:18
"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`_."
#: ../../installing/index.rst:26
"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."
#: ../../installing/index.rst:33
msgid "Key terms"
#: ../../installing/index.rst:35
":program:`pip` is the preferred installer program. It is included by default "
"with the Python binary installers."
#: ../../installing/index.rst:37
"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."
#: ../../installing/index.rst:40
"``venv`` is the standard tool for creating virtual environments. It defaults "
"to installing :program:`pip` into all created virtual environments."
#: ../../installing/index.rst:42
"``virtualenv`` is a third-party alternative (and predecessor) to ``venv``."
#: ../../installing/index.rst:44
"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."
#: ../../installing/index.rst:47
"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>`__."
#: ../../installing/index.rst:54
"The use of ``venv`` is now recommended for creating virtual environments."
#: ../../installing/index.rst:59
"`Python Packaging User Guide: Creating and using virtual environments "
"<https://packaging.python.org/installing/#creating-virtual-environments>`__"
#: ../../installing/index.rst:64
msgid "Basic usage"
#: ../../installing/index.rst:66
"The standard packaging tools are all designed to be used from the command "
#: ../../installing/index.rst:69
"The following command will install the latest version of a module and its "
"dependencies from PyPI::"
#: ../../installing/index.rst:72
msgid "python -m pip install SomePackage"
#: ../../installing/index.rst:76
"For POSIX users (including macOS and Linux users), the examples in this "
"guide assume the use of a :term:`virtual environment`."
#: ../../installing/index.rst:79
"For Windows users, the examples in this guide assume that the option to "
"adjust the system PATH environment variable was selected when installing "
#: ../../installing/index.rst:83
"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::"
#: ../../installing/index.rst:88
"python -m pip install SomePackage==1.0.4    # specific version\n"
"python -m pip install \"SomePackage>=1.0.4\"  # minimum version"
#: ../../installing/index.rst:91
"Normally, if a suitable module is already installed, attempting to install "
"it again will have no effect. Upgrading existing modules must be requested "
"explicitly::"
#: ../../installing/index.rst:95
msgid "python -m pip install --upgrade SomePackage"
#: ../../installing/index.rst:97
"More information and resources regarding :program:`pip` and its capabilities "
"can be found in the `Python Packaging User Guide <https://"
"packaging.python.org>`__."
#: ../../installing/index.rst:100
"Creation of virtual environments is done through the :mod:`venv` module. "
"Installing packages into an active virtual environment uses the commands "
"shown above."
#: ../../installing/index.rst:106
"`Python Packaging User Guide: Installing Python Distribution Packages "
"<https://packaging.python.org/installing/>`__"
#: ../../installing/index.rst:111
msgid "How do I ...?"
#: ../../installing/index.rst:113
msgid "These are quick answers or links for some common tasks."
#: ../../installing/index.rst:118
msgid "... install packages just for the current user?"
#: ../../installing/index.rst:120
"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."
#: ../../installing/index.rst:125
msgid "... install scientific Python packages?"
#: ../../installing/index.rst:127
"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`."
#: ../../installing/index.rst:135
"`Python Packaging User Guide: Installing Scientific Packages <https://"
"packaging.python.org/science/>`__"
#: ../../installing/index.rst:140
msgid "... work with multiple versions of Python installed in parallel?"
#: ../../installing/index.rst:142
"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`::"
#: ../../installing/index.rst:146
"python3    -m pip install SomePackage  # default Python 3\n"
"python3.14 -m pip install SomePackage  # specifically Python 3.14"
#: ../../installing/index.rst:149
msgid "Appropriately versioned :program:`pip` commands may also be available."
#: ../../installing/index.rst:151
"On Windows, use the :program:`py` Python launcher in combination with the ``-"
"m`` switch::"
#: ../../installing/index.rst:154
"py -3    -m pip install SomePackage  # default Python 3\n"
"py -3.14 -m pip install SomePackage  # specifically Python 3.14"
#: ../../installing/index.rst:166
msgid "Common installation issues"
#: ../../installing/index.rst:169
msgid "Installing into the system Python on Linux"
#: ../../installing/index.rst:171
"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`."
#: ../../installing/index.rst:177
"On such systems, it is often better to use a virtual environment or a per-"
"user installation when installing packages with :program:`pip`."
#: ../../installing/index.rst:182
msgid "Pip not installed"
#: ../../installing/index.rst:184
"It is possible that :program:`pip` does not get installed by default. One "
"potential fix is::"
#: ../../installing/index.rst:186
msgid "python -m ensurepip --default-pip"
#: ../../installing/index.rst:188
"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>`__."
#: ../../installing/index.rst:193
msgid "Installing binary extensions"
#: ../../installing/index.rst:195
"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."
#: ../../installing/index.rst:199
"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."
#: ../../installing/index.rst:204
"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."
#: ../../installing/index.rst:211
"`Python Packaging User Guide: Binary Extensions <https://"
"packaging.python.org/extensions/>`__"
Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

index.po

Latest commit

History

index.po

File metadata and controls
