feat: translate part of library/json.po

Author: mattwang44

library/json.po

@@ -150,7 +150,7 @@ msgid ""
 "reference check for container types will be skipped and a circular reference "
 "will result in a :exc:`RecursionError` (or worse)."
 msgstr ""
-"如果 *chech_circular* 設為 false（預設是 ``True``），則針對不同容器型別的循環"
+"如果 *check_circular* 設為 false（預設是 ``True``），則針對不同容器型別的循環"
 "參照 (circular reference) 的檢查將會被跳過，若有循環參照則最後將引發 :exc:"
 "`RecursionError` （或者更糟的錯誤）。"
 
@@ -162,6 +162,11 @@ msgid ""
 "*allow_nan* is true, their JavaScript equivalents (``NaN``, ``Infinity``, ``-"
 "Infinity``) will be used."
 msgstr ""
+"如果 *allow_nan* 設為 False（預設值為 ``True``），那麼序列化 (serialize):"
+"class:`float` 的特殊值 (``nan``, ``inf``, ``-inf``) 會觸發 :exc:"
+"`ValueError`，這麼設定是為了遵守較嚴格的 JSON 規範。如果設為 True，則序列化這"
+"些極值不會出錯，而是會被自動代換成 JavaScript 上等價的值 (``NaN``, "
+"``Infinity``, ``-Infinity``)"
 
 #: ../../library/json.rst:168 ../../library/json.rst:452
 msgid ""
@@ -172,10 +177,12 @@ msgid ""
 "indent indents that many spaces per level.  If *indent* is a string (such as "
 "``\"\\t\"``), that string is used to indent each level."
 msgstr ""
+"如果 *indent* 是一個非負整數或字串，那麼 JSON 序列及其所含元素，會以pretty-"
+"print 的方式顯示，並會有幾個。"
 
 #: ../../library/json.rst:175 ../../library/json.rst:459
 msgid "Allow strings for *indent* in addition to integers."
-msgstr ""
+msgstr "允許字串作為 *indent* 的值，而不只是允許整數。"
 
 #: ../../library/json.rst:178 ../../library/json.rst:462
 msgid ""
@@ -184,10 +191,14 @@ msgid ""
 "': ')`` otherwise.  To get the most compact JSON representation, you should "
 "specify ``(',', ':')`` to eliminate whitespace."
 msgstr ""
+"*separator* 是分隔符號，``( 項跟項 (item) 之間的分隔符號, 鍵值 (key) 之間的分"
+"隔符號)`` 的 tuple。 如果 *indent* 是 ``None``，則預設值為 ``(', ', ': ')``，"
+"否則預設值為 ``(',', ': ')``。如果希望 JSON 更省空間，建議指定為 ``(',', "
+"':')``，這樣可以消除空白。"
 
 #: ../../library/json.rst:183 ../../library/json.rst:467
 msgid "Use ``(',', ': ')`` as default if *indent* is not ``None``."
-msgstr ""
+msgstr "如果 *indent* 不是 ``None``，則用 ``(',', ': ')`` 當預設值"
 
 #: ../../library/json.rst:186 ../../library/json.rst:470
 msgid ""
@@ -196,38 +207,53 @@ msgid ""
 "version of the object or raise a :exc:`TypeError`.  If not specified, :exc:"
 "`TypeError` is raised."
 msgstr ""
+"*default* 必須一個函式，如果你有設定它的話，遇到無法 JSON 序列化的物件時會呼"
+"叫你 *default* 設定的函式。該函式只能有兩種狀況：要不就回傳一個可以被 JSON 序"
+"列化的物件，要不就拋出 :exc:`TypeError`。如果 *default* 沒有指定值，則只要遇"
+"到無法 JSON 序列化的物件就會丟出 :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* 排序。"
 
 #: ../../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` 子類別去改寫 (overrides)原來預設的 "
+"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 <keyword-only_parameter>` 了。"
 
 #: ../../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 ""
+"JSON 和 :mod:`pickle` 跟 :mod:`marshal` 不同，JSON不是一個框架協定，所以如果"
+"你試著用同一個 *fp* 來重複呼叫 :func:`dump` 來序列化多個物件，會導致無效的"
+"JSON檔案。"
 
 #: ../../library/json.rst:212
 msgid ""
 "Serialize *obj* to a JSON formatted :class:`str` using this :ref:`conversion "
 "table <py-to-json-table>`.  The arguments have the same meaning as in :func:"
 "`dump`."
 msgstr ""
+"用這個 :ref:`conversion table <py-to-json-table>` 來把 *obj* 序列化成JSON 格"
+"式的 :class:`str`。 裡面所有引數和 :func: `dump` 裡的意義相同。"
 
 #: ../../library/json.rst:218
 msgid ""
@@ -237,13 +263,20 @@ msgid ""
 "JSON and then back into a dictionary, the dictionary may not equal the "
 "original one. That is, ``loads(dumps(x)) != x`` if x has non-string keys."
 msgstr ""
+"在 JSON 的 鍵值/值對 (key/value pairs) 中，鍵值一定是 :class:`str`。當一個字"
+"典物件 (dictionary) 被轉換成 JSON 時，字典的所有鍵都會被強制轉換成字串。因"
+"此，如果一個字典被轉換成 JSON 然後再轉回字典，該字典可能不等於原來的字典。也"
+"就是說，如果字典 x 有些鍵值不是字串，那麼 ``loads(dumps(x)) != x``。"
 
 #: ../../library/json.rst:227
 msgid ""
 "Deserialize *fp* (a ``.read()``-supporting :term:`text file` or :term:"
 "`binary file` containing a JSON document) to a Python object using this :ref:"
 "`conversion table <json-to-py-table>`."
 msgstr ""
+"將 fp（一個支持.read() 的 :term:`text file` 或包含 JSON 的:term:`binary "
+"file` 反序列化 (deserialize) 為 Python 物件，轉換規則使用`conversion table "
+"<json-to-py-table>`。"
 
 #: ../../library/json.rst:231
 msgid ""
@@ -253,6 +286,10 @@ msgid ""
 "be used to implement custom decoders (e.g. `JSON-RPC <https://www.jsonrpc."
 "org>`_ class hinting)."
 msgstr ""
+"*object_hook* 是一個非必要性的函式，用來解碼物件 object_literal。如果沒有值"
+"時，物件會被解碼成 :class:`dict`。如果有值，會 *object_hook* 的回傳值會被用來"
+"取代原來的 :class:`dict`。因此，改寫 *object_hook* 就能自訂的解碼器（例如"
+"`JSON-RPC <https://www.jsonrpc.org>`_ 類別提示）。"
 
 #: ../../library/json.rst:237
 msgid ""
@@ -262,6 +299,10 @@ msgid ""
 "`dict`.  This feature can be used to implement custom decoders. If "
 "*object_hook* is also defined, the *object_pairs_hook* takes priority."
 msgstr ""
+"*object_pairs_hook* 是一個非必要函式，會在解碼物件成有序值對陣列（暫譯，"
+"ordered list of pairs），如果有值，JSON 會使用 *object_pairs_hook* 的回傳值而"
+"非原本的 :class:`dict`。此功能可以用來自訂解碼器。如果 *object_hook*也有值，"
+"*object_pairs_hook* 的值會優先採用。"
 
 #: ../../library/json.rst:243 ../../library/json.rst:348
 msgid "Added support for *object_pairs_hook*."
@@ -274,6 +315,9 @@ msgid ""
 "This can be used to use another datatype or parser for JSON floats (e.g. :"
 "class:`decimal.Decimal`)."
 msgstr ""
+"如果 *parse_float* 有值，含浮點數的 JSON 文字會被解析。預設是"
+"``float(num_str)``，但可以設成別的資料型別或 JSON 浮點數文字解析器，例如:"
+"class:`decimal.Decimal`。"
 
 #: ../../library/json.rst:251 ../../library/json.rst:356
 msgid ""
@@ -282,24 +326,31 @@ msgid ""
 "can be used to use another datatype or parser for JSON integers (e.g. :class:"
 "`float`)."
 msgstr ""
+"如果 *parse_int* 有值，含整數的 JSON 文字會被解析。預設是``int(num_str)``，但"
+"可以設成別的資料型別或 JSON 整數文字解析器，例如:class:`float`。"
 
 #: ../../library/json.rst:256
 msgid ""
 "The default *parse_int* of :func:`int` now limits the maximum length of the "
 "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:`integer "
+"string conversion length limitation <int_max_str_digits>`"
 
 #: ../../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'``、``'Infinity'``或"
+"``'NaN'``等字串時，會被呼叫用以解析它們。 *parse_constant* 也可是設定成在遇在"
+"遇無效的 JSON 數字時出錯。"
 
 #: ../../library/json.rst:267
 msgid "*parse_constant* doesn't get called on 'null', 'true', 'false' anymore."
-msgstr ""
+msgstr "*parse_constant* 不再在遇到 'null'、 'true'、 'false' 呼叫了。"
 
 #: ../../library/json.rst:270
 msgid ""