From 3843027bb1cfb7a731db33ed3b40fc0160f4f845 Mon Sep 17 00:00:00 2001 From: Sepehr Rasouli Date: Wed, 29 Jul 2026 16:41:46 +0330 Subject: [PATCH] Translate venv.po --- tutorial/venv.po | 257 ++++++++++++++++++++++++++++++----------------- 1 file changed, 167 insertions(+), 90 deletions(-) diff --git a/tutorial/venv.po b/tutorial/venv.po index d8436e6f8..6c5358035 100644 --- a/tutorial/venv.po +++ b/tutorial/venv.po @@ -15,8 +15,7 @@ msgstr "" "POT-Creation-Date: 2026-07-25 12:59+0330\n" "PO-Revision-Date: 2021-06-28 01:50+0000\n" "Last-Translator: Alireza Shabani (Revisto) , 2025\n" -"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/" -"fa/)\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" @@ -33,37 +32,34 @@ msgstr "" #: ../../tutorial/venv.rst:11 msgid "" -"Python applications will often use packages and modules that don't come as " -"part of the standard library. Applications will sometimes need a specific " -"version of a library, because the application may require that a particular " -"bug has been fixed or the application may be written using an obsolete " -"version of the library's interface." +"Python applications will often use packages and modules that don't come as part of the standard " +"library. Applications will sometimes need a specific version of a library, because the " +"application may require that a particular bug has been fixed or the application may be written " +"using an obsolete version of the library's interface." msgstr "" #: ../../tutorial/venv.rst:17 msgid "" -"This means it may not be possible for one Python installation to meet the " -"requirements of every application. If application A needs version 1.0 of a " -"particular module but application B needs version 2.0, then the requirements " -"are in conflict and installing either version 1.0 or 2.0 will leave one " -"application unable to run." +"This means it may not be possible for one Python installation to meet the requirements of every " +"application. If application A needs version 1.0 of a particular module but application B needs " +"version 2.0, then the requirements are in conflict and installing either version 1.0 or 2.0 will " +"leave one application unable to run." msgstr "" #: ../../tutorial/venv.rst:23 msgid "" -"The solution for this problem is to create a :term:`virtual environment`, a " -"self-contained directory tree that contains a Python installation for a " -"particular version of Python, plus a number of additional packages." +"The solution for this problem is to create a :term:`virtual environment`, a self-contained " +"directory tree that contains a Python installation for a particular version of Python, plus a " +"number of additional packages." msgstr "" #: ../../tutorial/venv.rst:27 msgid "" -"Different applications can then use different virtual environments. To " -"resolve the earlier example of conflicting requirements, application A can " -"have its own virtual environment with version 1.0 installed while " -"application B has another virtual environment with version 2.0. If " -"application B requires a library be upgraded to version 3.0, this will not " -"affect application A's environment." +"Different applications can then use different virtual environments. To resolve the earlier " +"example of conflicting requirements, application A can have its own virtual environment with " +"version 1.0 installed while application B has another virtual environment with version 2.0. If " +"application B requires a library be upgraded to version 3.0, this will not affect application A's " +"environment." msgstr "" #: ../../tutorial/venv.rst:36 @@ -72,74 +68,85 @@ msgstr "" #: ../../tutorial/venv.rst:38 msgid "" -"The module used to create and manage virtual environments is " -"called :mod:`venv`. :mod:`venv` will install the Python version from which " -"the command was run (as reported by the :option:`--version` option). For " -"instance, executing the command with ``python3.12`` will install version " +"The module used to create and manage virtual environments is called :mod:`venv`. :mod:`venv` " +"will install the Python version from which the command was run (as reported by the :option:`--" +"version` option). For instance, executing the command with ``python3.12`` will install version " "3.12." msgstr "" +"ماژولی که برای ایجاد و مدیریت محیط‌های مجازی استفاده می‌شود، :mod:`venv` نام دارد. " +"ماژول :mod:`venv` همان نسخه‌ای از پایتون را نصب می‌کند که دستور با آن اجرا شده است (همان‌طور که با " +"گزینهٔ :option:`--version` گزارش می‌شود). برای مثال، اگر دستور را با ``python3.12`` اجرا کنید، نسخهٔ " +"3.12 نصب خواهد شد." #: ../../tutorial/venv.rst:44 msgid "" -"To create a virtual environment, decide upon a directory where you want to " -"place it, and run the :mod:`venv` module as a script with the directory " -"path::" +"To create a virtual environment, decide upon a directory where you want to place it, and run " +"the :mod:`venv` module as a script with the directory path::" msgstr "" +"برای ایجاد یک محیط مجازی، ابتدا دایرکتوری موردنظر خود را انتخاب کنید و سپس ماژول :mod:`venv` را " +"به‌صورت یک اسکریپت همراه با مسیر آن دایرکتوری اجرا کنید::" #: ../../tutorial/venv.rst:47 msgid "python -m venv tutorial-env" -msgstr "" +msgstr "python -m venv tutorial-env" #: ../../tutorial/venv.rst:49 msgid "" -"This will create the ``tutorial-env`` directory if it doesn't exist, and " -"also create directories inside it containing a copy of the Python " -"interpreter and various supporting files." +"This will create the ``tutorial-env`` directory if it doesn't exist, and also create directories " +"inside it containing a copy of the Python interpreter and various supporting files." msgstr "" +"اگر دایرکتوری ``tutorial-env`` وجود نداشته باشد، این دستور آن را ایجاد می‌کند و همچنین درون آن " +"دایرکتوری‌هایی شامل یک نسخه از مفسر پایتون و فایل‌های پشتیبان موردنیاز را می‌سازد." #: ../../tutorial/venv.rst:53 msgid "" -"A common directory location for a virtual environment is ``.venv``. This " -"name keeps the directory typically hidden in your shell and thus out of the " -"way while giving it a name that explains why the directory exists. It also " -"prevents clashing with ``.env`` environment variable definition files that " -"some tooling supports." +"A common directory location for a virtual environment is ``.venv``. This name keeps the directory " +"typically hidden in your shell and thus out of the way while giving it a name that explains why " +"the directory exists. It also prevents clashing with ``.env`` environment variable definition " +"files that some tooling supports." msgstr "" +"یکی از محل‌های رایج برای ایجاد محیط مجازی، دایرکتوری ``.venv`` است. این نام معمولاً باعث می‌شود " +"دایرکتوری در شل مخفی بماند و در عین حال به‌خوبی نشان دهد که دلیل وجود آن چیست. همچنین از تداخل با " +"فایل‌های تعریف متغیرهای محیطی ``.env`` که برخی ابزارها از آن‌ها پشتیبانی می‌کنند، جلوگیری می‌کند." #: ../../tutorial/venv.rst:59 msgid "Once you've created a virtual environment, you may activate it." -msgstr "" +msgstr "پس از ایجاد محیط مجازی، می‌توانید آن را فعال کنید." #: ../../tutorial/venv.rst:61 msgid "On Windows, run::" -msgstr "" +msgstr "در ویندوز، دستور زیر را اجرا کنید::" #: ../../tutorial/venv.rst:63 msgid "tutorial-env\\Scripts\\activate" -msgstr "" +msgstr "tutorial-env\\Scripts\\activate" #: ../../tutorial/venv.rst:65 msgid "On Unix or MacOS, run::" -msgstr "" +msgstr "در یونیکس یا macOS، دستور زیر را اجرا کنید::" #: ../../tutorial/venv.rst:67 msgid "source tutorial-env/bin/activate" -msgstr "" +msgstr "source tutorial-env/bin/activate" #: ../../tutorial/venv.rst:69 msgid "" -"(This script is written for the bash shell. If you use the :program:`csh` " -"or :program:`fish` shells, there are alternate ``activate.csh`` and " -"``activate.fish`` scripts you should use instead.)" +"(This script is written for the bash shell. If you use the :program:`csh` or :program:`fish` " +"shells, there are alternate ``activate.csh`` and ``activate.fish`` scripts you should use " +"instead.)" msgstr "" +"(این اسکریپت برای شل bash نوشته شده است. اگر از شل‌های :program:`csh` یا :program:`fish` استفاده " +"می‌کنید، باید به‌ترتیب از اسکریپت‌های ``activate.csh`` یا ``activate.fish`` استفاده کنید.)" #: ../../tutorial/venv.rst:74 msgid "" -"Activating the virtual environment will change your shell's prompt to show " -"what virtual environment you're using, and modify the environment so that " -"running ``python`` will get you that particular version and installation of " -"Python. For example:" +"Activating the virtual environment will change your shell's prompt to show what virtual " +"environment you're using, and modify the environment so that running ``python`` will get you that " +"particular version and installation of Python. For example:" msgstr "" +"با فعال کردن محیط مجازی، اعلان (prompt) شل تغییر می‌کند تا نشان دهد از کدام محیط مجازی استفاده " +"می‌کنید. همچنین محیط به‌گونه‌ای تنظیم می‌شود که با اجرای دستور ``python``، همان نسخه و نصب پایتون " +"مربوط به آن محیط مجازی اجرا شود. برای مثال:" #: ../../tutorial/venv.rst:79 msgid "" @@ -153,43 +160,54 @@ msgid "" "'~/envs/tutorial-env/lib/python3.5/site-packages']\n" ">>>" msgstr "" +"$ source ~/envs/tutorial-env/bin/activate\n" +"(tutorial-env) $ python\n" +"Python 3.5.1 (default, May 6 2016, 10:59:36)\n" +" ...\n" +">>> import sys\n" +">>> sys.path\n" +"['', '/usr/local/lib/python35.zip', ...,\n" +"'~/envs/tutorial-env/lib/python3.5/site-packages']\n" +">>>" #: ../../tutorial/venv.rst:91 msgid "To deactivate a virtual environment, type::" -msgstr "" +msgstr "برای غیرفعال کردن محیط مجازی، دستور زیر را وارد کنید::" #: ../../tutorial/venv.rst:93 msgid "deactivate" -msgstr "" +msgstr "deactivate" #: ../../tutorial/venv.rst:95 msgid "into the terminal." -msgstr "" +msgstr "در ترمینال." #: ../../tutorial/venv.rst:98 msgid "Managing Packages with pip" -msgstr "" +msgstr "مدیریت بسته‌ها با pip" #: ../../tutorial/venv.rst:100 msgid "" -"You can install, upgrade, and remove packages using a program " -"called :program:`pip`. By default ``pip`` will install packages from the " -"`Python Package Index `_. You can browse the Python " -"Package Index by going to it in your web browser." +"You can install, upgrade, and remove packages using a program called :program:`pip`. By default " +"``pip`` will install packages from the `Python Package Index `_. You can " +"browse the Python Package Index by going to it in your web browser." msgstr "" +"می‌توانید با استفاده از برنامه‌ای به نام :program:`pip` بسته‌ها را نصب، به‌روزرسانی و حذف کنید. به‌طور " +"پیش‌فرض، ``pip`` بسته‌ها را از `Python Package Index `_ نصب می‌کند. همچنین " +"می‌توانید با مراجعه به این وب‌سایت در مرورگر خود، بسته‌های موجود در Python Package Index را مرور " +"کنید." #: ../../tutorial/venv.rst:105 msgid "" -"``pip`` has a number of subcommands: \"install\", \"uninstall\", \"freeze\", " -"etc. (Consult the :ref:`installing-index` guide for complete documentation " -"for ``pip``.)" +"``pip`` has a number of subcommands: \"install\", \"uninstall\", \"freeze\", etc. (Consult " +"the :ref:`installing-index` guide for complete documentation for ``pip``.)" msgstr "" +"``pip`` دارای چندین زیرفرمان مانند «install»، «uninstall»، «freeze» و موارد دیگر است. (برای " +"مشاهدهٔ مستندات کامل ``pip`` به راهنمای :ref:`installing-index` مراجعه کنید.)" #: ../../tutorial/venv.rst:109 -msgid "" -"You can install the latest version of a package by specifying a package's " -"name:" -msgstr "" +msgid "You can install the latest version of a package by specifying a package's name:" +msgstr "می‌توانید با مشخص کردن نام یک بسته، آخرین نسخهٔ آن را نصب کنید:" #: ../../tutorial/venv.rst:111 msgid "" @@ -200,12 +218,18 @@ msgid "" " Running setup.py install for novas\n" "Successfully installed novas-3.1.1.3" msgstr "" +"(tutorial-env) $ python -m pip install novas\n" +"Collecting novas\n" +" Downloading novas-3.1.1.3.tar.gz (136kB)\n" +"Installing collected packages: novas\n" +" Running setup.py install for novas\n" +"Successfully installed novas-3.1.1.3" #: ../../tutorial/venv.rst:120 msgid "" -"You can also install a specific version of a package by giving the package " -"name followed by ``==`` and the version number:" -msgstr "" +"You can also install a specific version of a package by giving the package name followed by " +"``==`` and the version number:" +msgstr "همچنین می‌توانید با نوشتن نام بسته، سپس ``==`` و شمارهٔ نسخه، نسخهٔ مشخصی از آن را نصب کنید:" #: ../../tutorial/venv.rst:123 msgid "" @@ -215,14 +239,21 @@ msgid "" "Installing collected packages: requests\n" "Successfully installed requests-2.6.0" msgstr "" +"(tutorial-env) $ python -m pip install requests==2.6.0\n" +"Collecting requests==2.6.0\n" +" Using cached requests-2.6.0-py2.py3-none-any.whl\n" +"Installing collected packages: requests\n" +"Successfully installed requests-2.6.0" #: ../../tutorial/venv.rst:131 msgid "" -"If you re-run this command, ``pip`` will notice that the requested version " -"is already installed and do nothing. You can supply a different version " -"number to get that version, or you can run ``python -m pip install --" -"upgrade`` to upgrade the package to the latest version:" +"If you re-run this command, ``pip`` will notice that the requested version is already installed " +"and do nothing. You can supply a different version number to get that version, or you can run " +"``python -m pip install --upgrade`` to upgrade the package to the latest version:" msgstr "" +"اگر این دستور را دوباره اجرا کنید، ``pip`` تشخیص می‌دهد که نسخهٔ درخواستی از قبل نصب شده است و هیچ " +"کاری انجام نمی‌دهد. می‌توانید شمارهٔ نسخهٔ دیگری را مشخص کنید تا همان نسخه نصب شود، یا با اجرای " +"``python -m pip install --upgrade`` بسته را به آخرین نسخه ارتقا دهید:" #: ../../tutorial/venv.rst:136 msgid "" @@ -234,17 +265,25 @@ msgid "" " Successfully uninstalled requests-2.6.0\n" "Successfully installed requests-2.7.0" msgstr "" +"(tutorial-env) $ python -m pip install --upgrade requests\n" +"Collecting requests\n" +"Installing collected packages: requests\n" +" Found existing installation: requests 2.6.0\n" +" Uninstalling requests-2.6.0:\n" +" Successfully uninstalled requests-2.6.0\n" +"Successfully installed requests-2.7.0" #: ../../tutorial/venv.rst:146 msgid "" -"``python -m pip uninstall`` followed by one or more package names will " -"remove the packages from the virtual environment." +"``python -m pip uninstall`` followed by one or more package names will remove the packages from " +"the virtual environment." msgstr "" +"دستور ``python -m pip uninstall`` که پس از آن یک یا چند نام بسته آورده می‌شود، آن بسته‌ها را از " +"محیط مجازی حذف می‌کند." #: ../../tutorial/venv.rst:149 -msgid "" -"``python -m pip show`` will display information about a particular package:" -msgstr "" +msgid "``python -m pip show`` will display information about a particular package:" +msgstr "دستور ``python -m pip show`` اطلاعات مربوط به یک بستهٔ مشخص را نمایش می‌دهد:" #: ../../tutorial/venv.rst:151 msgid "" @@ -261,12 +300,23 @@ msgid "" "Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages\n" "Requires:" msgstr "" +"(tutorial-env) $ python -m pip show requests\n" +"---\n" +"Metadata-Version: 2.0\n" +"Name: requests\n" +"Version: 2.7.0\n" +"Summary: Python HTTP for Humans.\n" +"Home-page: http://python-requests.org\n" +"Author: Kenneth Reitz\n" +"Author-email: me@kennethreitz.com\n" +"License: Apache 2.0\n" +"Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages\n" +"Requires:" #: ../../tutorial/venv.rst:166 msgid "" -"``python -m pip list`` will display all of the packages installed in the " -"virtual environment:" -msgstr "" +"``python -m pip list`` will display all of the packages installed in the virtual environment:" +msgstr "دستور ``python -m pip list`` فهرست تمام بسته‌های نصب‌شده در محیط مجازی را نمایش می‌دهد:" #: ../../tutorial/venv.rst:169 msgid "" @@ -277,14 +327,22 @@ msgid "" "requests (2.7.0)\n" "setuptools (16.0)" msgstr "" +"(tutorial-env) $ python -m pip list\n" +"novas (3.1.1.3)\n" +"numpy (1.9.2)\n" +"pip (7.0.3)\n" +"requests (2.7.0)\n" +"setuptools (16.0)" #: ../../tutorial/venv.rst:178 msgid "" -"``python -m pip freeze`` will produce a similar list of the installed " -"packages, but the output uses the format that ``python -m pip install`` " -"expects. A common convention is to put this list in a ``requirements.txt`` " -"file:" +"``python -m pip freeze`` will produce a similar list of the installed packages, but the output " +"uses the format that ``python -m pip install`` expects. A common convention is to put this list " +"in a ``requirements.txt`` file:" msgstr "" +"دستور ``python -m pip freeze`` نیز فهرستی مشابه از بسته‌های نصب‌شده تولید می‌کند، اما خروجی آن در " +"قالبی است که دستور ``python -m pip install`` انتظار دارد. معمولاً این فهرست را در فایلی با نام " +"``requirements.txt`` ذخیره می‌کنند:" #: ../../tutorial/venv.rst:182 msgid "" @@ -294,13 +352,20 @@ msgid "" "numpy==1.9.2\n" "requests==2.7.0" msgstr "" +"(tutorial-env) $ python -m pip freeze > requirements.txt\n" +"(tutorial-env) $ cat requirements.txt\n" +"novas==3.1.1.3\n" +"numpy==1.9.2\n" +"requests==2.7.0" #: ../../tutorial/venv.rst:190 msgid "" -"The ``requirements.txt`` can then be committed to version control and " -"shipped as part of an application. Users can then install all the necessary " -"packages with ``install -r``:" +"The ``requirements.txt`` can then be committed to version control and shipped as part of an " +"application. Users can then install all the necessary packages with ``install -r``:" msgstr "" +"سپس می‌توان فایل ``requirements.txt`` را در سامانهٔ کنترل نسخه ثبت (commit) کرد و همراه با برنامه " +"منتشر نمود. در این صورت، کاربران می‌توانند با استفاده از ``install -r`` تمام بسته‌های موردنیاز را " +"نصب کنند:" #: ../../tutorial/venv.rst:194 msgid "" @@ -315,11 +380,23 @@ msgid "" " Running setup.py install for novas\n" "Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0" msgstr "" +"(tutorial-env) $ python -m pip install -r requirements.txt\n" +"Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))\n" +" ...\n" +"Collecting numpy==1.9.2 (from -r requirements.txt (line 2))\n" +" ...\n" +"Collecting requests==2.7.0 (from -r requirements.txt (line 3))\n" +" ...\n" +"Installing collected packages: novas, numpy, requests\n" +" Running setup.py install for novas\n" +"Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0" #: ../../tutorial/venv.rst:207 msgid "" -"``pip`` has many more options. Consult the :ref:`installing-index` guide " -"for complete documentation for ``pip``. When you've written a package and " -"want to make it available on the Python Package Index, consult the `Python " -"packaging user guide`_." +"``pip`` has many more options. Consult the :ref:`installing-index` guide for complete " +"documentation for ``pip``. When you've written a package and want to make it available on the " +"Python Package Index, consult the `Python packaging user guide`_." msgstr "" +"``pip`` گزینه‌های بسیار بیشتری نیز دارد. برای مطالعهٔ مستندات کامل ``pip``، به راهنمای :ref:`installing-" +"index` مراجعه کنید. همچنین، اگر بسته‌ای نوشته‌اید و می‌خواهید آن را در Python Package Index منتشر " +"کنید، به `Python packaging user guide`_ مراجعه کنید."