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

SkyLull · SkyLull · commit 080d0aad713a · 2024-09-13T20:19:13.000+08:00
diff --git a/library/pickle.po b/library/pickle.po
@@ -1184,6 +1184,9 @@ msgid ""
 "unified interface for retrieving the data necessary for pickling and copying "
 "objects. [#]_"
 msgstr ""
+"如稍後所演示，pickle 並不直接使用上述方法。這些方法實際上是實作了 :meth:"
+"`~object.__reduce__` 特殊方法的拷貝協定（copy protocol）。拷貝協定提供了統一"
+"的介面，以檢索進行封裝及複製物件時所需的資料。 [#]_"
 
 #: ../../library/pickle.rst:672
 msgid ""
@@ -1194,13 +1197,20 @@ msgid ""
 "We will show, however, cases where using :meth:`!__reduce__` is the only "
 "option or leads to more efficient pickling or both."
 msgstr ""
+"直接在類別中實作 :meth:`~object.__reduce__` 雖然功能強大但卻容易導致出錯。因"
+"此，設計類別者應盡可能使用高階介面（例如，:meth:`~object."
+"__getnewargs_ex__`、:meth:`~object.__getstate__` 和 :meth:`~object."
+"__setstate__`）。不過，我們也將展示一些特例狀況，在這些狀況中，使用 :meth:`!"
+"__reduce__` 可能是唯一的選擇、是更有效率的封裝方法或二者兼備。"
 
 #: ../../library/pickle.rst:681
 msgid ""
 "The interface is currently defined as follows.  The :meth:`__reduce__` "
 "method takes no argument and shall return either a string or preferably a "
 "tuple (the returned object is often referred to as the \"reduce value\")."
 msgstr ""
+"目前的介面定義如下。 :meth:`__reduce__` 方法不接受引數，且應回傳一個字串或一"
+"個元組（元組一般而言是較佳的選擇；所回傳的物件通常稱為「縮減值」）。"
 
 #: ../../library/pickle.rst:685
 msgid ""
@@ -1209,25 +1219,32 @@ msgid ""
 "module; the pickle module searches the module namespace to determine the "
 "object's module.  This behaviour is typically useful for singletons."
 msgstr ""
+"如果回傳的是字串，該字串應被解讀為一個全域變數的名稱。它應是該物件相對其所在"
+"模組的本地名稱；pickle 模組會在模組命名空間中尋找，以確定該物件所在的模組。這"
+"種行為通常對於單例物件特別有用。"
 
 #: ../../library/pickle.rst:690
 msgid ""
 "When a tuple is returned, it must be between two and six items long. "
 "Optional items can either be omitted, or ``None`` can be provided as their "
 "value.  The semantics of each item are in order:"
 msgstr ""
+"當返回一個元組時，其長度必須介於兩至六項元素之間。可選項可以被省略，或者其值"
+"可以被設為 ``None``。各項物件的語意依序為："
 
 #: ../../library/pickle.rst:696
 msgid ""
 "A callable object that will be called to create the initial version of the "
 "object."
-msgstr ""
+msgstr "一個將會被呼叫來創建初始版本物件的可呼叫物件。"
 
 #: ../../library/pickle.rst:699
 msgid ""
 "A tuple of arguments for the callable object.  An empty tuple must be given "
 "if the callable does not accept any argument."
 msgstr ""
+"一個用於傳遞引數給前述物件的元組。如果前述物件不接受引數輸入，則你仍應在這裡"
+"給定一個空元組。"
 
 #: ../../library/pickle.rst:702
 msgid ""
@@ -1236,6 +1253,9 @@ msgid ""
 "method then, the value must be a dictionary and it will be added to the "
 "object's :attr:`~object.__dict__` attribute."
 msgstr ""
+"可選項。物件狀態。如前所述，會被傳遞給該物件的 :meth:`__setstate__` 方法。如"
+"果該物件沒有實作此方法，則本值必須是一個字典，且其將會被新增到物件的 :attr:"
+"`~object.__dict__` 屬性中。"
 
 #: ../../library/pickle.rst:707
 msgid ""
@@ -1248,6 +1268,12 @@ msgid ""
 "which pickle protocol version is used as well as the number of items to "
 "append, so both must be supported.)"
 msgstr ""
+"可選項。一個用來提供連續項目的疊代器（而非序列）。這些項目將個別透過 ``obj."
+"append(item)`` 方法或成批次地透過 ``obj.extend(list_of_items)`` 方法被附加到"
+"物件中。主要用於串列（list）子類別，但只要其他類別具有相應的 :ref:`append 和 "
+"extend 方法 <typesseq-common>`就也可以使用。 （如何選擇使用 :meth:`!append` "
+"或 :meth:`!extend` 方法將取決於所選用的 pickle 協定版本以及要附加的項目數量，"
+"因此必須同時支援這兩種方法。）"
 
 #: ../../library/pickle.rst:717
 msgid ""
@@ -1256,6 +1282,9 @@ msgid ""
 "value``.  This is primarily used for dictionary subclasses, but may be used "
 "by other classes as long as they implement :meth:`__setitem__`."
 msgstr ""
+"可選項。一個產生連續鍵值對的疊代器（不是序列）。這些項目將以 ``obj[key] = "
+"value`` 方式被儲存到物件中。主要用於字典（dictionary）子類別，但只要有實現"
+"了 :meth:`__setitem__` 的其他類別也可以使用。"
 
 #: ../../library/pickle.rst:722
 msgid ""
