editing json.po, up to line 816.

SkyLull · SkyLull · commit ad4fff0ad256 · 2024-08-09T00:13:56.000+08:00
diff --git a/library/json.po b/library/json.po
@@ -104,7 +104,7 @@ msgstr ""
 "JSON 語法是 `YAML <https://yaml.org/>`_ 1.2 語法的一種子集合。所以如果使用預"
 "設的設定的話（準確來說，使用預設的 *separators* 分隔符設定的話），這個模組的"
 "輸出也符合 YAML 1.0 和 1.1 的子集合規範。因此你也可以利用這個模組來當作 YAML "
-"的串聯化工具（serializer）。"
+"的串列化工具（serializer）。"
 
 #: ../../library/json.rst:130
 msgid ""
@@ -124,7 +124,7 @@ msgid ""
 "supporting :term:`file-like object`) using this :ref:`conversion table <py-"
 "to-json-table>`."
 msgstr ""
-"參考這個\\ :ref:`轉換表 <py-to-json-table>`\\ 將 *obj* 串聯化為符合 JSON 格式"
+"參考這個\\ :ref:`轉換表 <py-to-json-table>`\\ 將 *obj* 串列化為符合 JSON 格式"
 "的字串流，並寫入到 *fp* （一個支援 ``.write()`` 方法的 :term:`file-like "
 "object`）"
 
@@ -173,7 +173,7 @@ msgid ""
 "*allow_nan* is true, their JavaScript equivalents (``NaN``, ``Infinity``, ``-"
 "Infinity``) will be used."
 msgstr ""
-"如果 *allow_nan* 為 false（預設值：``True``\\ ），則串聯化超出嚴格 JSON 規範"
+"如果 *allow_nan* 為 false（預設值：``True``\\ ），則串列化超出嚴格 JSON 規範"
 "之範圍的 :class:`float` 值 (``nan``, ``inf``, ``-inf``) 會引發 :exc:"
 "`ValueError`。如果 *allow_nan* 為 true，則將使用它們的 JavaScript 等效項 "
 "(``NaN``, ``Infinity``, ``-Infinity``)。"
@@ -219,7 +219,7 @@ msgid ""
 "version of the object or raise a :exc:`TypeError`.  If not specified, :exc:"
 "`TypeError` is raised."
 msgstr ""
-"如果有指定本參數，*default* 應該是一個為無法串聯化的物件呼叫的函式。它應該傳"
+"如果有指定本參數，*default* 應該是一個為無法串列化的物件呼叫的函式。它應該傳"
 "回物件的 JSON 可編碼版本或引發 :exc:`TypeError`。如果未指定，則會引發 :exc:"
 "`TypeError`。"
 
@@ -237,7 +237,7 @@ msgid ""
 "it with the *cls* kwarg; otherwise :class:`JSONEncoder` is used."
 msgstr ""
 "若要使用自訂 :class:`JSONEncoder` 子類別（例如覆寫 :meth:`~JSONEncoder."
-"default` 方法來串聯化其他型別的子類別），請使用關鍵字參數 *cls* 指定它；否則"
+"default` 方法來串列化其他型別的子類別），請使用關鍵字參數 *cls* 指定它；否則"
 "使用 :class:`JSONEncoder`。"
 
 #: ../../library/json.rst:198 ../../library/json.rst:277
@@ -253,7 +253,7 @@ msgid ""
 "using the same *fp* will result in an invalid JSON file."
 msgstr ""
 "與 :mod:`pickle` 和 :mod:`marshal` 不同，JSON 沒有二進位分框的協定，因此嘗試"
-"重複呼叫 :func:`dump` 來串聯化多個物件到同一個 *fp* 裡將導致無效的 JSON 檔"
+"重複呼叫 :func:`dump` 來串列化多個物件到同一個 *fp* 裡將導致無效的 JSON 檔"
 "案。"
 
 # SkyLull: 我想這裡的 "framed protocol" 指的是 https://peps.python.org/pep-3154/#framing
@@ -263,7 +263,7 @@ msgid ""
 "table <py-to-json-table>`.  The arguments have the same meaning as in :func:"
 "`dump`."
 msgstr ""
-"使用此\\ :ref:`轉換表 <json-to-py-table>`\\ 來將 *obj* 串聯化為 JSON 格式 :"
+"使用此\\ :ref:`轉換表 <json-to-py-table>`\\ 來將 *obj* 串列化為 JSON 格式 :"
 "class:`str`。這個參數的作用與 :func:`dump` 中的同名參數意義相同。"
 
 #: ../../library/json.rst:218
@@ -287,7 +287,7 @@ msgid ""
 msgstr ""
 "使用此\\ :ref:`轉換表 <json-to-py-table>`\\ 來將 *fp*\\ （一個支援 ``."
 "read()``、包含 JSON 文件的\\ :term:`文字檔案 <text file>`\\ 或\\ :term:`二進"
-"位檔案 <binary file>`\\ ）去序列化為 Python 物件。"
+"位檔案 <binary file>`\\ ）去串列化為 Python 物件。"
 
 #: ../../library/json.rst:231
 msgid ""
@@ -383,7 +383,7 @@ msgid ""
 "If the data being deserialized is not a valid JSON document, a :exc:"
 "`JSONDecodeError` will be raised."
 msgstr ""
-"如果被去序列化（deserialized）的資料不符合 JSON 格式，將會引發 :exc:"
+"如果被去串列化（deserialized）的資料不符合 JSON 格式，將會引發 :exc:"
 "`JSONDecodeError` 例外。"
 
 #: ../../library/json.rst:280
@@ -402,7 +402,7 @@ msgid ""
 msgstr ""
 "使用\\ :ref:`轉換表 <json-to-py-table>`\\ 將 *s* （一個含有 JSON 文件的 :"
 "class:`str`\\ 、\\ :class:`bytes` 或 :class:`bytearray` 的實例（instance））"
-"去序列化（deserialize）為一個 Python 物件"
+"去串列化（deserialize）為一個 Python 物件"
 
 #: ../../library/json.rst:290
 msgid "The other arguments have the same meaning as in :func:`load`."
@@ -683,6 +683,12 @@ msgid ""
 "example::"
 msgstr "回傳一個 Python 資料結構物件 *o* 的 JSON 的字串表示。例如::"
 
+# 執行下列程式後能證明他的回傳物件是generator
+# >>> import json
+# >>> bigobject = list(range(100000))
+# >>> x = json.JSONEncoder().iterencode(bigobject)
+# >>> print(x)
+# <generator object _make_iterencode.<locals>._iterencode at 0x7293c4b48bc0>
 #: ../../library/json.rst:510
 msgid ""
 "Encode the given object, *o*, and yield each string representation as "
@@ -691,12 +697,6 @@ msgstr ""
 "將物件 *o* 編碼，並將結果統整為一個能依序產生（yield）各結果字串的生成器物件"
 "（generator）。如下例::"
 
-# 執行下列程式後能證明他的回傳物件是generator
-# >>> import json
-# >>> bigobject = list(range(100000))
-# >>> x = json.JSONEncoder().iterencode(bigobject)
-# >>> print(x)
-# <generator object _make_iterencode.<locals>._iterencode at 0x7293c4b48bc0>
 #: ../../library/json.rst:518
 msgid "Exceptions"
 msgstr "例外"
@@ -707,7 +707,7 @@ msgstr ":exc:`ValueError` 的子類別具有下列額外屬性："
 
 #: ../../library/json.rst:526
 msgid "The unformatted error message."
-msgstr "未格式化的錯誤訊息。"
+msgstr "未受格式化的錯誤訊息。"
 
 #: ../../library/json.rst:530
 msgid "The JSON document being parsed."
@@ -727,7 +727,7 @@ msgstr "*pos* 所在的列（column）數。"
 
 #: ../../library/json.rst:548
 msgid "Standard Compliance and Interoperability"
-msgstr "標準守則與互通性"
+msgstr "合規性與互通性"
 
 #: ../../library/json.rst:550
 msgid ""
@@ -737,47 +737,59 @@ msgid ""
 "simplicity, :class:`JSONEncoder` and :class:`JSONDecoder` subclasses, and "
 "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` 子"
+"類別以及未明確提及的參數將不予考慮。"
 
 #: ../../library/json.rst:556
 msgid ""
 "This module does not comply with the RFC in a strict fashion, implementing "
 "some extensions that are valid JavaScript but not valid JSON.  In particular:"
 msgstr ""
+"這個模組的部份實作並未非常嚴格地遵循 RFC 規範。準確來說，下列實際實作符合 "
+"JavaScript 語法格式，但並不符合 JSON 格式："
 
 #: ../../library/json.rst:559
 msgid "Infinite and NaN number values are accepted and output;"
-msgstr ""
+msgstr "無限（Infinite）和非數字（NaN）值會被接受。"
 
 #: ../../library/json.rst:560
 msgid ""
 "Repeated names within an object are accepted, and only the value of the last "
 "name-value pair is used."
-msgstr ""
+msgstr "同一個物件內可以有重複的名稱，但只有最後一個同名物件是有效的。"
 
 #: ../../library/json.rst:563
 msgid ""
 "Since the RFC permits RFC-compliant parsers to accept input texts that are "
 "not RFC-compliant, this module's deserializer is technically RFC-compliant "
 "under default settings."
 msgstr ""
+"不過 RFC 准許遵循 RFC 的剖析器接受不合規的文字輸入，所以技術上來說若以預設設"
+"定運作，本模組的去串列化器是符合 RFC 規範的。"
 
 #: ../../library/json.rst:568
 msgid "Character Encodings"
-msgstr ""
+msgstr "字元編碼格式"
 
 #: ../../library/json.rst:570
 msgid ""
 "The RFC requires that JSON be represented using either UTF-8, UTF-16, or "
 "UTF-32, with UTF-8 being the recommended default for maximum "
 "interoperability."
 msgstr ""
+"RFC 規定要求 JSON 必須以 UTF-8、UTF-16 或 UTF-32 格式編碼。並推薦以 UTF-8 編"
+"碼以達成最良好的互通性。"
 
 #: ../../library/json.rst:573
 msgid ""
 "As permitted, though not required, by the RFC, this module's serializer sets "
 "*ensure_ascii=True* by default, thus escaping the output so that the "
 "resulting strings only contain ASCII characters."
 msgstr ""
+"RFC 准許但並不要求編碼器的 *ensure_ascii=True* 是預設值，但本模組依然實作了此"
+"一選項作為預設，因此本模組會轉義所有非 ASCII 字元。"
 
 #: ../../library/json.rst:577
 msgid ""
@@ -786,6 +798,8 @@ msgid ""
 "<str>`, and thus does not otherwise directly address the issue of character "
 "encodings."
 msgstr ""
+"除了 *ensure_ascii* 選項之外，本模組嚴格遵循 Python 物件與 :class:`Unicode "
+"strings <str>` 之間的轉換規範，因此並不另外處理字元編碼的問題。"
 
 #: ../../library/json.rst:582
 msgid ""
@@ -795,6 +809,10 @@ msgid ""
 "in their input.  This module's deserializer raises a :exc:`ValueError` when "
 "an initial BOM is present."
 msgstr ""
+"RFC 禁止在文件的開頭加上端序記號（BOM），因此本模組的串列化器（serializer）也"
+"不會在輸出中加入端序記號。RFC 允許但不強制 JSON 去串列化器（deserializer）忽"
+"略文件初始的端序記號，因此本模組的去串列化器將在遭遇端序記號時引發 :exc:"
+"`ValueError` 例外。"
 
 #: ../../library/json.rst:588
 msgid ""
