From ec31a40fe69797c562938ce356b23a307270c59e Mon Sep 17 00:00:00 2001 From: Payon Date: Thu, 3 Oct 2024 11:48:27 +0800 Subject: [PATCH 1/3] feat: to rst:241 feat: to rst:241 --- reference/import.po | 118 +++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 111 insertions(+), 7 deletions(-) diff --git a/reference/import.po b/reference/import.po index 9a98a69bd1..75a15f42d0 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: 2018-05-23 16:17+0000\n" +"PO-Revision-Date: 2024-10-03 12:34+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" @@ -16,6 +16,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" +"X-Generator: Poedit 3.5\n" #: ../../reference/import.rst:6 msgid "The import system" @@ -29,6 +30,10 @@ msgid "" "way. Functions such as :func:`importlib.import_module` and built-in :func:" "`__import__` can also be used to invoke the import machinery." msgstr "" +"一個 :term:`module` 中的 Python 程式碼通過 :term:`importing` 的過程來存取另一" +"個模組中的程式碼。:keyword:`import` 陳述式是調用 (invoke) 引入機制最常見的方" +"法，但這不是唯一的方法。函式如 :func:`importlib.import_module` 以及內建函式 :" +"func:`__import__` 也可以用來調用引入機制。" #: ../../reference/import.rst:16 msgid "" @@ -41,6 +46,11 @@ msgid "" "keyword:`!import` statement for the exact details of that name binding " "operation." msgstr "" +":keyword:`import` 陳述式結合了兩個操作：首先搜尋指定的模組，然後將搜尋結果繫" +"結到本地作用域中的一個名稱。:keyword:`!import` 陳述式的搜尋操作被定義為一個" +"對 :func:`__import__` 函式的呼叫，並帶有相應的引數。:func:`__import__` 的回傳" +"值用於執行 :keyword:`!import` 陳述式的名稱繫結操作。有關名稱繫結操作的詳細資" +"訊，請參見 :keyword:`!import` 陳述式。" #: ../../reference/import.rst:25 msgid "" @@ -50,6 +60,10 @@ msgid "" "(including :data:`sys.modules`), only the :keyword:`import` statement " "performs a name binding operation." msgstr "" +"直接呼叫 :func:`__import__` 只會執行模組搜尋操作，以及在找到時執行模組的建立" +"操作。雖然某些副作用可能會發生，例如引入父套件 (parent package)，以及更新各種" +"快取（包括 :data:`sys.modules`），但只有 :keyword:`import` 陳述式會執行名稱繫" +"結操作。" #: ../../reference/import.rst:31 msgid "" @@ -58,6 +72,9 @@ msgid "" "system (such as :func:`importlib.import_module`) may choose to bypass :func:" "`__import__` and use their own solutions to implement import semantics." msgstr "" +"當執行 :keyword:`import` 陳述式時，會呼叫內建的 :func:`__import__` 函式。其他" +"調用引入系統的機制（如 :func:`importlib.import_module`）可以選擇略過 :func:" +"`__import__`，並使用它們自己的解決方案來實作引入語意。" #: ../../reference/import.rst:36 msgid "" @@ -68,6 +85,10 @@ msgid "" "machinery is invoked. These strategies can be modified and extended by " "using various hooks described in the sections below." msgstr "" +"當模組首次被引入時，Python 會搜尋該模組，若找到則會建立一個模組物件 " +"[#fnmo]_，並對其進行初始化。如果找不到指定的模組，則會引發 :exc:" +"`ModuleNotFoundError`。當引入機制被調用時，Python 會實作各種策略來搜尋指定的" +"模組。這些策略可以透過使用以下章節描述的各種 hook（掛鉤）來修改和擴展。" #: ../../reference/import.rst:43 msgid "" @@ -76,6 +97,9 @@ msgid "" "import system is exposed through :data:`sys.meta_path`. In addition, native " "namespace package support has been implemented (see :pep:`420`)." msgstr "" +"引入系統已被更新，以完全實作 :pep:`302` 的第二階段。不再有隱式引入機制——完整" +"的引入系統已透過 :data:`sys.meta_path` 公開。此外，原生命名空間套件支援（請參" +"閱 :pep:`420`）也已被實作。" #: ../../reference/import.rst:51 msgid ":mod:`importlib`" @@ -89,6 +113,9 @@ msgid "" "import machinery. Refer to the :mod:`importlib` library documentation for " "additional detail." msgstr "" +":mod:`importlib` 模組提供了豐富的 API 來與引入系統互動。例如，:func:" +"`importlib.import_module` 提供了一個比內建的 :func:`__import__` 更推薦且更簡" +"單的 API 來調用引入機制。更多詳細資訊請參閱 :mod:`importlib` 函式庫文件。" #: ../../reference/import.rst:62 msgid "Packages" @@ -101,6 +128,9 @@ msgid "" "else. To help organize modules and provide a naming hierarchy, Python has a " "concept of :term:`packages `." msgstr "" +"Python 只有一種類型的模組物件，且所有模組，無論其是使用 Python、C 還是其他語" +"言實作，都是這種類型。為了幫助組織模組並提供命名階層，Python 導入了 :term:`套" +"件 ` 的概念。" #: ../../reference/import.rst:72 msgid "" @@ -112,6 +142,10 @@ msgid "" "hierarchically, and packages may themselves contain subpackages, as well as " "regular modules." msgstr "" +"你可以將套件視為檔案系統中的目錄，模組則是目錄中的檔案，但不要過於字面地理解" +"這個比喻，因為套件和模組不一定來自檔案系統。為了方便解釋，我們將使用這個目錄" +"和檔案的比喻。就像檔案系統目錄一樣，套件是分層組織的，套件本身可以包含子套件" +"以及一般模組。" #: ../../reference/import.rst:80 msgid "" @@ -120,6 +154,8 @@ msgid "" "of module. Specifically, any module that contains a ``__path__`` attribute " "is considered a package." msgstr "" +"請記住，所有的套件都是模組，但並非所有模組都是套件。換句話說，套件只是一種特" +"殊的模組。具體來說，任何包含 ``__path__`` 屬性的模組都被視為套件。" #: ../../reference/import.rst:85 msgid "" @@ -129,10 +165,14 @@ msgid "" "subpackage called :mod:`email.mime` and a module within that subpackage " "called :mod:`email.mime.text`." msgstr "" +"所有模組都有一個名稱。子套件的名稱與其父套件名稱之間用一個點來分隔，類似於 " +"Python 的標準屬性存取語法。因此，你可能會有一個名為 :mod:`email` 的套件，該套" +"件又有一個名為 :mod:`email.mime` 的子套件，並且該子套件中有一個名為 :mod:" +"`email.mime.text` 的模組。" #: ../../reference/import.rst:93 msgid "Regular packages" -msgstr "" +msgstr "一般套件" #: ../../reference/import.rst:98 msgid "" @@ -146,12 +186,20 @@ msgid "" "same Python code that any other module can contain, and Python will add some " "additional attributes to the module when it is imported." msgstr "" +"Python 定義了兩種類型的套件，:term:`一般套件 `\\ 和\\ :term:" +"`命名空間套件 `。一般套件是 Python 3.2 及更早版本中存在的" +"傳統套件。一般套件通常實作成一個包含 ``__init__.py`` 檔案的目錄。當引入一般套" +"件時，該 ``__init__.py`` 檔案會被隱式執行，其定義的物件會繫結到該套件的命名空" +"間中的名稱。``__init__.py`` 檔案可以包含與任何其他模組相同的 Python 代碼，並" +"且 Python 會在引入時為該模組增加一些額外的屬性。" #: ../../reference/import.rst:108 msgid "" "For example, the following file system layout defines a top level ``parent`` " "package with three subpackages::" msgstr "" +"例如，以下檔案系統布置定義了一個頂層的 ``parent`` 套件，該套件包含三個子套" +"件： ::" #: ../../reference/import.rst:111 msgid "" @@ -180,10 +228,13 @@ msgid "" "``parent.three`` will execute ``parent/two/__init__.py`` and ``parent/three/" "__init__.py`` respectively." msgstr "" +"引入 ``parent.one`` 將隱式執行 ``parent/__init__.py`` 和 ``parent/one/" +"__init__.py``。隨後引入 ``parent.two`` 或 ``parent.three`` 將分別執行 " +"``parent/two/__init__.py`` 和 ``parent/three/__init__.py``。" #: ../../reference/import.rst:127 msgid "Namespace packages" -msgstr "" +msgstr "命名空間套件" #: ../../reference/import.rst:133 msgid "" @@ -195,6 +246,10 @@ msgid "" "objects on the file system; they may be virtual modules that have no " "concrete representation." msgstr "" +"命名空間套件是由不同的\\ :term:`部分 ` 組成的，每個部分都為父套件提" +"供一個子套件。這些部分可以位於檔案系統上的不同位置。部分可能也存在於壓縮檔案" +"中、網路上，或 Python 在引入時搜尋的任何其他地方。命名空間套件不一定直接對應" +"於檔案系統中的對象；它們可能是沒有具體表示的虛擬模組。" #: ../../reference/import.rst:141 msgid "" @@ -204,6 +259,9 @@ msgid "" "that package if the path of their parent package (or :data:`sys.path` for a " "top level package) changes." msgstr "" +"命名空間套件的 ``__path__`` 屬性不使用普通的串列。它們使用自定義的可疊代型" +"別，當父套件的路徑（或頂層套件的 :data:`sys.path`）發生變化時，會在下一次引入" +"嘗試時自動執行新一輪的套件部分搜尋。" #: ../../reference/import.rst:147 msgid "" @@ -214,14 +272,19 @@ msgid "" "create a namespace package for the top-level ``parent`` package whenever it " "or one of its subpackages is imported." msgstr "" +"在命名空間套件中，不存在 ``parent/__init__.py`` 檔案。實際上，在引入搜尋過程" +"中可能會找到多個 ``parent`` 目錄，每個目錄由不同的部分提供。因此，``parent/" +"one`` 可能與 ``parent/two`` 不會實際位於一起。在這種情況下，每當引入頂層 " +"``parent`` 套件或其子套件之一時，Python 會為頂層 ``parent`` 套件建立一個命名" +"空間套件。" #: ../../reference/import.rst:154 msgid "See also :pep:`420` for the namespace package specification." -msgstr "" +msgstr "有關命名空間套件的規範，請參見 :pep:`420`。" #: ../../reference/import.rst:158 msgid "Searching" -msgstr "" +msgstr "搜尋" #: ../../reference/import.rst:160 msgid "" @@ -232,6 +295,10 @@ msgid "" "parameters to the :func:`importlib.import_module` or :func:`__import__` " "functions." msgstr "" +"在開始搜尋之前，Python 需要被引入模組（或套件，但在本討論中，兩者的區別無關緊" +"要）的完整\\ :term:`限定名稱 `。此名稱可能來自 :keyword:" +"`import` 陳述式的各種引數，或來自 :func:`importlib.import_module` 或 :func:" +"`__import__` 函式的參數。" #: ../../reference/import.rst:166 msgid "" @@ -241,10 +308,14 @@ msgid "" "baz``. If any of the intermediate imports fail, a :exc:`ModuleNotFoundError` " "is raised." msgstr "" +"此名稱將在引入搜尋的各個階段中使用，並且它可能是指向子模組的點分隔路徑，例如 " +"``foo.bar.baz``。在這種情況下，Python 會首先嘗試引入 ``foo``，然後是 ``foo." +"bar``，最後是 ``foo.bar.baz``。如果任何中間引入失敗，則會引發 :exc:" +"`ModuleNotFoundError`。" #: ../../reference/import.rst:173 msgid "The module cache" -msgstr "" +msgstr "模組快取" #: ../../reference/import.rst:178 msgid "" @@ -255,6 +326,10 @@ msgid "" "and ``foo.bar.baz``. Each key will have as its value the corresponding " "module object." msgstr "" +"在引入搜尋過程中首先檢查的地方是 :data:`sys.modules`。此對映用作所有先前引入" +"過的模組的快取，包括中間路徑。因此，如果 ``foo.bar.baz`` 之前已被引入，:data:" +"`sys.modules` 將包含 ``foo``、``foo.bar`` 和 ``foo.bar.baz`` 的條目。每個鍵的" +"值都是相應的模組物件。" #: ../../reference/import.rst:185 msgid "" @@ -264,6 +339,9 @@ msgid "" "`ModuleNotFoundError` is raised. If the module name is missing, Python will " "continue searching for the module." msgstr "" +"在引入過程中，會在 :data:`sys.modules` 中查找模組名稱，如果存在，則相關的值為" +"滿足此引入的模組，此引入過程即完成。然而，如果值是 ``None``，則會引發 :exc:" +"`ModuleNotFoundError`。如果模組名稱不存在，Python 會繼續搜尋該模組。" #: ../../reference/import.rst:191 msgid "" @@ -274,6 +352,10 @@ msgid "" "to ``None``, forcing the next import of the module to result in a :exc:" "`ModuleNotFoundError`." msgstr "" +":data:`sys.modules` 是可寫入的。刪除一個鍵可能不會銷毀相關聯的模組（因為其他" +"模組可能持有對它的參照），但會使指定的模組的快取條目失效，導致 Python 在下一" +"次引入該模組時重新搜尋。也可以將鍵賦值為 ``None``，這會強制下一次引入該模組時" +"引發 :exc:`ModuleNotFoundError`。" #: ../../reference/import.rst:198 msgid "" @@ -283,10 +365,14 @@ msgid "" "reload` will reuse the *same* module object, and simply reinitialise the " "module contents by rerunning the module's code." msgstr "" +"但請注意，如果你保留了對模組物件的參照，並在 :data:`sys.modules` 中使其快取條" +"目失效，然後重新引入指定的模組，這兩個模組物件將\\ *不會*\\ 相同。相比之下，:" +"func:`importlib.reload` 會重用\\ *相同的*\\ 模組物件，並通過重新執行模組的程" +"式碼來簡單地重新初始化模組內容。" #: ../../reference/import.rst:208 msgid "Finders and loaders" -msgstr "" +msgstr "尋檢器與載入器" #: ../../reference/import.rst:215 msgid "" @@ -299,6 +385,11 @@ msgid "" "they return themselves when they find that they can load the requested " "module." msgstr "" +"如果在 :data:`sys.modules` 中找不到指定的模組，則會調用 Python 的引入協定來尋" +"找並載入該模組。這個協定由兩個概念性物件組成，:term:`尋檢器 ` 和\\ :" +"term:`載入器 `。尋檢器的任務是使用其已知的策略來確定是否能找到命名模" +"組。實作這兩個介面的物件稱為\\ :term:`引入器 ` ——當它們發現可以載入" +"所請求的模組時，會回傳它們自己。" #: ../../reference/import.rst:223 msgid "" @@ -309,12 +400,17 @@ msgid "" "system paths or zip files. It can also be extended to search for any " "locatable resource, such as those identified by URLs." msgstr "" +"Python 包含多個預設的尋檢器和引入器。第一個尋檢器知道如何定位內建模組，第二個" +"尋檢器知道如何定位凍結模組。第三個預設尋檢器會在 :term:`import path` 中搜尋模" +"組。:term:`import path` 是一個位置的列表，這些位置可能是檔案系統路徑或壓縮檔" +"案，也可以擴展以搜尋任何可定位的資源，例如由 URL 識別的資源。" #: ../../reference/import.rst:230 msgid "" "The import machinery is extensible, so new finders can be added to extend " "the range and scope of module searching." msgstr "" +"引入機制是可擴展的，因此可以增加新的尋檢器來擴展模組搜尋的範圍和作用域。" #: ../../reference/import.rst:233 msgid "" @@ -323,6 +419,9 @@ msgid "" "related information, which the import machinery then uses when loading the " "module." msgstr "" +"尋檢器實際上不會載入模組。如果它們能找到指定的模組，它們會回傳一個\\ :dfn:`模" +"組規格`，這是一個模組的引入相關資訊的封裝，引入機制會在載入模組時使用這些資" +"訊。" #: ../../reference/import.rst:237 msgid "" @@ -330,6 +429,8 @@ msgid "" "detail, including how you can create and register new ones to extend the " "import machinery." msgstr "" +"以下各節將更詳細地描述尋檢器和載入器的協定，包括如何建立和註冊新的尋檢器和載" +"入器來擴展引入機制。" #: ../../reference/import.rst:241 msgid "" @@ -337,6 +438,9 @@ msgid "" "directly, whereas now they return module specs which *contain* loaders. " "Loaders are still used during import but have fewer responsibilities." msgstr "" +"Python 在之前的版本中，尋檢器會直接回傳\\ :term:`載入器 `，而現在它們" +"回傳的是\\ *包含*\\ 載入器的模組規格。載入器仍在引入過程中使用，但其責任減少" +"了。" #: ../../reference/import.rst:247 msgid "Import hooks" From b0869f51aaf1ea8155bf066e723884c47bddf7dd Mon Sep 17 00:00:00 2001 From: Payon Date: Mon, 7 Oct 2024 17:11:37 +0800 Subject: [PATCH 2/3] fix: to rst: 336 --- reference/import.po | 48 +++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 44 insertions(+), 4 deletions(-) diff --git a/reference/import.po b/reference/import.po index 75a15f42d0..79a0502aa6 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-10-03 12:34+0800\n" +"PO-Revision-Date: 2024-10-07 17:11+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" @@ -444,7 +444,7 @@ msgstr "" #: ../../reference/import.rst:247 msgid "Import hooks" -msgstr "" +msgstr "引入掛勾 (Import hooks)" #: ../../reference/import.rst:257 msgid "" @@ -452,6 +452,8 @@ msgid "" "this are the *import hooks*. There are two types of import hooks: *meta " "hooks* and *import path hooks*." msgstr "" +"引入機制的設計是可擴展的；其主要機制是\\ *引入掛鉤*。引入掛鉤有兩種類型：*元" +"掛鉤 (meta hooks)* 和\\ *引入路徑掛鉤*。" #: ../../reference/import.rst:261 msgid "" @@ -461,6 +463,10 @@ msgid "" "modules, or even built-in modules. Meta hooks are registered by adding new " "finder objects to :data:`sys.meta_path`, as described below." msgstr "" +"元掛鉤會在引入處理的開始階段被呼叫，除了查找 :data:`sys.modules` 快取外，其他" +"引入處理還未發生時就會呼叫。這允許元掛鉤覆蓋 :data:`sys.path` 的處理、凍結模" +"組，甚至是內建模組。元掛鉤透過將新的尋檢器物件添加到 :data:`sys.meta_path` 中" +"來註冊，具體描述請參閱下列章節。" #: ../../reference/import.rst:267 msgid "" @@ -469,10 +475,13 @@ msgid "" "encountered. Import path hooks are registered by adding new callables to :" "data:`sys.path_hooks` as described below." msgstr "" +"引入路徑掛鉤被視為 :data:`sys.path`\\ （或 ``package.__path__``）處理過程的一" +"部分來呼叫，當遇到與其相關聯的路徑項目時就會被觸發。引入路徑掛鉤透過將新的可" +"呼叫對象增加到 :data:`sys.path_hooks` 中來註冊，具體描述請參閱下列章節。" #: ../../reference/import.rst:274 msgid "The meta path" -msgstr "" +msgstr "元路徑" #: ../../reference/import.rst:280 msgid "" @@ -485,6 +494,11 @@ msgid "" "finder can use any strategy it wants to determine whether it can handle the " "named module or not." msgstr "" +"當在 :data:`sys.modules` 中找不到命名模組時，Python 接下來會搜尋 :data:`sys." +"meta_path`，其中包含一個元路徑尋檢器物件串列。這些尋檢器會依次被查詢，看它們" +"是否知道如何處理命名模組。元路徑尋檢器必須實作一個名為 :meth:`~importlib.abc." +"MetaPathFinder.find_spec` 的方法，該方法接收三個引數：名稱、引入路徑和（可選" +"的）目標模組。元路徑尋檢器可以使用任何策略來確定它是否能處理命名模組。" #: ../../reference/import.rst:289 msgid "" @@ -494,6 +508,10 @@ msgid "" "returning a spec, then a :exc:`ModuleNotFoundError` is raised. Any other " "exceptions raised are simply propagated up, aborting the import process." msgstr "" +"如果元路徑尋檢器知道如何處理命名模組，它會回傳一個規格物件。如果它無法處理命" +"名模組，則回傳 ``None``。如果 :data:`sys.meta_path` 的處理到達串列的末尾仍未" +"回傳規格，則會引發 :exc:`ModuleNotFoundError`。任何其他引發的例外將直接向上傳" +"播，並中止引入過程。" #: ../../reference/import.rst:295 msgid "" @@ -508,6 +526,12 @@ msgid "" "existing module object that will be the target of loading later. The import " "system passes in a target module only during reload." msgstr "" +"元路徑尋檢器的 :meth:`~importlib.abc.MetaPathFinder.find_spec` 方法會以兩個或" +"三個引數來呼叫。第一個是被引入模組的完全限定名稱，例如 ``foo.bar.baz``。第二" +"個引數是用於模組搜尋的路徑條目。對於頂層模組，第二個引數是 ``None``，但對於子" +"模組或子套件，第二個引數是父套件的 ``__path__`` 屬性的值。如果無法存取相應的 " +"``__path__`` 屬性，將引發 :exc:`ModuleNotFoundError`。第三個引數是一個現有的" +"模組物件，該物件將成為後續載入的目標。引入系統只會在重新載入時傳入目標模組。" #: ../../reference/import.rst:306 msgid "" @@ -520,6 +544,12 @@ msgid "" "__path__, None)``. Once ``foo.bar`` has been imported, the final traversal " "will call ``mpf.find_spec(\"foo.bar.baz\", foo.bar.__path__, None)``." msgstr "" +"對於一個引入請求，元路徑可能會被遍歷多次。例如，假設參與的模組都沒有被快取，" +"則引入 ``foo.bar.baz`` 將首先執行頂層引入，對每個元路徑尋檢器（``mpf``）呼叫 " +"``mpf.find_spec(\"foo\", None, None)``。當 ``foo`` 被引入後，將再次藉由遍歷元" +"路徑引入 ``foo.bar``，並呼叫 ``mpf.find_spec(\"foo.bar\", foo.__path__, " +"None)``。當 ``foo.bar`` 被引入後，最後一次遍歷會呼叫 ``mpf.find_spec(\"foo." +"bar.baz\", foo.bar.__path__, None)``。" #: ../../reference/import.rst:316 msgid "" @@ -527,6 +557,8 @@ msgid "" "always return ``None`` when anything other than ``None`` is passed as the " "second argument." msgstr "" +"一些元路徑尋檢器僅支援頂層引入。當第二個引數傳入 ``None`` 以外的值時，這些引" +"入器將始終回傳 ``None``。" #: ../../reference/import.rst:320 msgid "" @@ -535,6 +567,9 @@ msgid "" "modules, and one that knows how to import modules from an :term:`import " "path` (i.e. the :term:`path based finder`)." msgstr "" +"Python 的預設 :data:`sys.meta_path` 有三個元路徑尋檢器，一個知道如何引入內建" +"模組，一個知道如何引入凍結模組，還有一個知道如何從 :term:`import path` 引入模" +"組（即 :term:`path based finder`）。" #: ../../reference/import.rst:325 msgid "" @@ -544,18 +579,23 @@ msgid "" "if the finder does not implement :meth:`~importlib.abc.MetaPathFinder." "find_spec`." msgstr "" +"元路徑尋檢器的 :meth:`~importlib.abc.MetaPathFinder.find_spec` 方法取代了 :" +"meth:`!find_module`，後者現在已被棄用。雖然它將繼續正常工作，但引入機制僅在尋" +"檢器未實作 :meth:`~importlib.abc.MetaPathFinder.find_spec` 時才會嘗試使用它。" #: ../../reference/import.rst:332 msgid "" "Use of :meth:`!find_module` by the import system now raises :exc:" "`ImportWarning`." -msgstr "" +msgstr "引入系統現在使用 :meth:`!find_module` 時將引發 :exc:`ImportWarning`。" #: ../../reference/import.rst:336 msgid "" ":meth:`!find_module` has been removed. Use :meth:`~importlib.abc." "MetaPathFinder.find_spec` instead." msgstr "" +":meth:`!find_module` 已被移除。請改用 :meth:`~importlib.abc.MetaPathFinder." +"find_spec`。" #: ../../reference/import.rst:342 msgid "Loading" From 89f5a977a983e24c488a5d1dd8823adcaf996ed2 Mon Sep 17 00:00:00 2001 From: Payon Date: Mon, 7 Oct 2024 21:14:28 +0800 Subject: [PATCH 3/3] fix: Apply suggestions from code review --- reference/import.po | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/reference/import.po b/reference/import.po index dbb20cc617..5dd27d0187 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-10-07 17:11+0800\n" +"PO-Revision-Date: 2024-10-07 21:14+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" @@ -30,7 +30,7 @@ msgid "" "way. Functions such as :func:`importlib.import_module` and built-in :func:" "`__import__` can also be used to invoke the import machinery." msgstr "" -"一個 :term:`module` 中的 Python 程式碼通過 :term:`importing` 的過程來存取另一" +"一個 :term:`module` 中的 Python 程式碼透過 :term:`importing` 的過程來存取另一" "個模組中的程式碼。:keyword:`import` 陳述式是調用 (invoke) 引入機制最常見的方" "法，但這不是唯一的方法。函式如 :func:`importlib.import_module` 以及內建函式 :" "func:`__import__` 也可以用來調用引入機制。" @@ -129,8 +129,8 @@ msgid "" "concept of :term:`packages `." msgstr "" "Python 只有一種類型的模組物件，且所有模組，無論其是使用 Python、C 還是其他語" -"言實作，都是這種類型。為了幫助組織模組並提供命名階層，Python 導入了 :term:`套" -"件 ` 的概念。" +"言實作，都是這種類型。為了幫助組織模組並提供命名階層，Python 導入了\\ :term:`" +"套件 `\\ 的概念。" #: ../../reference/import.rst:72 msgid "" @@ -190,8 +190,8 @@ msgstr "" "`命名空間套件 `。一般套件是 Python 3.2 及更早版本中存在的" "傳統套件。一般套件通常實作成一個包含 ``__init__.py`` 檔案的目錄。當引入一般套" "件時，該 ``__init__.py`` 檔案會被隱式執行，其定義的物件會繫結到該套件的命名空" -"間中的名稱。``__init__.py`` 檔案可以包含與任何其他模組相同的 Python 代碼，並" -"且 Python 會在引入時為該模組增加一些額外的屬性。" +"間中的名稱。``__init__.py`` 檔案可以包含與任何其他模組相同的 Python 程式碼，" +"並且 Python 會在引入時為該模組增加一些額外的屬性。" #: ../../reference/import.rst:108 msgid "" @@ -296,9 +296,9 @@ msgid "" "functions." msgstr "" "在開始搜尋之前，Python 需要被引入模組（或套件，但在本討論中，兩者的區別無關緊" -"要）的完整\\ :term:`限定名稱 `。此名稱可能來自 :keyword:" -"`import` 陳述式的各種引數，或來自 :func:`importlib.import_module` 或 :func:" -"`__import__` 函式的參數。" +"要）的完整\\ :term:`限定名稱 (qualified name) `。此名稱可能來" +"自 :keyword:`import` 陳述式的各種引數，或來自 :func:`importlib." +"import_module` 或 :func:`__import__` 函式的參數。" #: ../../reference/import.rst:166 msgid "" @@ -367,12 +367,12 @@ msgid "" msgstr "" "但請注意，如果你保留了對模組物件的參照，並在 :data:`sys.modules` 中使其快取條" "目失效，然後重新引入指定的模組，這兩個模組物件將\\ *不會*\\ 相同。相比之下，:" -"func:`importlib.reload` 會重用\\ *相同的*\\ 模組物件，並通過重新執行模組的程" +"func:`importlib.reload` 會重用\\ *相同的*\\ 模組物件，並透過重新執行模組的程" "式碼來簡單地重新初始化模組內容。" #: ../../reference/import.rst:208 msgid "Finders and loaders" -msgstr "尋檢器與載入器" +msgstr "尋檢器 (Finder) 與載入器 (Loader)" #: ../../reference/import.rst:215 msgid "" @@ -388,8 +388,8 @@ msgstr "" "如果在 :data:`sys.modules` 中找不到指定的模組，則會調用 Python 的引入協定來尋" "找並載入該模組。這個協定由兩個概念性物件組成，:term:`尋檢器 ` 和\\ :" "term:`載入器 `。尋檢器的任務是使用其已知的策略來確定是否能找到命名模" -"組。實作這兩個介面的物件稱為\\ :term:`引入器 ` ——當它們發現可以載入" -"所請求的模組時，會回傳它們自己。" +"組。實作這兩個介面的物件稱為\\ :term:`引入器 (importer) ` ——當它們" +"發現可以載入所請求的模組時，會回傳它們自己。" #: ../../reference/import.rst:223 msgid "" @@ -444,7 +444,7 @@ msgstr "" #: ../../reference/import.rst:247 msgid "Import hooks" -msgstr "引入掛勾 (Import hooks)" +msgstr "引入掛鉤 (Import hooks)" #: ../../reference/import.rst:257 msgid "" @@ -466,7 +466,7 @@ msgstr "" "元掛鉤會在引入處理的開始階段被呼叫，除了查找 :data:`sys.modules` 快取外，其他" "引入處理還未發生時就會呼叫。這允許元掛鉤覆蓋 :data:`sys.path` 的處理、凍結模" "組，甚至是內建模組。元掛鉤透過將新的尋檢器物件添加到 :data:`sys.meta_path` 中" -"來註冊，具體描述請參閱下列章節。" +"來註冊，具體描述請參閱以下段落。" #: ../../reference/import.rst:267 msgid "" @@ -477,7 +477,7 @@ msgid "" msgstr "" "引入路徑掛鉤被視為 :data:`sys.path`\\ （或 ``package.__path__``）處理過程的一" "部分來呼叫，當遇到與其相關聯的路徑項目時就會被觸發。引入路徑掛鉤透過將新的可" -"呼叫對象增加到 :data:`sys.path_hooks` 中來註冊，具體描述請參閱下列章節。" +"呼叫對象增加到 :data:`sys.path_hooks` 中來註冊，具體描述請參閱以下段落。" #: ../../reference/import.rst:274 msgid "The meta path" pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy