docs(library/json.po): Completly translated and refined

SkyLull · SkyLull · commit dad189851b7e · 2024-08-10T01:37:51.000+08:00
closes #942
diff --git a/library/json.po b/library/json.po
@@ -84,11 +84,11 @@ msgstr "自訂特殊的 JSON 解碼方式： ::"
 
 #: ../../library/json.rst:90
 msgid "Extending :class:`JSONEncoder`::"
-msgstr "在 :class:`JSONEncoder` 裡自行擴充額外的編碼方法： ::"
+msgstr "繼承 :class:`JSONEncoder` 類別並自行擴充額外的編碼方法： ::"
 
 #: ../../library/json.rst:108
 msgid "Using :mod:`json.tool` from the shell to validate and pretty-print:"
-msgstr "在命令列介面裡使用 :mod:`json.tool` 來驗證 JSON 語法和美化"
+msgstr "在命令列介面裡使用 :mod:`json.tool` 來驗證 JSON 語法和美化呈現方式："
 
 #: ../../library/json.rst:119
 msgid "See :ref:`json-commandline` for detailed documentation."
@@ -112,7 +112,7 @@ msgid ""
 "default.  Order is only lost if the underlying containers are unordered."
 msgstr ""
 "這個模組的編、解碼器預設會保存輸入與輸出資料的順序關係，除非一開始的輸入本身"
-"就是無序的。（例如集合 :class:`set`）"
+"就是無序的。（例如集合）"
 
 #: ../../library/json.rst:135
 msgid "Basic Usage"
@@ -136,15 +136,15 @@ msgid ""
 msgstr ""
 "如果 *skipkeys* 被設為 true（預設值：``False``），那麼非基本型別（:class:"
 "`str`，:class:`int`，:class:`float`，:class:`bool`，``None``）的 dictionary"
-"（字典）鍵值將被略過，而不會引發 :exc:`TypeError`。"
+"（字典）鍵值將被略過而不會引發 :exc:`TypeError`。"
 
 #: ../../library/json.rst:150
 msgid ""
 "The :mod:`json` module always produces :class:`str` objects, not :class:"
 "`bytes` objects. Therefore, ``fp.write()`` must support :class:`str` input."
 msgstr ""
 ":mod:`json` 模組總是產生 :class:`str` 物件，而非 :class:`bytes` 物件。因此，"
-"``fp.write()`` 必須支援 :class:`str` 的輸入。"
+"``fp.write()`` 必須支援 :class:`str` 輸入。"
 
 #: ../../library/json.rst:154 ../../library/json.rst:433
 msgid ""
@@ -162,7 +162,7 @@ msgid ""
 "will result in a :exc:`RecursionError` (or worse)."
 msgstr ""
 "如果 *check_circular* 設為 false（預設是 ``True``），則針對不同容器型別的循環"
-"參照 (circular reference) 的檢查將會被跳過，若有循環參照則最後將引發 :exc:"
+"參照 (circular reference) 檢查將會被跳過，若有循環參照則最後將引發 :exc:"
 "`RecursionError` （或其他更糟的錯誤）。"
 
 #: ../../library/json.rst:162
@@ -173,9 +173,9 @@ msgid ""
 "*allow_nan* is true, their JavaScript equivalents (``NaN``, ``Infinity``, ``-"
 "Infinity``) will be used."
 msgstr ""
-"如果 *allow_nan* 為 false（預設值：``True``\\ ），則串列化超出嚴格 JSON 規範"
-"之範圍的 :class:`float` 值 (``nan``, ``inf``, ``-inf``) 會引發 :exc:"
-"`ValueError`。如果 *allow_nan* 為 true，則將使用它們的 JavaScript 等效項 "
+"如果 *allow_nan* 為 false（預設值：``True``\\ ），則串列化不符合嚴格 JSON 規"
+"範的 :class:`float` 值 (``nan``, ``inf``, ``-inf``) 會引發 :exc:"
+"`ValueError`。如果 *allow_nan* 為 true，則將使用它們的 JavaScript 等效表示 "
 "(``NaN``, ``Infinity``, ``-Infinity``)。"
 
 #: ../../library/json.rst:168 ../../library/json.rst:452
@@ -188,9 +188,9 @@ msgid ""
 "``\"\\t\"``), that string is used to indent each level."
 msgstr ""
 "如果 *indent* 是非負整數或字串，則 JSON 陣列元素和物件成員將使用該縮排等級進"
-"行漂亮列印。縮排等級 0、負數或 ``\"\"`` 只會插入換行符號。``None``\\ （預設"
-"值）選擇最緊湊的表示法。使用正整數縮排可以在每層縮排數量相同的空格。如果 "
-"*indent* 是一個字串（例如 ``\"\\t\"``\\ ），則該字串用於縮排每個層級。"
+"行格式美化。縮排等級 0、負數或 ``\"\"`` 只會插入換行符號。``None``\\ （預設"
+"值）等於是選擇最緊湊的表示法。使用正整數縮排可以在每層縮排數量相同的空格。如"
+"果 *indent* 是一個字串（例如 ``\"\\t\"``\\ ），則該字串用於縮排每個層級。"
 
 #: ../../library/json.rst:175 ../../library/json.rst:459
 msgid "Allow strings for *indent* in addition to integers."
@@ -204,13 +204,13 @@ msgid ""
 "specify ``(',', ':')`` to eliminate whitespace."
 msgstr ""
 "如果有指定本參數，*separators* 應該是一個 ``(item_separator, "
-"key_separator)`` 元組。如果 *indent* 為 ``None`` 則預設為 ``(', ', ': ')``，"
-"否則預設為 ``(',', ': ')``。想要獲得最緊湊的 JSON 表示形式，你應該指定 "
-"``(',', ':')`` 來消除空格。"
+"key_separator)`` 二元組。如果 *indent* 為 ``None`` 則預設為 ``(', ', ': "
+"')``，否則預設為 ``(',', ': ')``。想要獲得最緊湊的 JSON 表示形式，你可以改成"
+"指定 ``(',', ':')`` 來消除尾隨的空格。"
 
 #: ../../library/json.rst:183 ../../library/json.rst:467
 msgid "Use ``(',', ': ')`` as default if *indent* is not ``None``."
-msgstr "如果 *indent* 不是 ``None``，則使用 ``(',', ': ')`` 當預設值"
+msgstr "如果 *indent* 不是 ``None``，則使用 ``(',', ': ')`` 作為預設值"
 
 #: ../../library/json.rst:186 ../../library/json.rst:470
 msgid ""
@@ -219,45 +219,45 @@ msgid ""
 "version of the object or raise a :exc:`TypeError`.  If not specified, :exc:"
 "`TypeError` is raised."
 msgstr ""
-"如果有指定本參數，*default* 應該是一個為無法串列化的物件呼叫的函式。它應該傳"
-"回物件的 JSON 可編碼版本或引發 :exc:`TypeError`。如果未指定，則會引發 :exc:"
-"`TypeError`。"
+"如果有指定本參數，*default* 會是一個遭遇無法串列化的物件時會被呼叫的函式。它"
+"應該傳回該物件的 JSON 可編碼版本或引發 :exc:`TypeError`。如果未指定，則會直接"
+"引發 :exc:`TypeError`。"
 
 #: ../../library/json.rst:191
 msgid ""
 "If *sort_keys* is true (default: ``False``), then the output of dictionaries "
 "will be sorted by key."
 msgstr ""
-"如果 *sort_keys* 為 true（預設值：``False``），則字典的輸出將按鍵排序。"
+"如果 *sort_keys* 為 true（預設值：``False``），則字典的輸出將按鍵值排序。"
 
 #: ../../library/json.rst:194
 msgid ""
 "To use a custom :class:`JSONEncoder` subclass (e.g. one that overrides the :"
 "meth:`~JSONEncoder.default` method to serialize additional types), specify "
 "it with the *cls* kwarg; otherwise :class:`JSONEncoder` is used."
 msgstr ""
-"若要使用自訂 :class:`JSONEncoder` 子類別（例如覆寫 :meth:`~JSONEncoder."
-"default` 方法來串列化其他型別的子類別），請使用關鍵字參數 *cls* 指定它；否則"
-"使用 :class:`JSONEncoder`。"
+"若要使用繼承自 :class:`JSONEncoder` 的自訂子類別（例如覆寫 :meth:"
+"`~JSONEncoder.default` 方法來串列化其他型別的一個子類別物件），請使用關鍵字參"
+"數 *cls* 指定該類別物件；否則預設使用 :class:`JSONEncoder`。"
 
 #: ../../library/json.rst:198 ../../library/json.rst:277
 msgid ""
 "All optional parameters are now :ref:`keyword-only <keyword-only_parameter>`."
 msgstr ""
 "所有可選參數現在都是\\ :ref:`僅限關鍵字 <keyword-only_parameter>`\\ 參數了。"
 
+# SkyLull: 我想這裡的 "framed protocol" 指的是
+# https://peps.python.org/pep-3154/#framing
 #: ../../library/json.rst:203
 msgid ""
 "Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol, so "
 "trying to serialize multiple objects with repeated calls to :func:`dump` "
 "using the same *fp* will result in an invalid JSON file."
 msgstr ""
-"與 :mod:`pickle` 和 :mod:`marshal` 不同，JSON 沒有二進位分框的協定，因此嘗試"
-"重複呼叫 :func:`dump` 來串列化多個物件到同一個 *fp* 裡將導致無效的 JSON 檔"
-"案。"
+"與 :mod:`pickle` 和 :mod:`marshal` 不同，JSON 不具有二進位分框（binary "
+"framed）的協定，因此嘗試重複呼叫 :func:`dump` 來串列化多個物件到同一個 *fp* "
+"裡將導致無效的 JSON 檔案。"
 
-# SkyLull: 我想這裡的 "framed protocol" 指的是
-# https://peps.python.org/pep-3154/#framing
 #: ../../library/json.rst:212
 msgid ""
 "Serialize *obj* to a JSON formatted :class:`str` using this :ref:`conversion "
@@ -349,24 +349,25 @@ msgid ""
 "integer string via the interpreter's :ref:`integer string conversion length "
 "limitation <int_max_str_digits>` to help avoid denial of service attacks."
 msgstr ""
-":func:`int` 預設的 *parse_int* 現在有限制整數字串的長度上限了，限制由直譯器的"
-"\\ :ref:`整數字串轉換長度限制 <int_max_str_digits>`\\ 機制來達成，這能防止阻"
-"斷服務攻擊 (denial of service attacks)。"
+"預設 *parse_int* 使用的 :func:`int` 函數現在有限制整數字串的長度上限了，限制"
+"由直譯器的\\ :ref:`整數字串轉換長度限制 <int_max_str_digits>`\\ 機制來達成，"
+"這能防止阻斷服務攻擊 (Denial of Service attacks)。"
 
 #: ../../library/json.rst:262 ../../library/json.rst:361
 msgid ""
 "*parse_constant*, if specified, will be called with one of the following "
 "strings: ``'-Infinity'``, ``'Infinity'``, ``'NaN'``. This can be used to "
 "raise an exception if invalid JSON numbers are encountered."
 msgstr ""
-"如有給定 *parse_constant* 的話，在解碼時若遭遇以下字串 ``'-Infinity'``、"
+"如有給定 *parse_constant* 的話，在解碼時若遭遇字串 ``'-Infinity'``、"
 "``'Infinity'`` 或 ``'NaN'`` 其中之一則會改用這個參數給定的函數來進行解碼。這"
 "也可用於使解碼過程中遇到無效的 JSON 數字時引發一個例外。"
 
 #: ../../library/json.rst:267
 msgid "*parse_constant* doesn't get called on 'null', 'true', 'false' anymore."
 msgstr ""
-"遭遇 'null'、 'true'、 'false' 時不再以 *parse_constant* 給定的函數來處理了。"
+"遭遇 'null'、 'true' 或 'false' 時不再以 *parse_constant* 給定的函數來處理"
+"了。"
 
 #: ../../library/json.rst:270
 msgid ""
@@ -376,7 +377,7 @@ msgid ""
 msgstr ""
 "若想要使用自定義的 :class:`JSONDecoder` 子類別物件，請以 ``cls`` 關鍵字參數指"
 "定之，否則將使用預設的 :class:`JSONDecoder`。其他未使用到的關鍵字參數將繼續傳"
-"入給 :class:`JSONDecoder` 的建構函數使用。"
+"入給 JSONDecoder 的建構函數使用。"
 
 #: ../../library/json.rst:274 ../../library/json.rst:292
 #: ../../library/json.rst:371
@@ -414,8 +415,8 @@ msgid ""
 "*s* can now be of type :class:`bytes` or :class:`bytearray`. The input "
 "encoding should be UTF-8, UTF-16 or UTF-32."
 msgstr ""
-"現在，*s* 可以是一個\\ :term:`二進位檔案 <binary file>`\\ ，前提是其編碼格式"
-"為 UTF-8、UTF-16 或 UTF-32。"
+"現在，*s* 可以是一個二進位檔案如 :class:`bytes` 或 :class:`bytearray`，前提是"
+"其編碼格式為 UTF-8、UTF-16 或 UTF-32。"
 
 #: ../../library/json.rst:299
 msgid "The keyword argument *encoding* has been removed."
@@ -467,7 +468,7 @@ msgstr "str"
 
 #: ../../library/json.rst:323
 msgid "number (int)"
-msgstr "number (int)"
+msgstr "number (整數)"
 
 #: ../../library/json.rst:323
 msgid "int"
@@ -510,8 +511,8 @@ msgid ""
 "It also understands ``NaN``, ``Infinity``, and ``-Infinity`` as their "
 "corresponding ``float`` values, which is outside the JSON spec."
 msgstr ""
-"雖然 ``NaN``、``Infinity`` 和 ``-Infinity`` 並不符合 JSON 規範，解碼器依然能"
-"正確的將其對應到相應的 Python ``float`` 值。"
+"雖然 ``NaN``、``Infinity`` 和 ``-Infinity`` 並不符合 JSON 規範，但解碼器依然"
+"能正確地將其轉換到相應的 Python ``float`` 值。"
 
 #: ../../library/json.rst:337
 msgid ""
@@ -522,8 +523,8 @@ msgid ""
 msgstr ""
 "*object_hook* 是一個可選參數，其接受一個函數作為輸入。原始的字串解碼結果（一"
 "個 :class:`dict`\\ ）將被傳入這個函數、並使用 *object_hook* 的回傳值來取代原"
-"先的 :class:`dict` 輸出。此功能可用於實作自訂義解碼器（例如 `JSON-RPC "
-"<https://www.jsonrpc.org>`_ 類別提示）。"
+"先的 dict 輸出。此功能可用於實作自訂義解碼器（例如 `JSON-RPC <https://www."
+"jsonrpc.org>`_ 類別提示）。"
 
 #: ../../library/json.rst:342
 msgid ""
@@ -559,8 +560,7 @@ msgid ""
 "Return the Python representation of *s* (a :class:`str` instance containing "
 "a JSON document)."
 msgstr ""
-"返回用 Python 方式表達的 *s*（一個含有 JSON 文件的 :class:`str` 實例"
-"（instance））"
+"返回用 Python 型式表達的 *s* （一個含有 JSON 文件的 :class:`str` 實例）。"
 
 #: ../../library/json.rst:382
 msgid ""
@@ -615,8 +615,8 @@ msgid ""
 "superclass implementation (to raise :exc:`TypeError`)."
 msgstr ""
 "若要擴充此功能來識別其他物件，請繼承並實作一個 :meth:`~JSONEncoder.default` "
-"方法。此方法應回傳一個可序列化的 ``o`` 物件，否則此方法應呼叫父類別的 :meth:"
-"`~JSONEncoder.default` 方法（以拋出 :exc:`TypeError` 例外）。"
+"方法。此方法應回傳一個可序列化的 ``o`` 物件，否則此方法應呼叫父類別的 "
+"JSONEncoder.default 方法（以拋出 :exc:`TypeError` 例外）。"
 
 #: ../../library/json.rst:429
 msgid ""
@@ -739,9 +739,9 @@ msgid ""
 "parameters other than those explicitly mentioned, are not considered."
 msgstr ""
 "JSON 格式是由 :rfc:`7159` 和 `ECMA-404 <https://www.ecma-international.org/"
-"publications-and-standards/standards/ecma-404/>` 規範的。本節詳細說明了本模組"
-"對 RFC 的遵循程度。簡單起見，:class:`JSONEncoder` 和 :class:`JSONDecoder` 子"
-"類別以及未明確提及的參數將不予考慮。"
+"publications-and-standards/standards/ecma-404/>`_ 規範的。本節詳細說明了本模"
+"組對 RFC 的遵循程度。簡單起見，:class:`JSONEncoder` 和 :class:`JSONDecoder` "
+"子類別以及未明確提及的參數將不予討論。"
 
 #: ../../library/json.rst:556
 msgid ""
@@ -862,8 +862,8 @@ msgid ""
 "but the last name-value pair for a given name::"
 msgstr ""
 "RFC 規範僅表明 JSON 物件中的名字應該是唯一的，但沒有強制要求如何處理重複的名"
-"字。預設情況下，這個模組不會引發例外；相反的，它會忽略該名字的所有重複鍵值"
-"對，只保留最後一個： ::"
+"字。預設情況下，本模組不會因此引發例外；相反的，它會忽略該名字的所有重複鍵值"
+"對，並只保留最後一個： ::"
 
 #: ../../library/json.rst:630
 msgid "The *object_pairs_hook* parameter can be used to alter this behavior."
@@ -882,10 +882,10 @@ msgid ""
 "this module does not and has never implemented that restriction in either "
 "its serializer or its deserializer."
 msgstr ""
-"由已廢棄的 :rfc:`4627` 規範的舊版 JSON 要求 JSON 文字的頂層值必須是 JSON 物件"
-"或陣列（Python :class:`dict` 或 :class:`list`），而且不能是 JSON 的 null、"
-"boolean、數字或字串值。 :rfc:`7159` 移除了這個限制，而此模組在其串列化器或去"
-"串列化器中也未曾實施過該限制。"
+"由已廢棄的 :rfc:`4627` 所規範的舊版 JSON 要求 JSON 文字的頂層值必須是 JSON 物"
+"件或陣列（Python :class:`dict` 或 :class:`list`），而且不能是 JSON 的 null、"
+"boolean、數字或字串值。 :rfc:`7159` 移除了這個限制，而本模組的串列化器或去串"
+"列化器中未曾實施過該限制。"
 
 #: ../../library/json.rst:643
 msgid ""
@@ -922,8 +922,8 @@ msgid ""
 "This module does not impose any such limits beyond those of the relevant "
 "Python datatypes themselves or the Python interpreter itself."
 msgstr ""
-"這個模組本身不會設定任何此類限制，除了 Python 資料型態本身或 Python 直譯器本"
-"身的限制。"
+"本模組除了 Python 資料型態本身或 Python 直譯器本身的限制以外，不會設定任何此"
+"類限制。"
 
 #: ../../library/json.rst:660
 msgid ""
@@ -935,10 +935,10 @@ msgid ""
 "magnitude, or when serializing instances of \"exotic\" numerical types such "
 "as :class:`decimal.Decimal`."
 msgstr ""
-"串列化為 JSON 時，要注意可能會使用該 JSON 的應用程式中的相關限制。特別要注意"
-"的是，JSON 數字常會被去串列化為 IEEE 754 雙精度浮點數（double），並因而受到其"
-"表示範圍和精度限制的影響。這在序列化極大的 Python :class:`int` 數值、或是序列"
-"化特殊數字型別（例如 :class:`decimal.Decimal`）實例時尤其重要。"
+"將資料串列化為 JSON 時，要注意可能會使用該 JSON 輸出的應用程式中的相關限制。"
+"特別要注意的是，JSON 數字常會被去串列化為 IEEE 754 雙精度浮點數（double），並"
+"因而受到其表示範圍和精度限制的影響。這在序列化極大的 Python :class:`int` 數"
+"值、或是序列化特殊數字型別的實例時（例如 :class:`decimal.Decimal`）尤其重要。"
 
 #: ../../library/json.rst:673
 msgid "Command Line Interface"
@@ -961,7 +961,7 @@ msgid ""
 "data:`sys.stdin` and :data:`sys.stdout` will be used respectively:"
 msgstr ""
 "如果沒有指定可選參數 ``infile`` 和 ``outfile`` ，則 :data:`sys.stdin` 和 :"
-"data:`sys.stdout` 各自為預設值。"
+"data:`sys.stdout` 將各自做為輸入和輸出的預設值。"
 
 #: ../../library/json.rst:697
 msgid ""
@@ -977,7 +977,7 @@ msgstr "命令列選項"
 
 #: ../../library/json.rst:708
 msgid "The JSON file to be validated or pretty-printed:"
-msgstr "被用於校驗或美化呈現的 JSON 文件："
+msgstr "將被用於校驗或美化呈現的 JSON 文件："
 
 #: ../../library/json.rst:724
 msgid "If *infile* is not specified, read from :data:`sys.stdin`."
@@ -988,8 +988,8 @@ msgid ""
 "Write the output of the *infile* to the given *outfile*. Otherwise, write it "
 "to :data:`sys.stdout`."
 msgstr ""
-"將 *infile* 的結果寫入到給定的 *outfile*。若未提供則寫入到:data:`sys."
-"stdout`。"
+"將 *infile* 的結果寫入到給定的 *outfile*。若未提供則寫入到 :data:`sys."
+"stdout`\\ 。"
 
 #: ../../library/json.rst:733
 msgid "Sort the output of dictionaries alphabetically by key."
@@ -1026,5 +1026,4 @@ msgid ""
 msgstr ""
 "如 `RFC 7159 更正 <https://www.rfc-editor.org/errata_search.php?rfc=7159>`_ "
 "所述，JSON 允許字串中出現 U+2028（行分隔符）和 U+2029（段落分隔符）字元，而 "
-"JavaScript（截至 ECMAScript 5.1 版）則不允許。\n"
-"`"
+"JavaScript（截至 ECMAScript 5.1 版）則不允許。"
