Finish translate this section

rockleona · rockleona · commit 32d8b62bcd21 · 2023-11-01T14:25:22.000+08:00
diff --git a/library/typing.po b/library/typing.po
@@ -8,7 +8,7 @@ msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-10-11 17:13+0000\n"
-"PO-Revision-Date: 2023-10-31 23:08+0800\n"
+"PO-Revision-Date: 2023-11-01 14:02+0800\n"
 "Last-Translator: RockLeon <therockleona@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -17,7 +17,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.4.1\n"
+"X-Generator: Poedit 3.4\n"
 
 #: ../../library/typing.rst:3
 msgid ":mod:`typing` --- Support for type hints"
@@ -425,9 +425,9 @@ msgid ""
 "checker treat ``Alias`` as being *exactly equivalent* to ``Original`` in all "
 "cases. This is useful when you want to simplify complex type signatures."
 msgstr ""
-"請記得使用型別別名是宣告兩種型別是互相\\*相等*\\的。使用 ``type Alias = "
+"請記得使用型別別名是宣告兩種型別是互相\\ *相等*\\ 的。使用 ``type Alias = "
 "Original`` 則會讓靜態型別檢查器在任何情況之下將 ``Alias`` 視為與 "
-"``Original`` \\*完全相等*\\。這當你想把複雜的型別簽名進行簡化時，非常好用。"
+"``Original`` \\ *完全相等*\\ 。這當你想把複雜的型別簽名進行簡化時，非常好用。"
 
 #: ../../library/typing.rst:243
 msgid ""
@@ -450,16 +450,18 @@ msgid ""
 "some additional runtime cost when calling ``NewType`` over a regular "
 "function."
 msgstr ""
+"現在的 ``NewType`` 比起一個函式更像一個類別。因此，比起一般的函式，呼叫 "
+"``NewType`` 需要額外的執行環境成本。"
 
 #: ../../library/typing.rst:257
 msgid ""
 "The performance of calling ``NewType`` has been restored to its level in "
 "Python 3.9."
-msgstr ""
+msgstr "呼叫 ``NewType`` 的效能已經恢復與 Python 3.9 相同的水準。"
 
 #: ../../library/typing.rst:264
 msgid "Annotating callable objects"
-msgstr ""
+msgstr "標記 callable 物件"
 
 #: ../../library/typing.rst:266
 msgid ""
@@ -468,6 +470,9 @@ msgid ""
 "``Callable[[int], str]`` signifies a function that takes a single parameter "
 "of type :class:`int` and returns a :class:`str`."
 msgstr ""
+"函式，或者是 :term:`callable` 物件，可以使用 :class:`collections.abc."
+"Callable` 或 :data:`typing.Callable` 進行標記。 ``Callable[[int], str]`` 象徵"
+"為一個函式，可以接受一個型別為 :class:`int` 的引數，並回傳一個 :class:`str`。"
 
 #: ../../library/typing.rst:271 ../../library/typing.rst:2888
 #: ../../library/typing.rst:3030
@@ -481,12 +486,17 @@ msgid ""
 "types, a :class:`ParamSpec`, :data:`Concatenate`, or an ellipsis. The return "
 "type must be a single type."
 msgstr ""
+"使用訂閱語法 (subscription syntax) 時，必須使用到兩個值，分別為引述串列以及回"
+"傳類別。引數串列必須為一個型別串列：:class:`ParamSpec`、:data:`Concatenate` "
+"或是一個刪節號 (ellipsis)。回傳類別必為一個單一類別。"
 
 #: ../../library/typing.rst:294
 msgid ""
 "If a literal ellipsis ``...`` is given as the argument list, it indicates "
 "that a callable with any arbitrary parameter list would be acceptable:"
 msgstr ""
+"若刪節號文字 ``...`` 被當作引數串列給定，其指出一個具任何、隨意參數列表的 "
+"callable 會被接受： ::"
 
 #: ../../library/typing.rst:306
 msgid ""
@@ -496,6 +506,10 @@ msgid ""
 "be expressed by defining a :class:`Protocol` class with a :meth:`~object."
 "__call__` method:"
 msgstr ""
+"``Callable`` 不如有可變數量引數的函式、:func:`overloaded functions "
+"<overload>`、或是限定關鍵字參數的函式，可以表示複雜簽名。然而，這些簽名可以透"
+"過定義一個具有 :meth:`~object.__call__` 方法的 :class:`Protocol` 類別進行表"
+"示："
 
 #: ../../library/typing.rst:333
 msgid ""
@@ -507,53 +521,70 @@ msgid ""
 "``Callable[Concatenate[Arg1Type, Arg2Type, ..., ParamSpecVariable], "
 "ReturnType]`` respectively."
 msgstr ""
+"Callable 物件可以取用其他 callable 當作引數使用，可以透過 :class:`ParamSpec` "
+"指出他們的參數型別是個別獨立的。另外，如果這個 callable 從其他 callable 新增"
+"或刪除引數時，將會使用到 :data:`Concatenate` 運算子。他們可以分別採用 "
+"``Callable[ParamSpecVariable, ReturnType]`` 以及 "
+"``Callable[Concatenate[Arg1Type, Arg2Type, ..., ParamSpecVariable], "
+"ReturnType]`` 的形式。"
 
 #: ../../library/typing.rst:341 ../../library/typing.rst:3559
 msgid ""
 "``Callable`` now supports :class:`ParamSpec` and :data:`Concatenate`. See :"
 "pep:`612` for more details."
 msgstr ""
+"``Callable`` 現已支援 :class:`ParamSpec` 以及 :data:`Concatenate`。請參閱 :"
+"pep:`612` 閱讀詳細內容。"
 
 #: ../../library/typing.rst:346
 msgid ""
 "The documentation for :class:`ParamSpec` and :class:`Concatenate` provides "
 "examples of usage in ``Callable``."
 msgstr ""
+":class:`ParamSpec` 以及 :class:`Concatenate` 的文件中，提供範例如何在 "
+"``Callable`` 中使用。"
 
 #: ../../library/typing.rst:352
 msgid "Generics"
-msgstr ""
+msgstr "泛型"
 
 #: ../../library/typing.rst:354
 msgid ""
 "Since type information about objects kept in containers cannot be statically "
 "inferred in a generic way, many container classes in the standard library "
 "support subscription to denote the expected types of container elements."
 msgstr ""
+"自從關於物件的型別資訊留存在容器之內，且無法使用泛型的方式進行靜態推論 "
+"(statically inferred)，許多標準函式庫的容器類別支援訂閱及表示容器內元素預期的"
+"型別。"
 
 #: ../../library/typing.rst:371
 msgid ""
 "Generic functions and classes can be parameterized by using :ref:`type "
 "parameter syntax <type-params>`::"
 msgstr ""
+"泛型函式及類別可以使用 :ref:`type parameter syntax <type-params>` 進行參數化 "
+"(parameterize) ： ::"
 
 #: ../../library/typing.rst:379
 msgid "Or by using the :class:`TypeVar` factory directly::"
-msgstr ""
+msgstr "或是直接使用 :class:`TypeVar` 工具 (factory)： ::"
 
 #: ../../library/typing.rst:389
 msgid "Syntactic support for generics is new in Python 3.12."
-msgstr ""
+msgstr "在 Python 3.12 中，泛型的語法支援是全新功能。"
 
 #: ../../library/typing.rst:395
 msgid "Annotating tuples"
-msgstr ""
+msgstr "標記元組 (tuple)"
 
 #: ../../library/typing.rst:397
 msgid ""
 "For most containers in Python, the typing system assumes that all elements "
 "in the container will be of the same type. For example::"
 msgstr ""
+"在 Python 大多數的容器當中，加註型別系統認為容器內的所有元素會是相同型別。舉"
+"例來說： ::"
 
 #: ../../library/typing.rst:412
 msgid ""
@@ -562,6 +593,10 @@ msgid ""
 "Mapping` only accepts two type arguments: the first indicates the type of "
 "the keys, and the second indicates the type of the values."
 msgstr ""
+":class:`list` 只接受一個型別引數，所以型別檢查器可能在上述 ``y`` 賦值 "
+"(assignment)觸發錯誤。類似的範例，:class:`~collections.abc.Mapping` 只接受兩"
+"個型別引數：第一個引數指出 keys （鍵） 的型別；第二個引數指出 values （值）的"
+"型別。"
 
 #: ../../library/typing.rst:418
 msgid ""
@@ -570,6 +605,10 @@ msgid ""
 "For this reason, tuples are special-cased in Python's typing system. :class:"
 "`tuple` accepts *any number* of type arguments::"
 msgstr ""
+"然而，與其他多數的 Python 容器不同，在慣用的 (idiomatic) Python 程式碼中，元"
+"組可以擁有不完全相同型別的元素是相當常見的。為此，元祖在 Python 的加註型別系"
+"統中是個特例 (special-cased)。:class:`tuple` 接受\\ *任何數量*\\ 的型別引"
+"數： ::"
 
 #: ../../library/typing.rst:434
 msgid ""
@@ -578,6 +617,9 @@ msgid ""
 "use ``tuple[()]``. Using plain ``tuple`` as an annotation is equivalent to "
 "using ``tuple[Any, ...]``::"
 msgstr ""
+"為了標示一個元組可以為\\ *任意*\\ 長度，且所有元素皆是相同型別 ``T``，請使用 "
+"``tuple[T, ...]`` 進行標示。為了標示一個空元組，請使用 ``tuple[()]``。單純使"
+"用 ``tuple`` 作為標記，會與使用 ``tuple[Any, ...]`` 是相等的： ::"
 
 #: ../../library/typing.rst:457
 msgid "The type of class objects"
