@@ -96,8 +96,8 @@ msgid ""
9696"pyc` files."
9797msgstr ""
9898"Python 有另一個比較原始的序列化模組叫 :mod:`marshal`,不過其設計目的是為了支"
99- "援 Python 的預編譯功能 :file:`.pyc` 的運作。總地來說,沒事不要用 :mod:"
100- "`marshal`。"
99+ "援 Python 的預編譯功能 :file:`.pyc` 的運作。總地來說,請盡可能地使用 :mod:"
100+ "`pickle`,沒事不要用 :mod:` marshal`。"
101101
102102#: ../../library/pickle.rst:57
103103msgid ""
@@ -251,7 +251,7 @@ msgid ""
251251"efficiently :doc:`compress <archiving>` pickled data."
252252msgstr ""
253253"以預設設定來說,:mod:`pickle` 使用相對緊湊的二進位形式來儲存資料。如果你需要"
254- "盡可能地縮小檔案大小,你可以\\\\ :doc:`壓縮 <archiving>`\\ \\ 封裝的資料。"
254+ "盡可能地縮小檔案大小,你可以\\ :doc:`壓縮 <archiving>`\\ 封裝的資料。"
255255
256256#: ../../library/pickle.rst:135
257257msgid ""
@@ -412,8 +412,8 @@ msgid ""
412412"Write the pickled representation of the object *obj* to the open :term:`file "
413413"object` *file*. This is equivalent to ``Pickler(file, protocol).dump(obj)``."
414414msgstr ""
415- "將被封裝成 pickle 形式的 *obj* 寫入到已開啟的\\\\ term:`檔案物件 < file "
416- "object>` *file*。 這等效於\\ \\ ``Pickler(file, protocol).dump(obj)``。"
415+ "將被封裝成 pickle 形式的 *obj* 寫入到已開啟的\\ : term:`fileobject` *file*。 "
416+ "這等效於\\ ``Pickler(file, protocol).dump(obj)``。"
417417
418418#: ../../library/pickle.rst:222
419419msgid ""
@@ -685,8 +685,11 @@ msgid ""
685685"and can optionally return :data:`NotImplemented` to fallback on :attr:"
686686"`dispatch_table`-registered reducers to pickle ``obj``."
687687msgstr ""
688- "傳 :data:`NotImplemented` 以退回(fallback)並改為使用 :attr:"
689- "`dispatch_table` 中登錄的縮減方法來封裝 ``obj``。"
688+ "一個可以在 :class:`Pickler` 子類別中被定義的縮減器(reducer)。這個方法的優先"
689+ "度高於任何其他 :attr:`分派表 <dispatch_table>` 中的縮減器。他應該要有和 :"
690+ "meth:`~object.__reduce__` 方法相同的函數界面,且可以可選地回傳 :data:"
691+ "`NotImplemented` 以退回(fallback)使用 :attr:`分派表 <dispatch_table>` 中登"
692+ "錄的縮減方法來封裝 ``obj``。"
690693
691694#: ../../library/pickle.rst:379
692695msgid "For a detailed example, see :ref:`reducer_override`."
@@ -744,7 +747,7 @@ msgid ""
744747"datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by "
745748"Python 2."
746749msgstr ""
747- "可選引數 *fix_imports*, *encoding* 和 *errors* 用來控制 Python 2 pickle 資料"
750+ "可選引數 *fix_imports*、 *encoding* 和 *errors* 用來控制 Python 2 pickle 資料"
748751"的相容性支援。如果 *fix_imports* 為 true,則 pickle 模組會嘗試將舊的 Python "
749752"2 模組名稱映射到 Python 3 中使用的新名稱。*encoding* 和 *errors* 告訴 pickle "
750753"模組如何解碼由 Python 2 pickle 封裝的 8 位元字串實例;*encoding* 和 *errors* "
@@ -760,9 +763,9 @@ msgid ""
760763"*buffer_callback* argument was ``None`` when a :class:`Pickler` was "
761764"instantiated (or when :func:`dump` or :func:`dumps` was called)."
762765msgstr ""
763- "如果 *buffers* 是 ``None``(預設值),那麼去序列化所需的所有資料都必須已經包 "
764- "含在 pickle 串流中。這意味著當初在建立對應的 :class:`Pickler` 時(或在呼叫 : "
765- "func:`dump` 或 :func:`dumps` 時)*buffer_callback* 引數必須為 ``None``。"
766+ "如果 *buffers* 是 ``None``\\ (預設值),那麼去序列化所需的所有資料都必須已經 "
767+ "包含在 pickle 串流中。這意味著當初在建立對應的 :class:`Pickler` 時(或在呼 "
768+ "叫 : func:`dump` 或 :func:`dumps` 時)*buffer_callback* 引數必須為 ``None``。"
766769
767770#: ../../library/pickle.rst:424
768771msgid ""
@@ -772,8 +775,8 @@ msgid ""
772775"the *buffer_callback* of a Pickler object."
773776msgstr ""
774777"如果 *buffers* 不是 ``None``,則其應該是一個可疊代物件,內含數個支援緩衝區的"
775- "物件,並且每當 pickle 串流引用一個 :ref:`帶外 <pickle-oob>` 緩衝區視圖時將會 "
776- "被照順序消耗 。這些緩衝資料當初建立時應已按照順序給定予 Pickler 物件中的 "
778+ "物件,並且每當 pickle 串流引用一個\\ :ref:`帶外 <pickle-oob>`\\ 緩衝區視圖時 "
779+ "將會被照順序消耗 。這些緩衝資料當初建立時應已按照順序給定予 Pickler 物件中的 "
777780"*buffer_callback*。"
778781
779782#: ../../library/pickle.rst:434
@@ -816,7 +819,7 @@ msgid ""
816819"`pickle-restrict` for details."
817820msgstr ""
818821"子類別可以覆寫此方法以控制可以載入哪些類型的物件、以及如何載入它們,從而潛在"
819- "地降低安全性風險。詳情請參考 :ref:`pickle-restrict`。"
822+ "地降低安全性風險。詳情請參考\\ :ref:`pickle-restrict`。"
820823
821824#: ../../library/pickle.rst:460
822825msgid ""
@@ -836,8 +839,8 @@ msgid ""
836839"object` or a N-dimensional array."
837840msgstr ""
838841"一個表示了含有可封裝數據緩衝區的包裝函數(wrapper function)。*buffer* 必須是"
839- "一個 :ref:`提供緩衝區 <bufferobjects>` 的物件,例如一個 :term:`類位元組物件"
840- "( bytes-like object) ` 或 N 維陣列。"
842+ "一個 :ref:`提供緩衝區 <bufferobjects>` 的物件,例如一個 :term:`類位元組物件 "
843+ "< bytes-like object> ` 或 N 維陣列。"
841844
842845#: ../../library/pickle.rst:468
843846msgid ""
@@ -855,9 +858,9 @@ msgid ""
855858"oob>`."
856859msgstr ""
857860":class:`PickleBuffer` 物件僅能由 5 版或以上的 pickle 協定進行封裝。該物件亦能"
858- "被作為帶外資料來進行:ref:`帶外資料序列化 <pickle-oob>`"
861+ "被作為帶外資料來進行\\ :ref:`帶外資料序列化 <pickle-oob>`"
859862
860- # SkyLull: oh boy ... 好多術語...
863+ # SkyLull: oh... 好多術語...
861864# format B: https://learn.microsoft.com/zh-tw/dotnet/standard/base-
862865# types/standard-numeric-format-strings#BFormatString
863866# C-contiguous, Fortran-contiguous: https://stackoverflow.com/a/26999092
@@ -1304,7 +1307,7 @@ msgstr ""
13041307"可選項。一個用來提供連續項目的疊代器(而非序列)。這些項目將個別透過 ``obj."
13051308"append(item)`` 方法或成批次地透過 ``obj.extend(list_of_items)`` 方法被附加到"
13061309"物件中。主要用於串列(list)子類別,但只要其他類別具有相應的 :ref:`append 和 "
1307- "extend 方法 <typesseq-common>`和相同的輸入特徵(signature)就也可以使用。 "
1310+ "extend 方法 <typesseq-common>`\\ 和相同的輸入特徵(signature)就也可以使用。 "
13081311"(如何選擇使用 :meth:`!append` 或 :meth:`!extend` 方法將取決於所選用的 "
13091312"pickle 協定版本以及要附加的項目數量,因此必須同時支援這兩種方法。)"
13101313
@@ -1988,8 +1991,8 @@ msgid ""
19881991"graph. Buffers accumulated by the *buffer_callback* will not see their data "
19891992"copied into the pickle stream, only a cheap marker will be inserted."
19901993msgstr ""
1991- "傳送端需要傳遞一個調用緩衝區的回呼函數給 :class:`Pickler`(或 :func:`dump` "
1992- "或 :func:`dumps` 函數)的 *buffer_callback* 引數,使每次生成 :class:"
1994+ "傳送端需要傳遞一個調用緩衝區的回呼函數給 :class:`Pickler`\\ (或 :func:"
1995+ "`dump` 或 :func:`dumps` 函數)的 *buffer_callback* 引數,使每次生成 :class:"
19931996"`PickleBuffer` 時,該物件在處理物件圖時能被呼叫。除了一個簡易標記以外,由 "
19941997"*buffer_callback* 累積的緩衝區資料不會被複製到 pickle 串流中。"
19951998
@@ -2003,11 +2006,11 @@ msgid ""
20032006"reconstructors of the objects whose pickling produced the original :class:"
20042007"`PickleBuffer` objects."
20052008msgstr ""
2006- "接收端需要傳遞一個緩衝區物件給 :class:`Unpickler`(或 :func:`load` 或:func :"
2007- "`loads` 函式)的 *buffers* 引數。該物件須是一個可疊代的(iterable)緩衝區 "
2008- "(buffer)物件,其中包含傳遞給 *buffer_callback* 的緩衝區物件。這個可疊代物件 "
2009- "的緩衝區順序應該與它們當初被封裝時傳遞給 *buffer_callback* 的順序相同。這些緩 "
2010- "衝區將提供物件重建所需的資料 ,以使重建器能還原出那個當時產生了 :class:"
2009+ "接收端需要傳遞一個緩衝區物件給 :class:`Unpickler`\\ (或 :func:`load` 或 :"
2010+ "func: `loads` 函式)的 *buffers* 引數。該物件須是一個可疊代的(iterable)緩衝 "
2011+ "區 (buffer)物件,其中包含傳遞給 *buffer_callback* 的緩衝區物件。這個可疊代物 "
2012+ "件的緩衝區順序應該與它們當初被封裝時傳遞給 *buffer_callback* 的順序相同。這些 "
2013+ "緩衝區將提供物件重建所需的資料 ,以使重建器能還原出那個當時產生了 :class:"
20112014"`PickleBuffer` 的物件。"
20122015
20132016#: ../../library/pickle.rst:999