Update translation for library/enum.po

mindihx · mindihx · commit 8aa15acb0e3f · 2024-12-21T13:52:43.000+08:00
diff --git a/library/enum.po b/library/enum.po
@@ -8,7 +8,7 @@ msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-11-02 00:13+0000\n"
-"PO-Revision-Date: 2023-09-11 14:08+0800\n"
+"PO-Revision-Date: 2024-12-21 13:50+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -85,6 +85,16 @@ msgid ""
 ">>> # functional syntax\n"
 ">>> Color = Enum('Color', [('RED', 1), ('GREEN', 2), ('BLUE', 3)])"
 msgstr ""
+">>> from enum import Enum\n"
+"\n"
+">>> # class 語法\n"
+">>> class Color(Enum):\n"
+"...     RED = 1\n"
+"...     GREEN = 2\n"
+"...     BLUE = 3\n"
+"\n"
+">>> # 函式語法\n"
+">>> Color = Enum('Color', [('RED', 1), ('GREEN', 2), ('BLUE', 3)])"
 
 #: ../../library/enum.rst:49
 msgid ""
@@ -331,20 +341,19 @@ msgid ""
 "to subclass *EnumType* -- see :ref:`Subclassing EnumType <enumtype-"
 "examples>` for details."
 msgstr ""
-"*EnumType* 是\\ *列舉*\\ 的 :term:`metaclass`。*EnumType* 可以有子類別 -- 細"
+"*EnumType* 是 *enum* 列舉的 :term:`metaclass`。*EnumType* 可以有子類別 -- 細"
 "節請參考 :ref:`建立 EnumType 的子類別 <enumtype-examples>`。"
 
 #: ../../library/enum.rst:168
-#, fuzzy
 msgid ""
 "``EnumType`` is responsible for setting the correct :meth:`!__repr__`, :meth:"
 "`!__str__`, :meth:`!__format__`, and :meth:`!__reduce__` methods on the "
 "final *enum*, as well as creating the enum members, properly handling "
 "duplicates, providing iteration over the enum class, etc."
 msgstr ""
-"*EnumType* 負責在最後的\\ *列舉*\\ 上面設定正確的 :meth:`!__repr__`、:meth:`!"
-"__str__`、:meth:`!__format__` 及 :meth:`!__reduce__` 方法，以及建立列舉成員，"
-"並正確處理重複，提供列舉類別的疊代等等。"
+"``EnumType`` 負責在最後的\\ *列舉*\\ 上面設定正確的 :meth:`!__repr__`、:meth:"
+"`!__str__`、:meth:`!__format__` 及 :meth:`!__reduce__` 方法，以及建立列舉成"
+"員、正確處理重複、提供列舉類別的疊代等等。"
 
 #: ../../library/enum.rst:175
 msgid "This method is called in two different ways:"
@@ -534,20 +543,22 @@ msgid ""
 "Adds a new name as an alias to an existing member.  Raises a :exc:"
 "`NameError` if the name is already assigned to a different member."
 msgstr ""
+"新增一個名稱作為現有成員的別名。如果該名稱已被指派給不同的成員，則會引發 :"
+"exc:`NameError`。"
 
 #: ../../library/enum.rst:256
 msgid ""
 "Adds a new value as an alias to an existing member.  Raises a :exc:"
 "`ValueError` if the value is already linked with a different member."
 msgstr ""
+"新增一個值作為現有成員的別名。如果該值已與不同成員連結，則會引發 :exc:"
+"`ValueError`。"
 
 #: ../../library/enum.rst:261
-#, fuzzy
 msgid ""
 "Before 3.11 ``EnumType`` was called ``EnumMeta``, which is still available "
 "as an alias."
-msgstr ""
-"在 3.11 之前，``enum`` 使用 ``EnumMeta`` 類型，目前保留此類型當作別名。"
+msgstr "在 3.11 之前，``EnumType`` 稱作 ``EnumMeta``，其目前仍可作為別名使用。"
 
 #: ../../library/enum.rst:266
 msgid "*Enum* is the base class for all *enum* enumerations."
@@ -602,6 +613,9 @@ msgid ""
 "quadratic performance impact during creation relative to the total number of "
 "mutable/unhashable values in the enum."
 msgstr ""
+"雖然可以使用可變的 (mutable) / 不可雜湊的 (unhashable) 值，例如 :class:"
+"`dict`、:class:`list` 或可變的 :class:`~dataclasses.dataclass`，它們在建立期"
+"間會對效能產生相對於列舉中可變的 / 不可雜湊的值的總數量的二次方的影響。"
 
 #: ../../library/enum.rst:298
 msgid "Name of the member."
@@ -806,7 +820,7 @@ msgstr ""
 #: ../../library/enum.rst:408
 msgid ""
 "results in the call ``int('1a', 16)`` and a value of ``26`` for the member."
-msgstr ""
+msgstr "會產生呼叫 ``int('1a', 16)`` 而該成員的值為 ``26``。"
 
 #: ../../library/enum.rst:412
 msgid ""
@@ -925,15 +939,14 @@ msgid "Added :ref:`enum-dataclass-support`"
 msgstr "新增 :ref:`enum-dataclass-support`"
 
 #: ../../library/enum.rst:471
-#, fuzzy
 msgid ""
 "*IntEnum* is the same as :class:`Enum`, but its members are also integers "
 "and can be used anywhere that an integer can be used.  If any integer "
 "operation is performed with an *IntEnum* member, the resulting value loses "
 "its enumeration status."
 msgstr ""
-"*IntEnum* 和 *Enum* 一樣，但其成員同時也是整數而可以被用在任何使用整數的地"
-"方。如果 *IntEnum* 成員經過任何整數運算，其結果會失去列舉狀態。"
+"*IntEnum* 和 :class:`Enum` 一樣，但其成員同時也是整數而可以被用在任何使用整數"
+"的地方。如果 *IntEnum* 成員經過任何整數運算，結果值會失去其列舉狀態。"
 
 #: ../../library/enum.rst:492
 msgid ""
@@ -952,15 +965,14 @@ msgstr ""
 "meth:`~object.__format__` 已經是 :meth:`!int.__format__`。"
 
 #: ../../library/enum.rst:502
-#, fuzzy
 msgid ""
 "``StrEnum`` is the same as :class:`Enum`, but its members are also strings "
 "and can be used in most of the same places that a string can be used.  The "
 "result of any string operation performed on or with a *StrEnum* member is "
 "not part of the enumeration."
 msgstr ""
-"*StrEnum* 和 *Enum* 一樣，但其成員同時也是字串而可以被用在幾乎所有使用字串的"
-"地方。*StrEnum* 成員經過任何字串操作的結果會不再是列舉的一部份。"
+"``StrEnum`` 和 :class:`Enum` 一樣，但其成員同時也是字串而可以被用在幾乎所有使"
+"用字串的地方。*StrEnum* 成員經過任何字串操作的結果會不再是列舉的一部份。"
 
 #: ../../library/enum.rst:508
 msgid ""
@@ -1138,9 +1150,8 @@ msgstr ""
 "<Color.RED|GREEN|BLUE: 7>"
 
 #: ../../library/enum.rst:614
-#, fuzzy
 msgid "Returns all the flags in *type(self)* that are not in *self*::"
-msgstr "回傳所有在 *type(self)* 但不在 self 裡的旗標： ::"
+msgstr "回傳所有在 *type(self)* 但不在 *self* 裡的旗標： ::"
 
 #: ../../library/enum.rst:616
 msgid ""
@@ -1177,13 +1188,12 @@ msgid "The *repr()* of zero-valued flags has changed.  It is now::"
 msgstr "值為 0 的旗標的 *repr()* 已改變。現在是： ::"
 
 #: ../../library/enum.rst:641
-#, fuzzy
 msgid ""
 "``IntFlag`` is the same as :class:`Flag`, but its members are also integers "
 "and can be used anywhere that an integer can be used."
 msgstr ""
-"*IntFlag* 和 *Flag* 一樣，但其成員同時也是整數而可以被用在任何使用整數的地"
-"方。"
+"``IntFlag`` 和 :class:`Flag` 一樣，但其成員同時也是整數而可以被用在任何使用整"
+"數的地方。"
 
 #: ../../library/enum.rst:655
 msgid ""
@@ -1200,25 +1210,22 @@ msgstr ""
 "3"
 
 #: ../../library/enum.rst:661
-#, fuzzy
 msgid "If a :class:`Flag` operation is performed with an *IntFlag* member and:"
-msgstr "如果 *IntFlag* 成員經過 *Flag* 操作且："
+msgstr "如果 *IntFlag* 成員經過 :class:`Flag` 操作且："
 
 #: ../../library/enum.rst:663
 msgid "the result is a valid *IntFlag*: an *IntFlag* is returned"
 msgstr "結果是合法的 *IntFlag*：回傳 *IntFlag*"
 
 #: ../../library/enum.rst:664
-#, fuzzy
 msgid ""
 "the result is not a valid *IntFlag*: the result depends on the :class:"
 "`FlagBoundary` setting"
-msgstr "結果不是合法的 *IntFlag*：結果會根據 *FlagBoundary* 的設定"
+msgstr "結果不是合法的 *IntFlag*：結果會根據 :class:`FlagBoundary` 的設定"
 
 #: ../../library/enum.rst:666
-#, fuzzy
 msgid "The :func:`repr` of unnamed zero-valued flags has changed.  It is now:"
-msgstr "未命名且值為 0 的旗標的 *repr()* 已改變。現在是： ::"
+msgstr "未命名且值為 0 的旗標的 :func:`repr` 已改變。現在是："
 
 #: ../../library/enum.rst:673
 msgid ""
@@ -1377,11 +1384,10 @@ msgid ""
 msgstr "CONTINUOUS 和 NAMED_FLAGS 是設計用來運作在整數值的成員上。"
 
 #: ../../library/enum.rst:762
-#, fuzzy
 msgid ""
 "``FlagBoundary`` controls how out-of-range values are handled in :class:"
 "`Flag` and its subclasses."
-msgstr "*FlagBoundary* 控制在 *Flag* 及其子類別中如何處理範圍外的值。"
+msgstr "``FlagBoundary`` 控制在 :class:`Flag` 及其子類別中如何處理範圍外的值。"
 
 #: ../../library/enum.rst:767
 msgid ""
@@ -1418,11 +1424,10 @@ msgstr ""
 "  allowed 0b0 00111"
 
 #: ../../library/enum.rst:785
-#, fuzzy
 msgid ""
 "Out-of-range values have invalid values removed, leaving a valid :class:"
 "`Flag` value::"
-msgstr "範圍外的值會移除非法值，留下合法的 *Flag* 值： ::"
+msgstr "會移除範圍外的值中的非法值，留下合法的 :class:`Flag` 值： ::"
 
 #: ../../library/enum.rst:788
 msgid ""
@@ -1445,20 +1450,18 @@ msgstr ""
 "<ConformFlag.BLUE: 4>"
 
 #: ../../library/enum.rst:799
-#, fuzzy
 msgid ""
 "Out-of-range values lose their :class:`Flag` membership and revert to :class:"
 "`int`."
-msgstr "範圍外的值會失去它們的 *Flag* 成員資格且恢復成 :class:`int`。"
+msgstr "範圍外的值會失去它們的 :class:`Flag` 成員資格且恢復成 :class:`int`。"
 
 #: ../../library/enum.rst:812
-#, fuzzy
 msgid ""
 "Out-of-range values are kept, and the :class:`Flag` membership is kept. This "
 "is the default for :class:`IntFlag`::"
 msgstr ""
-"範圍外的值會被保留，*Flag* 成員資格也會被保留。這是 :class:`IntFlag` 的預設行"
-"為： ::"
+"範圍外的值會被保留，:class:`Flag` 成員資格也會被保留。這是 :class:`IntFlag` "
+"的預設行為： ::"
 
 #: ../../library/enum.rst:815
 msgid ""
@@ -1482,7 +1485,7 @@ msgstr ""
 
 #: ../../library/enum.rst:829
 msgid "Supported ``__dunder__`` names"
-msgstr "支援 ``__dunder__`` 名稱"
+msgstr "支援的 ``__dunder__`` 名稱"
 
 #: ../../library/enum.rst:831
 msgid ""
@@ -1493,31 +1496,30 @@ msgstr ""
 "目的對映。只有在類別上可用。"
 
 #: ../../library/enum.rst:834
-#, fuzzy
 msgid ""
 ":meth:`~Enum.__new__`, if specified, must create and return the enum "
 "members; it is also a very good idea to set the member's :attr:`!_value_` "
 "appropriately. Once all the members are created it is no longer used."
 msgstr ""
-"如果指定了 :meth:`~Enum.__new__`，它必須建立並回傳列舉成員；適當地設定成員"
+":meth:`~Enum.__new__`，如果有指定，它必須建立並回傳列舉成員；適當地設定成員"
 "的 :attr:`!_value_` 也是一個很好的主意。一旦所有成員都建立之後就不會再被用"
 "到。"
 
 #: ../../library/enum.rst:840
 msgid "Supported ``_sunder_`` names"
-msgstr "支援 ``_sunder_`` 名稱"
+msgstr "支援的 ``_sunder_`` 名稱"
 
 #: ../../library/enum.rst:842
 msgid ""
 ":meth:`~EnumType._add_alias_` -- adds a new name as an alias to an existing "
 "member."
-msgstr ""
+msgstr ":meth:`~EnumType._add_alias_` -- 新增一個名稱作為現有成員的別名。"
 
 #: ../../library/enum.rst:844
 msgid ""
 ":meth:`~EnumType._add_value_alias_` -- adds a new value as an alias to an "
 "existing member."
-msgstr ""
+msgstr ":meth:`~EnumType._add_value_alias_` -- 新增一個值作為現有成員的別名。"
 
 #: ../../library/enum.rst:846
 msgid ":attr:`~Enum._name_` -- name of the member"
@@ -1559,32 +1561,33 @@ msgstr ""
 ":meth:`~Enum._generate_next_value_` -- 用來為列舉成員取得合適的值；可以被覆寫"
 
 #: ../../library/enum.rst:860
-#, fuzzy
 msgid ""
 "For standard :class:`Enum` classes the next value chosen is the highest "
 "value seen incremented by one."
 msgstr ""
-"對標準的 :class:`Enum` 類別來說，下一個被選擇的值是最後一個看見的值加一。"
+"對標準的 :class:`Enum` 類別來說，下一個被選擇的值是所看過的最大值加一。"
 
 #: ../../library/enum.rst:863
-#, fuzzy
 msgid ""
 "For :class:`Flag` classes the next value chosen will be the next highest "
 "power-of-two."
 msgstr ""
-"對 :class:`Flag` 類別來說，下一個被選擇的值是下一個最大的 2 的次方，不管最後"
-"一個看見的值是什麼。"
+"對 :class:`Flag` 類別來說，下一個被選擇的值是下一個最大的 2 的次方的數字。"
 
 #: ../../library/enum.rst:866
 msgid ""
 "While ``_sunder_`` names are generally reserved for the further development "
 "of the :class:`Enum` class and can not be used, some are explicitly allowed:"
 msgstr ""
+"雖然 ``_sunder_`` 名稱通常保留用於 :class:`Enum` 類別的進一步開發而不能被使"
+"用，但有些是明確允許的："
 
 #: ../../library/enum.rst:869
 msgid ""
 "``_repr_*`` (e.g. ``_repr_html_``), as used in `IPython's rich display`_"
 msgstr ""
+"``_repr_*``（例如 ``_repr_html_``），例如用於 `IPython 的豐富顯示 <IPython’s "
+"rich display_>`_"
 
 #: ../../library/enum.rst:871
 msgid "``_missing_``, ``_order_``, ``_generate_next_value_``"
@@ -1596,14 +1599,13 @@ msgstr "``_ignore_``"
 
 #: ../../library/enum.rst:873
 msgid "``_add_alias_``, ``_add_value_alias_``, ``_repr_*``"
-msgstr ""
+msgstr "``_add_alias_``、``_add_value_alias_``、``_repr_*``"
 
 #: ../../library/enum.rst:879
 msgid "Utilities and Decorators"
 msgstr "通用項目與裝飾器"
 
 #: ../../library/enum.rst:883
-#, fuzzy
 msgid ""
 "*auto* can be used in place of a value.  If used, the *Enum* machinery will "
 "call an :class:`Enum`'s :meth:`~Enum._generate_next_value_` to get an "
@@ -1613,11 +1615,11 @@ msgid ""
 "for :class:`StrEnum` it will be the lower-cased version of the member's "
 "name.  Care must be taken if mixing *auto()* with manually specified values."
 msgstr ""
-"*auto* 可以用來取代給值。如果使用的話，*Enum* 系統會呼叫 *Enum* 的 :meth:"
-"`~Enum._generate_next_value_` 來取得合適的值。對 *Enum* 和 *IntEnum* 來說，合"
-"適的值是最後一個值加一；對 *Flag* 和 *IntFlag* 來說，是第一個比最大值還大的 "
-"2 的次方的數字；對 *StrEnum* 來說，是成員名稱的小寫版本。如果混用 *auto()* 和"
-"手動指定值的話要特別注意。"
+"*auto* 可以用來取代給值。如果使用的話，*Enum* 系統會呼叫 :class:`Enum` 的 :"
+"meth:`~Enum._generate_next_value_` 來取得合適的值。對 :class:`Enum` 和 :"
+"class:`IntEnum` 來說，合適的值是最後一個值加一；對 :class:`Flag` 和 :class:"
+"`IntFlag` 來說，是第一個比最大值還大的 2 的次方的數字；對 :class:`StrEnum` 來"
+"說，是成員名稱的小寫版本。如果混用 *auto()* 和手動指定值的話要特別注意。"
 
 #: ../../library/enum.rst:891
 msgid ""
