docs(library/pickle.po): Build succesful

SkyLull · SkyLull · commit 10b5c6dd3116 · 2024-09-30T23:38:12.000+08:00
diff --git a/library/pickle.po b/library/pickle.po
@@ -96,8 +96,8 @@ msgid ""
 "pyc` files."
 msgstr ""
 "Python 有另一個比較原始的序列化模組叫 :mod:`marshal`，不過其設計目的是為了支"
-"援 Python 的預編譯功能 :file:`.pyc` 的運作。總地來說，沒事不要用 :mod:"
-"`marshal`。"
+"援 Python 的預編譯功能 :file:`.pyc` 的運作。總地來說，請盡可能地使用 :mod:"
+"`pickle`，沒事不要用 :mod:`marshal`。"
 
 #: ../../library/pickle.rst:57
 msgid ""
@@ -251,7 +251,7 @@ msgid ""
 "efficiently :doc:`compress <archiving>` pickled data."
 msgstr ""
 "以預設設定來說，:mod:`pickle` 使用相對緊湊的二進位形式來儲存資料。如果你需要"
-"盡可能地縮小檔案大小，你可以\\\\ :doc:`壓縮 <archiving>`\\\\ 封裝的資料。"
+"盡可能地縮小檔案大小，你可以\\ :doc:`壓縮 <archiving>`\\ 封裝的資料。"
 
 #: ../../library/pickle.rst:135
 msgid ""
@@ -412,8 +412,8 @@ msgid ""
 "Write the pickled representation of the object *obj* to the open :term:`file "
 "object` *file*.  This is equivalent to ``Pickler(file, protocol).dump(obj)``."
 msgstr ""
-"將被封裝成 pickle 形式的 *obj* 寫入到已開啟的\\\\ term:`檔案物件 <file "
-"object>` *file*。這等效於\\\\ ``Pickler(file, protocol).dump(obj)``。"
+"將被封裝成 pickle 形式的 *obj* 寫入到已開啟的\\ :term:`file object` *file*。"
+"這等效於\\ ``Pickler(file, protocol).dump(obj)``。"
 
 #: ../../library/pickle.rst:222
 msgid ""
@@ -685,8 +685,11 @@ msgid ""
 "and can optionally return :data:`NotImplemented` to fallback on :attr:"
 "`dispatch_table`-registered reducers to pickle ``obj``."
 msgstr ""
-"傳 :data:`NotImplemented` 以退回（fallback）並改為使用 :attr:"
-"`dispatch_table` 中登錄的縮減方法來封裝 ``obj``。"
+"一個可以在 :class:`Pickler` 子類別中被定義的縮減器（reducer）。這個方法的優先"
+"度高於任何其他 :attr:`分派表 <dispatch_table>` 中的縮減器。他應該要有和 :"
+"meth:`~object.__reduce__` 方法相同的函數界面，且可以可選地回傳 :data:"
+"`NotImplemented` 以退回（fallback）使用 :attr:`分派表 <dispatch_table>` 中登"
+"錄的縮減方法來封裝 ``obj``。"
 
 #: ../../library/pickle.rst:379
 msgid "For a detailed example, see :ref:`reducer_override`."
@@ -744,7 +747,7 @@ msgid ""
 "datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by "
 "Python 2."
 msgstr ""
-"可選引數 *fix_imports*，*encoding* 和 *errors* 用來控制 Python 2 pickle 資料"
+"可選引數 *fix_imports*、*encoding* 和 *errors* 用來控制 Python 2 pickle 資料"
 "的相容性支援。如果 *fix_imports* 為 true，則 pickle 模組會嘗試將舊的 Python "
 "2 模組名稱映射到 Python 3 中使用的新名稱。*encoding* 和 *errors* 告訴 pickle "
 "模組如何解碼由 Python 2 pickle 封裝的 8 位元字串實例；*encoding* 和 *errors* "
@@ -760,9 +763,9 @@ msgid ""
 "*buffer_callback* argument was ``None`` when a :class:`Pickler` was "
 "instantiated (or when :func:`dump` or :func:`dumps` was called)."
 msgstr ""
-"如果 *buffers* 是 ``None``（預設值），那麼去序列化所需的所有資料都必須已經包"
-"含在 pickle 串流中。這意味著當初在建立對應的 :class:`Pickler` 時（或在呼叫 :"
-"func:`dump` 或 :func:`dumps` 時）*buffer_callback* 引數必須為 ``None``。"
+"如果 *buffers* 是 ``None``\\ （預設值），那麼去序列化所需的所有資料都必須已經"
+"包含在 pickle 串流中。這意味著當初在建立對應的 :class:`Pickler` 時（或在呼"
+"叫 :func:`dump` 或 :func:`dumps` 時）*buffer_callback* 引數必須為 ``None``。"
 
 #: ../../library/pickle.rst:424
 msgid ""
@@ -772,8 +775,8 @@ msgid ""
 "the *buffer_callback* of a Pickler object."
 msgstr ""
 "如果 *buffers* 不是 ``None``，則其應該是一個可疊代物件，內含數個支援緩衝區的"
-"物件，並且每當 pickle 串流引用一個 :ref:`帶外 <pickle-oob>` 緩衝區視圖時將會"
-"被照順序消耗。這些緩衝資料當初建立時應已按照順序給定予 Pickler 物件中的 "
+"物件，並且每當 pickle 串流引用一個\\ :ref:`帶外 <pickle-oob>`\\ 緩衝區視圖時"
+"將會被照順序消耗。這些緩衝資料當初建立時應已按照順序給定予 Pickler 物件中的 "
 "*buffer_callback*。"
 
 #: ../../library/pickle.rst:434
@@ -816,7 +819,7 @@ msgid ""
 "`pickle-restrict` for details."
 msgstr ""
 "子類別可以覆寫此方法以控制可以載入哪些類型的物件、以及如何載入它們，從而潛在"
-"地降低安全性風險。詳情請參考 :ref:`pickle-restrict`。"
+"地降低安全性風險。詳情請參考\\ :ref:`pickle-restrict`。"
 
 #: ../../library/pickle.rst:460
 msgid ""
@@ -836,8 +839,8 @@ msgid ""
 "object` or a N-dimensional array."
 msgstr ""
 "一個表示了含有可封裝數據緩衝區的包裝函數（wrapper function）。*buffer* 必須是"
-"一個 :ref:`提供緩衝區 <bufferobjects>` 的物件，例如一個 :term:`類位元組物件"
-"（bytes-like object）` 或 N 維陣列。"
+"一個 :ref:`提供緩衝區 <bufferobjects>` 的物件，例如一個 :term:`類位元組物件 "
+"<bytes-like object>` 或 N 維陣列。"
 
 #: ../../library/pickle.rst:468
 msgid ""
@@ -855,9 +858,9 @@ msgid ""
 "oob>`."
 msgstr ""
 ":class:`PickleBuffer` 物件僅能由 5 版或以上的 pickle 協定進行封裝。該物件亦能"
-"被作為帶外資料來進行:ref:`帶外資料序列化 <pickle-oob>`"
+"被作為帶外資料來進行\\ :ref:`帶外資料序列化 <pickle-oob>`"
 
-# SkyLull: oh boy... 好多術語...
+# SkyLull: oh... 好多術語...
 # format B: https://learn.microsoft.com/zh-tw/dotnet/standard/base-
 # types/standard-numeric-format-strings#BFormatString
 # C-contiguous, Fortran-contiguous: https://stackoverflow.com/a/26999092
@@ -1304,7 +1307,7 @@ msgstr ""
 "可選項。一個用來提供連續項目的疊代器（而非序列）。這些項目將個別透過 ``obj."
 "append(item)`` 方法或成批次地透過 ``obj.extend(list_of_items)`` 方法被附加到"
 "物件中。主要用於串列（list）子類別，但只要其他類別具有相應的 :ref:`append 和 "
-"extend 方法 <typesseq-common>`和相同的輸入特徵（signature）就也可以使用。 "
+"extend 方法 <typesseq-common>`\\ 和相同的輸入特徵（signature）就也可以使用。 "
 "（如何選擇使用 :meth:`!append` 或 :meth:`!extend` 方法將取決於所選用的 "
 "pickle 協定版本以及要附加的項目數量，因此必須同時支援這兩種方法。）"
 
@@ -1988,8 +1991,8 @@ msgid ""
 "graph.  Buffers accumulated by the *buffer_callback* will not see their data "
 "copied into the pickle stream, only a cheap marker will be inserted."
 msgstr ""
-"傳送端需要傳遞一個調用緩衝區的回呼函數給 :class:`Pickler`（或 :func:`dump` "
-"或 :func:`dumps` 函數）的 *buffer_callback* 引數，使每次生成 :class:"
+"傳送端需要傳遞一個調用緩衝區的回呼函數給 :class:`Pickler`\\ （或 :func:"
+"`dump` 或 :func:`dumps` 函數）的 *buffer_callback* 引數，使每次生成 :class:"
 "`PickleBuffer` 時，該物件在處理物件圖時能被呼叫。除了一個簡易標記以外，由 "
 "*buffer_callback* 累積的緩衝區資料不會被複製到 pickle 串流中。"
 
@@ -2003,11 +2006,11 @@ msgid ""
 "reconstructors of the objects whose pickling produced the original :class:"
 "`PickleBuffer` objects."
 msgstr ""
-"接收端需要傳遞一個緩衝區物件給 :class:`Unpickler`（或 :func:`load` 或 :func:"
-"`loads` 函式）的  *buffers* 引數。該物件須是一個可疊代的（iterable）緩衝區"
-"（buffer）物件，其中包含傳遞給 *buffer_callback* 的緩衝區物件。這個可疊代物件"
-"的緩衝區順序應該與它們當初被封裝時傳遞給 *buffer_callback* 的順序相同。這些緩"
-"衝區將提供物件重建所需的資料，以使重建器能還原出那個當時產生了 :class:"
+"接收端需要傳遞一個緩衝區物件給 :class:`Unpickler`\\ （或 :func:`load` 或 :"
+"func:`loads` 函式）的 *buffers* 引數。該物件須是一個可疊代的（iterable）緩衝"
+"區（buffer）物件，其中包含傳遞給 *buffer_callback* 的緩衝區物件。這個可疊代物"
+"件的緩衝區順序應該與它們當初被封裝時傳遞給 *buffer_callback* 的順序相同。這些"
+"緩衝區將提供物件重建所需的資料，以使重建器能還原出那個當時產生了 :class:"
 "`PickleBuffer` 的物件。"
 
 #: ../../library/pickle.rst:999
