Continue decimal.po translation - Add introduction and key method sections

Copilot · josix · Copilot · commit c197842cd6cb · 2025-07-12T13:12:53.000Z
Co-authored-by: josix &lt;18432820+josix@users.noreply.github.com&gt;
diff --git a/library/decimal.po b/library/decimal.po
@@ -32,6 +32,8 @@ msgid ""
 "decimal floating-point arithmetic. It offers several advantages over the :"
 "class:`float` datatype:"
 msgstr ""
+":mod:`decimal` 模組提供對快速正確捨入的十進位浮點運算的支援。相較於 :class:"
+"`float` 資料型別，它提供了幾個優勢："
 
 #: ../../library/decimal.rst:37
 msgid ""
@@ -41,6 +43,9 @@ msgid ""
 "people learn at school.\" -- excerpt from the decimal arithmetic "
 "specification."
 msgstr ""
+"Decimal「基於一個以人為設計考量的浮點模型，並且必然有一個至關重要的指導原則 "
+"—— 電腦必須提供與人們在學校學習的算術運算方式相同的算術運算。」—— 摘自十進位"
+"算術規範。"
 
 #: ../../library/decimal.rst:42
 msgid ""
@@ -49,6 +54,9 @@ msgid ""
 "point. End users typically would not expect ``1.1 + 2.2`` to display as "
 "``3.3000000000000003`` as it does with binary floating point."
 msgstr ""
+"Decimal 數字可以被精確表示。相對地，像 ``1.1`` 和 ``2.2`` 這樣的數字在二進位"
+"浮點數中沒有精確的表示方式。終端使用者通常不會期望 ``1.1 + 2.2`` 顯示為 "
+"``3.3000000000000003``，但這正是二進位浮點數的表現。"
 
 #: ../../library/decimal.rst:47
 msgid ""
@@ -59,6 +67,10 @@ msgid ""
 "accumulate. For this reason, decimal is preferred in accounting applications "
 "which have strict equality invariants."
 msgstr ""
+"精確性延續到算術運算中。在十進位浮點數中，``0.1 + 0.1 + 0.1 - 0.3`` 完全"
+"等於零。在二進位浮點數中，結果是 ``5.5511151231257827e-017``。雖然接近零，"
+"但這些差異會妨礙可靠的相等性測試，並且差異可能累積。因此，在具有嚴格相等"
+"不變量的會計應用程式中，decimal 是首選。"
 
 #: ../../library/decimal.rst:54
 msgid ""
@@ -69,13 +81,19 @@ msgid ""
 "multiplicands.  For instance, ``1.3 * 1.2`` gives ``1.56`` while ``1.30 * "
 "1.20`` gives ``1.5600``."
 msgstr ""
+"decimal 模組納入了有效位數的概念，使得 ``1.30 + 1.20`` 等於 ``2.50``。尾隨"
+"零被保留以表示有效性。這是金融應用程式的慣例表示法。對於乘法，「課本」方法"
+"使用被乘數中的所有數字。例如，``1.3 * 1.2`` 得到 ``1.56``，而 ``1.30 * "
+"1.20`` 得到 ``1.5600``。"
 
 #: ../../library/decimal.rst:61
 msgid ""
 "Unlike hardware based binary floating point, the decimal module has a user "
 "alterable precision (defaulting to 28 places) which can be as large as "
 "needed for a given problem:"
 msgstr ""
+"與基於硬體的二進位浮點數不同，decimal 模組具有使用者可變的精度（預設為 28 位），"
+"可以根據給定問題的需要設定得足夠大："
 
 #: ../../library/decimal.rst:73
 msgid ""
@@ -86,6 +104,10 @@ msgid ""
 "signal handling. This includes an option to enforce exact arithmetic by "
 "using exceptions to block any inexact operations."
 msgstr ""
+"二進位和十進位浮點數都是根據已發布的標準實作的。雖然內建的 float 型別只"
+"暴露其功能的一小部分，但 decimal 模組暴露了標準的所有必要部分。必要時，"
+"程式設計師對捨入和訊號處理有完全的控制權。這包括透過使用例外來阻止任何"
+"不精確運算以強制執行精確算術的選項。"
 
 #: ../../library/decimal.rst:80
 msgid ""
@@ -94,12 +116,15 @@ msgid ""
 "rounded floating-point arithmetic.\"  -- excerpt from the decimal arithmetic "
 "specification."
 msgstr ""
+"decimal 模組被設計為支援「無偏見地支援精確的未捨入十進位算術（有時稱為定點"
+"算術）和捨入浮點算術。」—— 摘自十進位算術規範。"
 
 #: ../../library/decimal.rst:85
 msgid ""
 "The module design is centered around three concepts:  the decimal number, "
 "the context for arithmetic, and signals."
 msgstr ""
+"模組設計圍繞三個概念：decimal 數字、算術情境和訊號。"
 
 #: ../../library/decimal.rst:88
 msgid ""
@@ -109,6 +134,9 @@ msgid ""
 "``-Infinity``, and ``NaN``.  The standard also differentiates ``-0`` from "
 "``+0``."
 msgstr ""
+"decimal 數字是不可變的。它有符號、係數數字和指數。為了保持有效性，係數數字"
+"不會截斷尾隨零。Decimal 也包含特殊值，如 ``Infinity``、``-Infinity`` 和 "
+"``NaN``。標準也區分 ``-0`` 和 ``+0``。"
 
 #: ../../library/decimal.rst:94
 msgid ""
@@ -119,6 +147,11 @@ msgid ""
 "`ROUND_FLOOR`, :const:`ROUND_HALF_DOWN`, :const:`ROUND_HALF_EVEN`, :const:"
 "`ROUND_HALF_UP`, :const:`ROUND_UP`, and :const:`ROUND_05UP`."
 msgstr ""
+"算術情境是一個指定精度、捨入規則、指數限制、指示運算結果的旗標，以及決定"
+"訊號是否被視為例外的陷阱啟用器的環境。捨入選項包括 :const:`ROUND_CEILING`、"
+":const:`ROUND_DOWN`、:const:`ROUND_FLOOR`、:const:`ROUND_HALF_DOWN`、:const:"
+"`ROUND_HALF_EVEN`、:const:`ROUND_HALF_UP`、:const:`ROUND_UP` 和 :const:"
+"`ROUND_05UP`。"
 
 #: ../../library/decimal.rst:101
 msgid ""
@@ -130,6 +163,11 @@ msgid ""
 "`Subnormal`, :const:`Overflow`, :const:`Underflow` and :const:"
 "`FloatOperation`."
 msgstr ""
+"訊號是在計算過程中產生的例外條件群組。根據應用程式的需求，訊號可能被忽略、"
+"視為資訊性質，或被視為例外。decimal 模組中的訊號包括：:const:`Clamped`、"
+":const:`InvalidOperation`、:const:`DivisionByZero`、:const:`Inexact`、:const:"
+"`Rounded`、:const:`Subnormal`、:const:`Overflow`、:const:`Underflow` 和 "
+":const:`FloatOperation`。"
 
 #: ../../library/decimal.rst:108
 msgid ""
@@ -138,12 +176,17 @@ msgid ""
 "one, an exception is raised.  Flags are sticky, so the user needs to reset "
 "them before monitoring a calculation."
 msgstr ""
+"每個訊號都有一個旗標和一個陷阱啟用器。當遇到訊號時，其旗標被設定為一，然後，"
+"如果陷阱啟用器被設定為一，就會引發例外。旗標是黏性的，因此使用者需要在監控"
+"計算之前重設它們。"
 
 #: ../../library/decimal.rst:116
 msgid ""
 "IBM's General Decimal Arithmetic Specification, `The General Decimal "
 "Arithmetic Specification <https://speleotrove.com/decimal/decarith.html>`_."
 msgstr ""
+"IBM 的一般十進位算術規範，`一般十進位算術規範 "
+"<https://speleotrove.com/decimal/decarith.html>`_。"
 
 #: ../../library/decimal.rst:125
 msgid "Quick-start tutorial"
@@ -414,6 +457,8 @@ msgid ""
 "`ExtendedContext`. The former is especially useful for debugging because "
 "many of the traps are enabled:"
 msgstr ""
+"根據標準，:mod:`decimal` 模組提供兩個現成可用的標準情境，:const:`BasicContext` "
+"和 :const:`ExtendedContext`。前者特別適用於除錯，因為許多陷阱都已啟用："
 
 #: ../../library/decimal.rst:275
 msgid ""
@@ -466,6 +511,9 @@ msgid ""
 "cleared, so it is best to clear the flags before each set of monitored "
 "computations by using the :meth:`~Context.clear_flags` method. ::"
 msgstr ""
+"情境也有訊號旗標用於監控計算過程中遇到的例外條件。旗標會保持設定狀態直到"
+"明確清除，因此最好在每組受監控的計算之前使用 :meth:`~Context.clear_flags` "
+"方法清除旗標： ::"
 
 #: ../../library/decimal.rst:304
 msgid ""
@@ -491,12 +539,15 @@ msgid ""
 "(digits beyond the context precision were thrown away) and that the result "
 "is inexact (some of the discarded digits were non-zero)."
 msgstr ""
+"*flags* 條目顯示對 pi 的有理逼近已被捨入（超出情境精度的數字被丟棄），並且"
+"結果是不精確的（一些被丟棄的數字非零）。"
 
 #: ../../library/decimal.rst:316
 msgid ""
 "Individual traps are set using the dictionary in the :attr:`~Context.traps` "
 "attribute of a context:"
 msgstr ""
+"個別陷阱使用情境的 :attr:`~Context.traps` 屬性中的字典設定："
 
 #: ../../library/decimal.rst:319
 msgid ""
@@ -528,6 +579,9 @@ msgid ""
 "the bulk of the program manipulates the data no differently than with other "
 "Python numeric types."
 msgstr ""
+"大多數程式只在程式開始時調整一次目前情境。在許多應用程式中，資料在迴圈內"
+"透過單次轉換轉換為 :class:`Decimal`。設定情境並建立 decimal 後，程式的大部分"
+"操作資料的方式與其他 Python 數值型別沒有什麼不同。"
 
 #: ../../library/decimal.rst:343
 msgid "Decimal objects"
@@ -745,12 +799,14 @@ msgid ""
 "Mixed-type comparisons between :class:`Decimal` instances and other numeric "
 "types are now fully supported."
 msgstr ""
+":class:`Decimal` 實例與其他數值型別之間的混合型別比較現在完全支援。"
 
 #: ../../library/decimal.rst:450
 msgid ""
 "In addition to the standard numeric properties, decimal floating-point "
 "objects also have a number of specialized methods:"
 msgstr ""
+"除了標準數值屬性外，decimal 浮點數物件也有許多專門的方法："
 
 #: ../../library/decimal.rst:456
 msgid ""
@@ -759,6 +815,8 @@ msgid ""
 "returns seven.  Used for determining the position of the most significant "
 "digit with respect to the decimal point."
 msgstr ""
+"在移出係數的最右邊數字直到只剩下前導數字後，回傳調整後的指數："
+"``Decimal('321e+5').adjusted()`` 回傳七。用於確定最高有效數字相對於小數點的位置。"
 
 #: ../../library/decimal.rst:463
 msgid ""
