Apply suggestions from code review

Dr-XYZ · mattwang44 · web-flow · commit 7624aa3dd067 · 2025-05-26T09:36:22.000+08:00
Co-authored-by: W. H. Wang &lt;mattwang44@gmail.com&gt;
diff --git a/library/venv.po b/library/venv.po
@@ -2,6 +2,7 @@
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
+# Po-Chuan Chen <present90308@gmail.com>, 2023
 # Dr-XYZ <dr.xyz.tw@gmail.com>, 2025
 msgid ""
 msgstr ""
@@ -72,7 +73,7 @@ msgid ""
 "project directory, or under a container directory for lots of virtual "
 "environments, such as ``~/.virtualenvs``."
 msgstr ""
-"儲存在一個目錄中，通常命名為專案目錄下的 ``.venv`` 或 ``venv``，也可能是在用"
+"被包含在一個目錄中，通常命名為專案目錄下的 ``.venv`` 或 ``venv``，也可能是在用"
 "來管理多個虛擬環境的容器目錄中，例如 ``~/.virtualenvs``。"
 
 #: ../../library/venv.rst:44
@@ -614,7 +615,7 @@ msgid ""
 "method named ``create_{scm}_ignore_file``. The only value supported by "
 "default is ``\"git\"`` via :meth:`create_git_ignore_file`."
 msgstr ""
-"*scm_ignore_files*——根據可疊代物件中指定的原始碼控制系統（SCM），建立對應的忽"
+"*scm_ignore_files*——根據可疊代物件中指定的來源控制管理（SCM），建立對應的忽"
 "略檔。支援情況取決於是否有名為 ``create_{scm}_ignore_file`` 的方法。預設唯一"
 "支援的值是 ``\"git\"``，透過 :meth:`create_git_ignore_file` 方法提供支援。"
 
@@ -673,8 +674,8 @@ msgid ""
 msgstr ""
 "def create(self, env_dir):\n"
 "    \"\"\"\n"
-"    Create a virtualized Python environment in a directory.\n"
-"    env_dir is the target directory to create an environment in.\n"
+"    在目標目錄中建立一個虛擬化的 Python 環境。\n"
+"    env_dir 是要建立虛擬環境的目標目錄。\n"
 "    \"\"\"\n"
 "    env_dir = os.path.abspath(env_dir)\n"
 "    context = self.ensure_directories(env_dir)\n"
@@ -719,15 +720,15 @@ msgid ""
 "``env_dir`` - The location of the virtual environment. Used for "
 "``__VENV_DIR__`` in activation scripts (see :meth:`install_scripts`)."
 msgstr ""
-"``env_dir`` —— 虛擬環境的位置。用於啟用腳本中的 ``__VENV_DIR__``（參見 :meth:"
+"``env_dir`` —— 虛擬環境的位置。用於啟用腳本中的 ``__VENV_DIR__``\\ （參見 :meth:"
 "`install_scripts`）。"
 
 #: ../../library/venv.rst:377
 msgid ""
 "``env_name`` - The name of the virtual environment. Used for "
 "``__VENV_NAME__`` in activation scripts (see :meth:`install_scripts`)."
 msgstr ""
-"``env_name`` —— 虛擬環境的名稱。用於啟用腳本中的 ``__VENV_NAME__``（參見 :"
+"``env_name`` —— 虛擬環境的名稱。用於啟用腳本中的 ``__VENV_NAME__``\\ （參見 :"
 "meth:`install_scripts`）。"
 
 #: ../../library/venv.rst:380
@@ -736,7 +737,7 @@ msgid ""
 "``__VENV_PROMPT__`` in activation scripts (see :meth:`install_scripts`)."
 msgstr ""
 "``prompt`` —— 啟用腳本所使用的提示字元。用於啟用腳本中的 "
-"``__VENV_PROMPT__``（參見 :meth:`install_scripts`）。"
+"``__VENV_PROMPT__``\\ （參見 :meth:`install_scripts`）。"
 
 #: ../../library/venv.rst:383
 msgid ""
@@ -798,7 +799,7 @@ msgstr ""
 msgid ""
 "The attribute ``lib_path`` was added to the context, and the context object "
 "was documented."
-msgstr "``lib_path`` 屬性已新增至上下文中，且上下文物件已加入文件說明。"
+msgstr "``lib_path`` 屬性已新增至情境中，且情境物件已加入文件說明。"
 
 #: ../../library/venv.rst:417
 msgid "Creates the ``pyvenv.cfg`` configuration file in the environment."
@@ -970,7 +971,7 @@ msgid ""
 "environment::"
 msgstr ""
 "以下的腳本展示了如何透過實作子類別來擴充 :class:`EnvBuilder`，並在建立的虛擬"
-"環境中安裝 setuptools 與 pip::"
+"環境中安裝 setuptools 與 pip： ::"
 
 #: ../../library/venv.rst:524
 msgid ""
@@ -1198,28 +1199,22 @@ msgstr ""
 "\n"
 "class ExtendedEnvBuilder(venv.EnvBuilder):\n"
 "    \"\"\"\n"
-"    This builder installs setuptools and pip so that you can pip or\n"
-"    easy_install other packages into the created virtual environment.\n"
+"    此建構子會安裝 setuptools 和 pip，使你能夠使用 pip 或\n"
+"    easy_install 安裝其他套件到建立的虛擬環境中。\n"
 "\n"
-"    :param nodist: If true, setuptools and pip are not installed into the\n"
-"                   created virtual environment.\n"
-"    :param nopip: If true, pip is not installed into the created\n"
-"                  virtual environment.\n"
-"    :param progress: If setuptools or pip are installed, the progress of "
-"the\n"
-"                     installation can be monitored by passing a progress\n"
-"                     callable. If specified, it is called with two\n"
-"                     arguments: a string indicating some progress, and a\n"
-"                     context indicating where the string is coming from.\n"
-"                     The context argument can have one of three values:\n"
-"                     'main', indicating that it is called from virtualize()\n"
-"                     itself, and 'stdout' and 'stderr', which are obtained\n"
-"                     by reading lines from the output streams of a "
-"subprocess\n"
-"                     which is used to install the app.\n"
+"    :param nodist: 若為 true，則不會安裝 setuptools 和 pip 至\n"
+"                   所建立的虛擬環境中。\n"
+"    :param nopip: 若為 true，則不會安裝 pip 至所建立的\n"
+"                  虛擬環境中。\n"
+"    :param progress: 若安裝了 setuptools 或 pip，可透過傳入 progress\n"
+"                     可呼叫物件來監控安裝進度。若有指定，該可呼叫物件會接收兩個參數：\n"
+"                     一個表示進度的字串，以及一個表示該字串來源的情境。\n"
+"                     context 參數可能有三種值：\n"
+"                     'main' 表示該呼叫來自 virtualize() 本身，\n"
+"                     'stdout' 與 'stderr' 則分別表示從子行程輸出資料流中\n"
+"                     讀取的輸出內容，該子行程用於安裝應用程式。\n"
 "\n"
-"                     If a callable is not specified, default progress\n"
-"                     information is output to sys.stderr.\n"
+"                     若未指定可呼叫物件，則預設的進度資訊會輸出至 sys.stderr。\n"
 "    \"\"\"\n"
 "\n"
 "    def __init__(self, *args, **kwargs):\n"
@@ -1231,11 +1226,9 @@ msgstr ""
 "\n"
 "    def post_setup(self, context):\n"
 "        \"\"\"\n"
-"        Set up any packages which need to be pre-installed into the\n"
-"        virtual environment being created.\n"
+"        設定在建立虛擬環境時需預先安裝的套件。\n"
 "\n"
-"        :param context: The information for the virtual environment\n"
-"                        creation request being processed.\n"
+"        :param context: 處理中的虛擬環境建立請求所需的資訊。\n"
 "        \"\"\"\n"
 "        os.environ['VIRTUAL_ENV'] = context.env_dir\n"
 "        if not self.nodist:\n"
@@ -1246,10 +1239,7 @@ msgstr ""
 "\n"
 "    def reader(self, stream, context):\n"
 "        \"\"\"\n"
-"        Read lines from a subprocess' output stream and either pass to a "
-"progress\n"
-"        callable (if specified) or write progress information to sys."
-"stderr.\n"
+"        從子行程的輸出串流中讀取每一列，並將其傳遞給進度回呼函式（若有指定），或將進度資訊寫入 sys.stderr。\n"
 "        \"\"\"\n"
 "        progress = self.progress\n"
 "        while True:\n"
@@ -1319,10 +1309,9 @@ msgstr ""
 "\n"
 "    def install_pip(self, context):\n"
 "        \"\"\"\n"
-"        Install pip in the virtual environment.\n"
+"        在虛擬環境中安裝 pip。\n"
 "\n"
-"        :param context: The information for the virtual environment\n"
-"                        creation request being processed.\n"
+"        :param context: 處理中的虛擬環境建立請求相關資訊。\n"
 "        \"\"\"\n"
 "        url = 'https://bootstrap.pypa.io/get-pip.py'\n"
 "        self.install_script(context, 'pip', url)\n"
@@ -1404,7 +1393,7 @@ msgstr ""
 msgid ""
 "This script is also available for download `online <https://gist.github.com/"
 "vsajip/4673395>`_."
-msgstr "此腳本也可從 `線上 <https://gist.github.com/vsajip/4673395>`_ 下載。"
+msgstr "此腳本也可從\\ `線上 <https://gist.github.com/vsajip/4673395>`_\\ 下載。"
 
 #: ../../library/venv.rst:14
 msgid "Environments"
