From 5724664ebd9927123a1b009e0825ddc637745803 Mon Sep 17 00:00:00 2001
From: Payon <ken71301@hotmail.com>
Date: Wed, 11 Dec 2024 21:56:52 +0800
Subject: [PATCH 1/2] feat: to rst:600

fix: inconsistent_reference

fix: inconsistent_reference
---
 reference/import.po | 36 ++++++++++++++++++++++++++++++------
 1 file changed, 30 insertions(+), 6 deletions(-)

diff --git a/reference/import.po b/reference/import.po
index 54ab4c6fff..733fe39958 100644
--- a/reference/import.po
+++ b/reference/import.po
@@ -7,7 +7,7 @@ msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-09-03 11:11+0800\n"
-"PO-Revision-Date: 2024-11-06 14:55+0800\n"
+"PO-Revision-Date: 2024-12-11 22:16+0800\n"
 "Last-Translator: Ken Cheng <ken71301@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -1007,7 +1007,7 @@ msgstr ""
 
 #: ../../reference/import.rst:546
 msgid "__path__ attributes on modules"
-msgstr ""
+msgstr "模組上的 __path__ 屬性"
 
 #: ../../reference/import.rst:548
 msgid ""
@@ -1016,6 +1016,9 @@ msgid ""
 "submodules will be found. By definition, if a module has a :attr:`!__path__` "
 "attribute, it is a :term:`package`."
 msgstr ""
+":attr:`~module.__path__` 屬性應該是一個（可能為空的）\\ :term:`sequence`，其"
+"包含列舉套件子模組位置的字串。根據定義，如果一個模組有 :attr:`!__path__` 屬"
+"性，那麼它就是一個 :term:`package`。"
 
 #: ../../reference/import.rst:553
 msgid ""
@@ -1025,6 +1028,9 @@ msgid ""
 "during import. However, :attr:`!__path__` is typically much more constrained "
 "than :data:`!sys.path`."
 msgstr ""
+"套件的 :attr:`~module.__path__` 屬性在引入其子套件時被使用。在引入機制中，其"
+"功能與 :data:`sys.path` 類似，即提供在引入期間搜尋模組的位置串列。然而，:"
+"attr:`!__path__` 通常比 :data:`!sys.path` 更受限制。"
 
 #: ../../reference/import.rst:560
 msgid ""
@@ -1032,6 +1038,8 @@ msgid ""
 "__path__`. :data:`sys.path_hooks` (described below) are consulted when "
 "traversing a package's :attr:`!__path__`."
 msgstr ""
+":data:`sys.path` 適用的規則同樣也適用於套件的 :attr:`!__path__`。 :data:`sys."
+"path_hooks` 會在遍歷套件的 :attr:`!__path__` 時被參考（於後文詳述）。"
 
 #: ../../reference/import.rst:564
 msgid ""
@@ -1042,10 +1050,14 @@ msgid ""
 "containing only :attr:`!__path__` manipulation code; the import machinery "
 "automatically sets :attr:`!__path__` correctly for the namespace package."
 msgstr ""
+"套件的 ``__init__.py`` 檔案可以設定或修改套件的 :attr:`~module.__path__` 屬"
+"性，這通常是 :pep:`420` 之前實作命名空間套件的方式。隨著 :pep:`420` 的採用，"
+"命名空間套件不再需要提供僅包含 :attr:`!__path__` 操作程式碼的 ``__init__."
+"py`` 檔案；引入機制會自動為命名空間套件正確地設定 :attr:`!__path__`。"
 
 #: ../../reference/import.rst:573
 msgid "Module reprs"
-msgstr ""
+msgstr "模組的 reprs"
 
 #: ../../reference/import.rst:575
 msgid ""
@@ -1053,6 +1065,8 @@ msgid ""
 "attributes set above, and in the module's spec, you can more explicitly "
 "control the repr of module objects."
 msgstr ""
+"預設情況下，所有模組都有可用的 repr，然而，根據上述設定及模組規格中的屬性，你"
+"可以更明確地控制模組物件的 repr。"
 
 #: ../../reference/import.rst:579
 msgid ""
@@ -1063,10 +1077,14 @@ msgid ""
 "__file__``, and ``module.__loader__`` as input into the repr, with defaults "
 "for whatever information is missing."
 msgstr ""
+"如果模組具有規格（\\ ``__spec__``\\ ），引入機制將嘗試從規格中產生 repr。如果"
+"失敗或沒有規格，引入系統將使用模組上可用的資訊製作一個預設的 repr。它會嘗試使"
+"用 ``module.__name__``、``module.__file__`` 和 ``module.__loader__`` 作為 "
+"repr 的輸入，並為缺少的資訊提供預設值。"
 
 #: ../../reference/import.rst:586
 msgid "Here are the exact rules used:"
-msgstr ""
+msgstr "以下是具體的使用規則："
 
 #: ../../reference/import.rst:588
 msgid ""
@@ -1074,22 +1092,26 @@ msgid ""
 "used to generate the repr.  The \"name\", \"loader\", \"origin\", and "
 "\"has_location\" attributes are consulted."
 msgstr ""
+"如果模組具有 ``__spec__`` 屬性，則使用規格中的資訊產生 repr。會參考 "
+"\"name\"、\"loader\"、\"origin\" 和 \"has_location\" 屬性。"
 
 #: ../../reference/import.rst:592
 msgid ""
 "If the module has a ``__file__`` attribute, this is used as part of the "
 "module's repr."
-msgstr ""
+msgstr "如果模組具有 ``__file__`` 屬性，則會將其作為模組 repr 的一部分。"
 
 #: ../../reference/import.rst:595
 msgid ""
 "If the module has no ``__file__`` but does have a ``__loader__`` that is not "
 "``None``, then the loader's repr is used as part of the module's repr."
 msgstr ""
+"如果模組沒有 ``__file__`` 但有一個不為 ``None`` 的 ``__loader__`` ，則會將載"
+"入器的 repr 作為模組 repr 的一部分。"
 
 #: ../../reference/import.rst:598
 msgid "Otherwise, just use the module's ``__name__`` in the repr."
-msgstr ""
+msgstr "否則，在 repr 中只使用模組的 ``__name__``。"
 
 #: ../../reference/import.rst:600
 msgid ""
@@ -1097,6 +1119,8 @@ msgid ""
 "removed in Python 3.12 and is no longer called during the resolution of a "
 "module's repr."
 msgstr ""
+":meth:`!module_repr` 自 Python 3.4 起被棄用，並在 Python 3.12 中移除，且不會"
+"在解析模組的 repr 時被呼叫。"
 
 #: ../../reference/import.rst:608
 msgid "Cached bytecode invalidation"

From 459bda305441c957d3d38df96bccdceff8247949 Mon Sep 17 00:00:00 2001
From: Payon <ken71301@hotmail.com>
Date: Mon, 23 Dec 2024 15:35:03 +0800
Subject: [PATCH 2/2] =?UTF-8?q?feat:=20to:=20/import.rst:676=20-=20rst:668?=
 =?UTF-8?q?=20=E7=9A=84=20key-off=20=E5=AF=A6=E9=9A=9B=E7=9A=84=E6=84=8F?=
 =?UTF-8?q?=E6=80=9D=E5=8F=AF=E4=BB=A5=E8=A8=8E=E8=AB=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/import.po | 44 +++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 41 insertions(+), 3 deletions(-)

diff --git a/reference/import.po b/reference/import.po
index 733fe39958..8c4c9b23bb 100644
--- a/reference/import.po
+++ b/reference/import.po
@@ -7,7 +7,7 @@ msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-09-03 11:11+0800\n"
-"PO-Revision-Date: 2024-12-11 22:16+0800\n"
+"PO-Revision-Date: 2024-12-23 15:33+0800\n"
 "Last-Translator: Ken Cheng <ken71301@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -1124,7 +1124,7 @@ msgstr ""
 
 #: ../../reference/import.rst:608
 msgid "Cached bytecode invalidation"
-msgstr ""
+msgstr "被快取的位元組碼的無效化"
 
 #: ../../reference/import.rst:610
 msgid ""
@@ -1135,6 +1135,10 @@ msgid ""
 "cache file by checking the stored metadata in the cache file against the "
 "source's metadata."
 msgstr ""
+"在 Python 從 ``.pyc`` 檔案載入被快取的位元組碼之前，會檢查該快取是否與來源的 "
+"``.py`` 檔案保持同步。預設情況下，Python 透過在寫入快取檔案時儲存來源檔案的最"
+"後修改時間戳和大小來完成此操作。在執行時，引入系統會透過將快取檔案中儲存的元"
+"資料 (metadata) 與來源檔案的元資料進行比對來驗證快取檔案。"
 
 #: ../../reference/import.rst:617
 msgid ""
@@ -1149,16 +1153,25 @@ msgid ""
 "Hash-based ``.pyc`` files validation behavior may be overridden with the :"
 "option:`--check-hash-based-pycs` flag."
 msgstr ""
+"Python 還支援「基於雜湊」的快取檔案，這些檔案儲存來源檔案內容的雜湊值，而不是"
+"其元資料。基於雜湊的 ``.pyc`` 檔案有兩種變體：需檢查和不需要檢查的。對於需檢"
+"查的基於雜湊的 ``.pyc`` 檔案，Python 透過對來源檔案進行雜湊並將結果與快取檔案"
+"中的雜湊進行比較來驗證快取檔案。如果發現需檢查的基於雜湊的快取檔案無效，"
+"Python 會重新產生並寫入新的需檢查的基於雜湊的快取檔案。對於不需要檢查的基於雜"
+"湊的 ``.pyc`` 檔案，只要檔案存在，Python 就假設快取檔案是有效的。可以使用 :"
+"option:`--check-hash-based-pycs` 旗標覆蓋基於雜湊的 ``.pyc`` 檔案的驗證行為。"
 
 #: ../../reference/import.rst:628
 msgid ""
 "Added hash-based ``.pyc`` files. Previously, Python only supported timestamp-"
 "based invalidation of bytecode caches."
 msgstr ""
+"新增了基於雜湊的 ``.pyc`` 檔案。此前，Python 只支援基於時間戳的位元組碼快取無"
+"效化。"
 
 #: ../../reference/import.rst:634
 msgid "The Path Based Finder"
-msgstr ""
+msgstr "基於路徑的尋檢器"
 
 #: ../../reference/import.rst:639
 msgid ""
@@ -1168,6 +1181,10 @@ msgid ""
 "contains a list of :term:`path entries <path entry>`.  Each path entry names "
 "a location to search for modules."
 msgstr ""
+"如前所述，Python 附帶了幾個預設的元路徑尋檢器。其中之一稱為 :term:`path "
+"based finder`\\ （\\ :class:`~importlib.machinery.PathFinder`\\ ），它搜尋 :"
+"term:`import path`，該路徑包含一個 :term:`路徑條目 <path entry>` 的串列。每個"
+"路徑條目都指定了一個用於搜尋模組的位置。"
 
 #: ../../reference/import.rst:645
 msgid ""
@@ -1175,6 +1192,8 @@ msgid ""
 "it traverses the individual path entries, associating each of them with a "
 "path entry finder that knows how to handle that particular kind of path."
 msgstr ""
+"基於路徑的尋檢器本身並不知道如何引入任何東西。相反，它遍歷各個路徑條目，並將"
+"每個路徑條目與一個知道如何處理該特定路徑類型的路徑條目尋檢器關聯起來。"
 
 #: ../../reference/import.rst:649
 msgid ""
@@ -1186,6 +1205,11 @@ msgid ""
 "also handle loading all of these file types (other than shared libraries) "
 "from zipfiles."
 msgstr ""
+"預設的一組路徑條目尋檢器實作了在檔案系統中尋找模組的所有語意，包括處理特殊檔"
+"案類型，例如 Python 原始程式碼檔案（``.py`` 檔案）、Python 位元組程式碼檔案"
+"（``.pyc`` 檔案）以及共享函式庫（例如 ``.so`` 檔案）。當標準函式庫中的 :mod:"
+"`zipimport` 模組支援時，預設的路徑條目尋檢器也能處理從壓縮檔案中載入這些檔案"
+"類型（共享函式庫除外）。"
 
 #: ../../reference/import.rst:656
 msgid ""
@@ -1193,6 +1217,8 @@ msgid ""
 "to URLs, database queries, or any other location that can be specified as a "
 "string."
 msgstr ""
+"路徑條目不必侷限於檔案系統位置。它們可以參照 URL、資料庫查詢或任何可以作為字"
+"串指定的位置。"
 
 #: ../../reference/import.rst:660
 msgid ""
@@ -1204,6 +1230,10 @@ msgid ""
 "protocol described below, which was then used to get a loader for the module "
 "from the web."
 msgstr ""
+"基於路徑的尋檢器提供了額外的掛鉤和協定，讓你可以擴展和自定可搜尋的路徑條目類"
+"型。例如，如果你希望支援將路徑條目作為網路 URLs，你可以撰寫一個實作 HTTP 語意"
+"的掛鉤，用於在網路上尋找模組。這個掛鉤（一個可呼叫物件）會回傳一個支援下述協"
+"定的 :term:`path entry finder` ，該尋檢器隨後用於從網路中獲取模組的載入器。"
 
 #: ../../reference/import.rst:668
 msgid ""
@@ -1215,6 +1245,11 @@ msgid ""
 "In particular, meta path finders operate at the beginning of the import "
 "process, as keyed off the :data:`sys.meta_path` traversal."
 msgstr ""
+"提醒一句：本節與前一節都使用了 *尋檢器* 這個術語，並透過使用術語 :term:`meta "
+"path finder` 和 :term:`path entry finder` 來區分它們。這兩種類型的尋檢器非常"
+"相似，支援類似的協定，並在引入過程中以類似的方式運作，但請記住，它們之間有些"
+"微的差異。特別是，元路徑尋檢器在引入過程的一開始運作，並通過 :data:`sys."
+"meta_path` 的遍歷關閉 (key off)。"
 
 #: ../../reference/import.rst:676
 msgid ""
@@ -1223,6 +1258,9 @@ msgid ""
 "removed from :data:`sys.meta_path`, none of the path entry finder semantics "
 "would be invoked."
 msgstr ""
+"相比之下，路徑條目尋檢器在某種意義上是基於路徑的尋檢器的一個實作細節。事實"
+"上，如果基於路徑的尋檢器從 :data:`sys.meta_path` 中移除，路徑條目尋檢器的任何"
+"語意都不會被調用。"
 
 #: ../../reference/import.rst:683
 msgid "Path entry finders"