docs(library/pickle.po): editing, up to line 778

Author: SkyLull

library/pickle.po

@@ -194,7 +194,9 @@ msgstr ""
 "JSON 具有高互通性（interoperability）且在 Python 以外的環境也被大量利用，但 "
 "pickle 只能在 Python 內使用。"
 
-# Skylull: introspection, introspection facilities
+# Skylull: [t]
+# introspection -> 自省
+# introspection facilities -> 自省措施
 # https://zh.wikipedia.org/wiki/%E5%86%85%E7%9C%81_(%E8%AE%A1%E7%AE%97%E6%9C%BA%E7%A7%91%E5%AD%A6)
 # https://book.pythontips.com/en/latest/object_introspection.html
 # https://www.geeksforgeeks.org/code-introspection-in-python/
@@ -207,7 +209,7 @@ msgid ""
 "`specific object APIs <pickle-inst>`);"
 msgstr ""
 "預設狀態下的 JSON 只能紀錄一小部份的 Python 內建型別，且無法紀錄自訂類別；但"
-"透過 Python 的自省功能，pickle 可以紀錄絕大多數的 Python 型別（其他比較複雜的"
+"透過 Python 的自省措施，pickle 可以紀錄絕大多數的 Python 型別（其他比較複雜的"
 "狀況也可以透過實作 :ref:`specific object APIs <pickle-inst>` 來解決）；"
 
 #: ../../library/pickle.rst:110
@@ -321,6 +323,13 @@ msgstr ""
 "版本 5 的協定在 Python 3.8 被新增。現在能支援帶外資料（Out-of-band data）並加"
 "速帶內資料的處理速度。請參閱 :pep:`574` 以了解第 5 版協定改進的細節。"
 
+# SkyLull: [t]
+# persistent -> 持久
+# data persistent -> 資料持久化
+# https://zh.wikipedia.org/zh-
+# tw/%E5%8F%AF%E6%8C%81%E4%B9%85%E5%8C%96%E6%95%B0%E6%8D%AE%E7%BB%93%E6%9E%84
+# https://1fly2sky.wordpress.com/2016/04/05/%E6%8C%81%E4%B9%85%E5%B1%A4data-
+# persistence-layer/
 #: ../../library/pickle.rst:168
 msgid ""
 "Serialization is a more primitive notion than persistence; although :mod:"
@@ -354,7 +363,7 @@ msgid ""
 "de-serialization, you can create a :class:`Pickler` or an :class:`Unpickler` "
 "object, respectively."
 msgstr ""
-"想要序列化一個物件，你只需要呼叫 :func:`dumps` 函數。而當你想要去序列化一個資"
+"想要序列化一個物件，你只需要呼叫 :func:`dumps` 函式。而當你想要去序列化一個資"
 "料流時，你只需要呼叫 :func:`loads` 即可。不過，若你希望能各自對序列化和去序列"
 "化的過程中有更多的掌控度，你可以自訂一個 :class:`Pickler` 或 :class:"
 "`Unpickler` 物件。"
@@ -370,7 +379,7 @@ msgid ""
 "func:`dump` and :func:`dumps` as well as the :class:`Pickler` constructor."
 msgstr ""
 "一個整數，表示可使用的最高\\ :ref:`協定版本 <pickle-protocols>`。這個值可作"
-"為 *protocol* 的數值傳給 :func:`dump` 和 :func:`dumps` 函數以及 :class:"
+"為 *protocol* 的數值傳給 :func:`dump` 和 :func:`dumps` 函式以及 :class:"
 "`Pickler` 建構式。"
 
 #: ../../library/pickle.rst:200
@@ -396,7 +405,7 @@ msgstr "預設協定版本為 4。"
 msgid ""
 "The :mod:`pickle` module provides the following functions to make the "
 "pickling process more convenient:"
-msgstr ":mod:`pickle` 模組提供下列函數來簡化封裝的過程："
+msgstr ":mod:`pickle` 模組提供下列函式來簡化封裝的過程："
 
 #: ../../library/pickle.rst:218
 msgid ""
@@ -567,7 +576,10 @@ msgstr ""
 "的新模組名稱轉換為 Python 2 所支援的舊名，以讓 Python 2 能正確地讀取此資料"
 "流。"
 
-# SkyLull: 以下幾個關於 buffer_callback 的翻譯需要進一步的校對。何謂out-of-band? buffer view 應作何翻譯？
+# SkyLull: 以下幾個關於 buffer_callback 的翻譯需要進一步的校對。何謂out-of-band? buffer view
+# 應作何翻譯？
+# out-of-band 目前參考 https://kb.synology.com/zh-
+# tw/DSM/tutorial/Quick_Start_OOB_Management `帶外管理` 譯作 `帶外`
 #: ../../library/pickle.rst:317
 msgid ""
 "If *buffer_callback* is ``None`` (the default), buffer views are serialized "
@@ -583,8 +595,8 @@ msgid ""
 "``None``), the given buffer is :ref:`out-of-band <pickle-oob>`; otherwise "
 "the buffer is serialized in-band, i.e. inside the pickle stream."
 msgstr ""
-"如果 *buffer_callback* 不是 ``None``，則它可以被多次呼叫並傳遞一個緩衝區的視"
-"圖。如果回呼函數回傳一個假值（例如 ``None``），則所給的緩衝區將被視為 :ref:`"
+"如果 *buffer_callback* 不是 ``None``，則它可以被多次呼叫並回傳一個緩衝區的視"
+"圖。如果回呼函式回傳一個假值（例如 ``None``），則所給的緩衝區將被視為 :ref:`"
 "帶外資料 <pickle-oob>`；否則，該緩衝區將被視為 pickle 串流的帶內資料被序列"
 "化。"
 
@@ -606,7 +618,7 @@ msgstr "將已封裝（pickled）的 *obj* 寫入已在建構式中開啟的對
 msgid "Do nothing by default.  This exists so a subclass can override it."
 msgstr ""
 "預設不進行任何動作。這是一種抽象方法，用於讓後續繼承這個類別的物件可以覆寫本"
-"方法函數。"
+"方法函式。"
 
 #: ../../library/pickle.rst:340
 msgid ""
@@ -625,6 +637,13 @@ msgstr ""
 msgid "See :ref:`pickle-persistent` for details and examples of uses."
 msgstr "關於細節與用法範例請見 :ref:`pickle-persistent`。"
 
+# SkyLull: [t]
+# dispatch table -> 調度表
+# https://zh.wiktionary.org/zh-hant/dispatch_table
+# reduce -> 縮減
+# reduction function -> 縮減函式
+# 這個是指reduce()函式類型的運算，類似sql的aggregation類型運算，故參閱以下內文，譯為縮減
+# https://support.google.com/docs/answer/12657238?hl=zh-Hant
 #: ../../library/pickle.rst:350
 msgid ""
 "A pickler object's dispatch table is a registry of *reduction functions* of "
@@ -633,6 +652,10 @@ msgid ""
 "reduction function takes a single argument of the associated class and "
 "should conform to the same interface as a :meth:`~object.__reduce__` method."
 msgstr ""
+"封裝器（pickler）物件含有的的調度表是一個 *縮減函式* （reduction function）的"
+"註冊表，可以使用 :func:`copyreg.pickle` 來宣告這類縮減函式。它是一個以類別為"
+"鍵、還原函式為值的映射表。縮減函式應準備接收一個對應類別的引數，並應遵循與 :"
+"meth:`~object.__reduce__` 方法相同的介面。"
 
 #: ../../library/pickle.rst:358
 msgid ""
@@ -644,6 +667,11 @@ msgid ""
 "`dispatch_table` attribute then this will be used as the default dispatch "
 "table for instances of that class."
 msgstr ""
+"預設情況下，封裝器（pickler）物件不會有 :attr:`dispatch_table` 屬性，而是會使"
+"用由 :mod:`copyreg` 模組管理的全域調度表。不過，若要自訂某個封裝器（pickler）"
+"物件的序列化行為，可以將 :attr:`dispatch_table` 屬性設置為類字典物件。另外，"
+"如果 :class:`Pickler` 的子類別具有 :attr:`dispatch_table` 屬性，那麼這個屬性"
+"將作為該子類別實例的預設調度表。"
 
 #: ../../library/pickle.rst:367
 msgid "See :ref:`pickle-dispatch` for usage examples."
@@ -657,10 +685,12 @@ 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``。"
 
 #: ../../library/pickle.rst:379
 msgid "For a detailed example, see :ref:`reducer_override`."
-msgstr ""
+msgstr "請查閱 :ref:`reducer_override` 來參考其他較詳細的範例。"
 
 #: ../../library/pickle.rst:385
 msgid ""
@@ -669,20 +699,23 @@ msgid ""
 "superfluous PUT opcodes.  It should not be used with self-referential "
 "objects, doing otherwise will cause :class:`Pickler` to recurse infinitely."
 msgstr ""
+"已棄用。如果設置為 true，將啟用快速模式。快速模式會停用備忘（memo），因此能透"
+"過不產生多餘的 PUT 操作碼（OpCode）來加速封裝過程。它不應被用於自我參照物件，"
+"否則將導致 :class:`Pickler` 陷入無限遞迴。"
 
 #: ../../library/pickle.rst:391
 msgid "Use :func:`pickletools.optimize` if you need more compact pickles."
-msgstr ""
+msgstr "使用 :func:`pickletools.optimize` 以獲得更緊湊的 pickle 輸出。"
 
 #: ../../library/pickle.rst:396
 msgid "This takes a binary file for reading a pickle data stream."
-msgstr ""
+msgstr "這個物件接受一個二進位檔案 *file* 來從中讀取 pickle 資料流。"
 
 #: ../../library/pickle.rst:398
 msgid ""
 "The protocol version of the pickle is detected automatically, so no protocol "
 "argument is needed."
-msgstr ""
+msgstr "協定版本號會被自動偵測，所以不需要在這邊手動輸入。"
 
 #: ../../library/pickle.rst:401
 msgid ""
@@ -693,6 +726,10 @@ msgid ""
 "binary reading, an :class:`io.BytesIO` object, or any other custom object "
 "that meets this interface."
 msgstr ""
+"參數 *file* 必須擁有三個方法，分別是接受整數作為引數的 read() 方法、接受緩衝"
+"區作為引數的 readinto() 方法以及不需要引數的 readline() 方法，如同在 :class:"
+"`io.BufferedIOBase` 的介面一樣。因此，*file* 可以是一個以二進位讀取模式開啟的"
+"檔案、一個 :class:`io.BytesIO` 物件、或任何符合此介面的自訂物件。"
 
 #: ../../library/pickle.rst:408
 msgid ""
@@ -707,6 +744,14 @@ msgid ""
 "datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by "
 "Python 2."
 msgstr ""
+"可選引數 *fix_imports*，*encoding* 和 *errors* 用來控制 Python 2 pickle 資料"
+"的相容性支援。如果 *fix_imports* 為 true，則 pickle 模組會嘗試將舊的 Python "
+"2 模組名稱映射到 Python 3 中使用的新名稱。*encoding* 和 *errors* 告訴 pickle "
+"模組如何解碼由 Python 2 pickle 封裝的 8 位元字串實例；*encoding* 和 *errors* "
+"預設分別為 'ASCII' 和 'strict'。*encoding* 可以設定為 'bytes' 以將這些 8 位元"
+"字串實例讀為位元組物件。而由 Python 2 封裝的 NumPy 陣列、:class:`~datetime."
+"datetime`、:class:`~datetime.date` 和 :class:`~datetime.time` 的實例則必須使"
+"用 ``encoding='latin1'`` 來拆封。"
 
 #: ../../library/pickle.rst:419
 msgid ""
@@ -715,6 +760,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``。"
 
 #: ../../library/pickle.rst:424
 msgid ""
@@ -723,6 +771,10 @@ msgid ""
 "of-band <pickle-oob>` buffer view.  Such buffers have been given in order to "
 "the *buffer_callback* of a Pickler object."
 msgstr ""
+"如果 *buffers* 不是 ``None``，則其應該是一個可疊代物件，內含數個支援緩衝區的"
+"物件，並且每當 pickle 串流引用一個 :ref:`帶外 <pickle-oob>` 緩衝區視圖時將會"
+"被照順序消耗。這些緩衝資料當初建立時應已按照順序給定予 Pickler 物件中的 "
+"*buffer_callback*。"
 
 #: ../../library/pickle.rst:434
 msgid ""