sync with cpython ba6d956e

Author: github-actions[bot]

library/glob.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-23 07:52+0800\n"
+"POT-Creation-Date: 2025-10-21 00:14+0000\n"
 "PO-Revision-Date: 2023-01-24 01:21+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -28,10 +28,10 @@ msgid "**Source code:** :source:`Lib/glob.py`"
 msgstr "**原始碼：**\\ :source:`Lib/glob.py`"
 
 #: ../../library/glob.rst:21
+#, fuzzy
 msgid ""
-"The :mod:`glob` module finds all the pathnames matching a specified pattern "
-"according to the rules used by the Unix shell, although results are returned "
-"in arbitrary order.  No tilde expansion is done, but ``*``, ``?``, and "
+"The :mod:`!glob` module finds pathnames using pattern matching rules similar "
+"to the Unix shell. No tilde expansion is done, but ``*``, ``?``, and "
 "character ranges expressed with ``[]`` will be correctly matched.  This is "
 "done by using the :func:`os.scandir` and :func:`fnmatch.fnmatch` functions "
 "in concert, and not by actually invoking a subshell."
@@ -41,30 +41,38 @@ msgstr ""
 "示的字元範圍將被正確匹配。這是透過同時使用 :func:`os.scandir` 和 :func:"
 "`fnmatch.fnmatch` 函式來完成的，而沒有實際呼叫 subshell。"
 
-#: ../../library/glob.rst:28
+#: ../../library/glob.rst:29
 msgid ""
-"Note that files beginning with a dot (``.``) can only be matched by patterns "
-"that also start with a dot, unlike :func:`fnmatch.fnmatch` or :func:`pathlib."
-"Path.glob`. (For tilde and shell variable expansion, use :func:`os.path."
-"expanduser` and :func:`os.path.expandvars`.)"
+"The pathnames are returned in no particular order.  If you need a specific "
+"order, sort the results."
+msgstr ""
+
+#: ../../library/glob.rst:32
+#, fuzzy
+msgid ""
+"Files beginning with a dot (``.``) can only be matched by patterns that also "
+"start with a dot, unlike :func:`fnmatch.fnmatch` or :func:`pathlib.Path."
+"glob`. For tilde and shell variable expansion, use :func:`os.path."
+"expanduser` and :func:`os.path.expandvars`."
 msgstr ""
 "請注意，以點 (``.``) 開頭的檔案只能與同樣以點開頭的模式匹配，這與 :func:"
 "`fnmatch.fnmatch` 或 :func:`pathlib.Path.glob` 不同。（對於波浪號和 shell 變"
 "數擴展，請使用 :func:`os.path.expanduser` 和 :func:`os.path.expandvars`。）"
 
-#: ../../library/glob.rst:34
+#: ../../library/glob.rst:38
 msgid ""
 "For a literal match, wrap the meta-characters in brackets. For example, "
 "``'[?]'`` matches the character ``'?'``."
 msgstr ""
 "對於文本 (literal) 匹配，將元字元 (meta-character) 括在方括號中。例如，"
 "``'[?]'`` 會匹配 ``'?'`` 字元。"
 
-#: ../../library/glob.rst:37
-msgid "The :mod:`glob` module defines the following functions:"
+#: ../../library/glob.rst:41
+#, fuzzy
+msgid "The :mod:`!glob` module defines the following functions:"
 msgstr ":mod:`glob` 模組定義了以下函式："
 
-#: ../../library/glob.rst:43
+#: ../../library/glob.rst:47
 msgid ""
 "Return a possibly empty list of path names that match *pathname*, which must "
 "be a string containing a path specification. *pathname* can be either "
@@ -82,25 +90,26 @@ msgstr ""
 "取決於檔案系統 (file system)。如果在呼叫此函式期間刪除或新增滿足條件的檔案，"
 "則結果不一定會包含該檔案的路徑名稱。"
 
-#: ../../library/glob.rst:52
+#: ../../library/glob.rst:56
+#, fuzzy
 msgid ""
 "If *root_dir* is not ``None``, it should be a :term:`path-like object` "
 "specifying the root directory for searching.  It has the same effect on :"
-"func:`glob` as changing the current directory before calling it.  If "
+"func:`!glob` as changing the current directory before calling it.  If "
 "*pathname* is relative, the result will contain paths relative to *root_dir*."
 msgstr ""
 "如果 *root_dir* 不是 ``None``，它應該是一個指定搜尋根目錄的 :term:`path-like "
 "object`。它在呼叫它之前更改目前目錄的影響與 :func:`glob` 相同。如果 "
 "*pathname* 是相對的，結果將包含相對於 *root_dir* 的路徑。"
 
-#: ../../library/glob.rst:58
+#: ../../library/glob.rst:62
 msgid ""
 "This function can support :ref:`paths relative to directory descriptors "
 "<dir_fd>` with the *dir_fd* parameter."
 msgstr ""
 "此函式可以支援以 *dir_fd* 參數使用\\ :ref:`相對目錄描述器的路徑 <dir_fd>`。"
 
-#: ../../library/glob.rst:64
+#: ../../library/glob.rst:68
 msgid ""
 "If *recursive* is true, the pattern \"``**``\" will match any files and zero "
 "or more directories, subdirectories and symbolic links to directories. If "
@@ -111,61 +120,61 @@ msgstr ""
 "和目錄的符號連結。如果模式後面有 :data:`os.sep` 或 :data:`os.altsep` 那麼檔案"
 "將不會被匹配。"
 
-#: ../../library/glob.rst:69
+#: ../../library/glob.rst:73
 msgid ""
 "If *include_hidden* is true, \"``**``\" pattern will match hidden "
 "directories."
 msgstr "如果 *include_hidden* 為真，\"``**``\" 模式將匹配被隱藏的目錄。"
 
-#: ../../library/glob.rst:71 ../../library/glob.rst:98
+#: ../../library/glob.rst:75 ../../library/glob.rst:102
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``glob.glob`` with arguments "
 "``pathname``, ``recursive``."
 msgstr ""
 "引發一個附帶引數 ``pathname``、``recursive`` 的\\ :ref:`稽核事件 <auditing>` "
 "``glob.glob``。"
 
-#: ../../library/glob.rst:72 ../../library/glob.rst:99
+#: ../../library/glob.rst:76 ../../library/glob.rst:103
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``glob.glob/2`` with arguments "
 "``pathname``, ``recursive``, ``root_dir``, ``dir_fd``."
 msgstr ""
 "引發一個附帶引數 ``pathname``、``recursive``、``root_dir``、``dir_fd`` 的\\ :"
 "ref:`稽核事件 <auditing>` ``glob.glob/2``。"
 
-#: ../../library/glob.rst:75
+#: ../../library/glob.rst:79
 msgid ""
 "Using the \"``**``\" pattern in large directory trees may consume an "
 "inordinate amount of time."
 msgstr "在大型目錄樹中使用 \"``**``\" 模式可能會消耗過多的時間。"
 
-#: ../../library/glob.rst:79 ../../library/glob.rst:102
+#: ../../library/glob.rst:83 ../../library/glob.rst:106
 msgid ""
 "This function may return duplicate path names if *pathname* contains "
 "multiple \"``**``\" patterns and *recursive* is true."
 msgstr ""
 
-#: ../../library/glob.rst:82 ../../library/glob.rst:105
+#: ../../library/glob.rst:86 ../../library/glob.rst:109
 msgid "Support for recursive globs using \"``**``\"."
 msgstr "支援以 \"``**``\" 使用遞迴 glob。"
 
-#: ../../library/glob.rst:85 ../../library/glob.rst:108
+#: ../../library/glob.rst:89 ../../library/glob.rst:112
 msgid "Added the *root_dir* and *dir_fd* parameters."
 msgstr "新增 *root_dir* 與 *dir_fd* 參數。"
 
-#: ../../library/glob.rst:88 ../../library/glob.rst:111
+#: ../../library/glob.rst:92 ../../library/glob.rst:115
 msgid "Added the *include_hidden* parameter."
 msgstr "新增 *include_hidden* 參數。"
 
-#: ../../library/glob.rst:95
+#: ../../library/glob.rst:99
 msgid ""
 "Return an :term:`iterator` which yields the same values as :func:`glob` "
 "without actually storing them all simultaneously."
 msgstr ""
 "回傳一個會產生與 :func:`glob` 相同的值的 :term:`iterator` ，而不是同時儲存全"
 "部的值。"
 
-#: ../../library/glob.rst:117
+#: ../../library/glob.rst:121
 msgid ""
 "Escape all special characters (``'?'``, ``'*'`` and ``'['``). This is useful "
 "if you want to match an arbitrary literal string that may have special "
@@ -178,52 +187,52 @@ msgstr ""
 "(sharepoints) 中的特殊字元不會被跳脫，例如在 Windows 上，``escape('//?/c:/"
 "Quo vadis?.txt')`` 會回傳 ``'//?/c:/Quo vadis[?].txt'``。"
 
-#: ../../library/glob.rst:128
+#: ../../library/glob.rst:132
 msgid ""
 "Convert the given path specification to a regular expression for use with :"
 "func:`re.match`. The path specification can contain shell-style wildcards."
 msgstr ""
 
-#: ../../library/glob.rst:131
+#: ../../library/glob.rst:135
 msgid "For example:"
 msgstr "舉例來說："
 
-#: ../../library/glob.rst:142
+#: ../../library/glob.rst:146
 msgid ""
 "Path separators and segments are meaningful to this function, unlike :func:"
 "`fnmatch.translate`. By default wildcards do not match path separators, and "
 "``*`` pattern segments match precisely one path segment."
 msgstr ""
 
-#: ../../library/glob.rst:146
+#: ../../library/glob.rst:150
 msgid ""
 "If *recursive* is true, the pattern segment \"``**``\" will match any number "
 "of path segments."
 msgstr ""
 
-#: ../../library/glob.rst:149
+#: ../../library/glob.rst:153
 msgid ""
 "If *include_hidden* is true, wildcards can match path segments that start "
 "with a dot (``.``)."
 msgstr ""
 
-#: ../../library/glob.rst:152
+#: ../../library/glob.rst:156
 msgid ""
 "A sequence of path separators may be supplied to the *seps* argument. If not "
 "given, :data:`os.sep` and :data:`~os.altsep` (if available) are used."
 msgstr ""
 
-#: ../../library/glob.rst:157
+#: ../../library/glob.rst:161
 msgid ""
 ":meth:`pathlib.PurePath.full_match` and :meth:`pathlib.Path.glob` methods, "
 "which call this function to implement pattern matching and globbing."
 msgstr ""
 
-#: ../../library/glob.rst:165
+#: ../../library/glob.rst:169
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/glob.rst:167
+#: ../../library/glob.rst:171
 msgid ""
 "Consider a directory containing the following files: :file:`1.gif`, :file:`2."
 "txt`, :file:`card.gif` and a subdirectory :file:`sub` which contains only "
@@ -234,7 +243,7 @@ msgstr ""
 "gif`，和一個僅包含 :file:`3.txt` 檔案的子目錄 :file:`sub`，:func:`glob` 將產"
 "生以下結果。請注意路徑的任何前導部分是如何保留的。 ::"
 
-#: ../../library/glob.rst:173
+#: ../../library/glob.rst:177
 msgid ""
 ">>> import glob\n"
 ">>> glob.glob('./[0-9].*')\n"
@@ -260,7 +269,7 @@ msgstr ""
 ">>> glob.glob('./**/', recursive=True)\n"
 "['./', './sub/']"
 
-#: ../../library/glob.rst:185
+#: ../../library/glob.rst:189
 msgid ""
 "If the directory contains files starting with ``.`` they won't be matched by "
 "default. For example, consider a directory containing :file:`card.gif` and :"
@@ -269,7 +278,7 @@ msgstr ""
 "如果目錄包含以 ``.`` 開頭的檔案，則預設情況下不會去匹配到它們。例如，一個包"
 "含 :file:`card.gif` 和 :file:`.card.gif` 的目錄： ::"
 
-#: ../../library/glob.rst:189
+#: ../../library/glob.rst:193
 msgid ""
 ">>> import glob\n"
 ">>> glob.glob('*.gif')\n"
@@ -283,12 +292,12 @@ msgstr ""
 ">>> glob.glob('.c*')\n"
 "['.card.gif']"
 
-#: ../../library/glob.rst:196
+#: ../../library/glob.rst:200
 msgid ""
 "The :mod:`fnmatch` module offers shell-style filename (not path) expansion."
 msgstr ":mod:`fnmatch` 模組提供了 shell 風格檔案名（不是路徑）的擴展"
 
-#: ../../library/glob.rst:199
+#: ../../library/glob.rst:203
 msgid "The :mod:`pathlib` module offers high-level path objects."
 msgstr ":mod:`pathlib` 模組提供高階路徑物件。"
 
@@ -304,7 +313,7 @@ msgstr "pathname expansion（路徑名稱展開）"
 msgid "* (asterisk)"
 msgstr "* （星號）"
 
-#: ../../library/glob.rst:13 ../../library/glob.rst:61
+#: ../../library/glob.rst:13 ../../library/glob.rst:65
 msgid "in glob-style wildcards"
 msgstr "於 glob 風格的萬用字元中"
 
@@ -328,6 +337,6 @@ msgstr "- （減號）"
 msgid ". (dot)"
 msgstr ". （點）"
 
-#: ../../library/glob.rst:61
+#: ../../library/glob.rst:65
 msgid "**"
 msgstr "**"