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

SkyLull · SkyLull · commit 9c6ac561e1d7 · 2024-08-16T00:23:06.000+08:00
diff --git a/library/pickle.po b/library/pickle.po
@@ -215,16 +215,20 @@ msgid ""
 "Unlike pickle, deserializing untrusted JSON does not in itself create an "
 "arbitrary code execution vulnerability."
 msgstr ""
+"去序列化不安全的 JSON 不會產生任意程式執行的風險，但去序列化不安全的 pickle "
+"會。"
 
 #: ../../library/pickle.rst:114
 msgid ""
 "The :mod:`json` module: a standard library module allowing JSON "
 "serialization and deserialization."
 msgstr ""
+":mod:`json` module: 是標準函式庫的一部分，可讓使用者進行 JSON 的序列化與去序"
+"列化。"
 
 #: ../../library/pickle.rst:121
 msgid "Data stream format"
-msgstr ""
+msgstr "資料串流格式"
 
 #: ../../library/pickle.rst:126
 msgid ""
@@ -234,53 +238,68 @@ msgid ""
 "that non-Python programs may not be able to reconstruct pickled Python "
 "objects."
 msgstr ""
+":mod:`pickle` 使用的資料格式是針對 Python 而設計的。好處是他不會受到外部標準"
+"（像是 JSON 或 XDR，而 XDR 無法紀錄指標共用）的限制；不過這也代表其他不是 "
+"Python 的程式可能無法重建 pickle 封裝的 Python 物件。"
 
 #: ../../library/pickle.rst:131
 msgid ""
 "By default, the :mod:`pickle` data format uses a relatively compact binary "
 "representation.  If you need optimal size characteristics, you can "
 "efficiently :doc:`compress <archiving>` pickled data."
 msgstr ""
+"以預設設定來說，:mod:`pickle` 使用相對緊湊的二進位形式來儲存資料。如果你需要"
+"盡可能地縮小檔案大小，你可以\\\\ :doc:`壓縮 <archiving>`\\\\ 封裝的資料。"
 
 #: ../../library/pickle.rst:135
 msgid ""
 "The module :mod:`pickletools` contains tools for analyzing data streams "
 "generated by :mod:`pickle`.  :mod:`pickletools` source code has extensive "
 "comments about opcodes used by pickle protocols."
 msgstr ""
+":mod:`pickletools` 含有工具可分析 :mod:`pickle` 所產生的資料流。:mod:"
+"`pickletools` 的源始碼詳細地記載了所有 pickle 協定的操作碼（opcode）。"
 
 #: ../../library/pickle.rst:139
 msgid ""
 "There are currently 6 different protocols which can be used for pickling. "
 "The higher the protocol used, the more recent the version of Python needed "
 "to read the pickle produced."
 msgstr ""
+"截至目前為止，共有六種不同版本的協定可用於封裝  pickle。數字越大版本代表你需"
+"要使用越新的 Python 版本來拆封相應的 pickle 封裝。"
 
 #: ../../library/pickle.rst:143
 msgid ""
 "Protocol version 0 is the original \"human-readable\" protocol and is "
 "backwards compatible with earlier versions of Python."
 msgstr ""
+"版本 0 的協定是最初「人類可讀」的版本，且可以向前支援早期版本的 Python。"
 
 #: ../../library/pickle.rst:146
 msgid ""
 "Protocol version 1 is an old binary format which is also compatible with "
 "earlier versions of Python."
-msgstr ""
+msgstr "版本 1 的協定使用舊的二進位格式，一樣能向前支援早期版本的 Python。"
 
 #: ../../library/pickle.rst:149
 msgid ""
 "Protocol version 2 was introduced in Python 2.3.  It provides much more "
 "efficient pickling of :term:`new-style classes <new-style class>`.  Refer "
 "to :pep:`307` for information about improvements brought by protocol 2."
 msgstr ""
+"版本 2 的協定在 Python 2.3 中初次被引入。其可提供更高效率的 :term:`new-style "
+"classes <new-style class>` 封裝過程。請參閱 :pep:`307` 以了解版本 2 帶來的改"
+"進。"
 
 #: ../../library/pickle.rst:153
 msgid ""
 "Protocol version 3 was added in Python 3.0.  It has explicit support for :"
 "class:`bytes` objects and cannot be unpickled by Python 2.x.  This was the "
 "default protocol in Python 3.0--3.7."
 msgstr ""
+"版本 3 的協定在 Python 3.0 被新增。現在能支援封裝 :class:`bytes` 的物件且無法"
+"被 2.x 版本的 Python 拆封。在 3.0～3.7 的 Python 預設使用 3 版協定。"
 
 #: ../../library/pickle.rst:157
 msgid ""
@@ -289,6 +308,9 @@ msgid ""
 "optimizations.  It is the default protocol starting with Python 3.8. Refer "
 "to :pep:`3154` for information about improvements brought by protocol 4."
 msgstr ""
+"版本 4 的協定在 Python 3.4 被新增。現在能支援超大物件的封裝、更多種型別的物件"
+"以及針對部份資料格式的儲存進行最佳化。從 Python 3.8 起，預設使用第 4 版協定。"
+"請參閱 :pep:`3154` 以了解第 4 版協定改進的細節。"
 
 #: ../../library/pickle.rst:163
 msgid ""
@@ -310,6 +332,12 @@ msgid ""
 "database.  The :mod:`shelve` module provides a simple interface to pickle "
 "and unpickle objects on DBM-style database files."
 msgstr ""
+"資料序列化是一個比資料持久化更早期的概念；雖然 :mod:`pickle` 可以讀寫檔案物"
+"件，但它並不處理命名持久物件的問題，也不處理對持久物件並行存取，一個更棘手的"
+"問題。:mod:`pickle` 模組可以將複雜物件轉換成位元組串流，也可以將位元組串流轉"
+"換回具有相同原始內部結構的物件。對這些位元組串流最明顯的處理方式大概是將它們"
+"寫入檔案中，但也可能將它們透過網路傳送或儲存在一個資料庫中。:mod:`shelve` 模"
+"組提供了一個簡單的介面來在 DBM 風格的資料庫檔案中進行物件的封裝和拆封的操作。"
 
 #: ../../library/pickle.rst:181
 msgid "Module Interface"
@@ -323,6 +351,10 @@ msgid ""
 "de-serialization, you can create a :class:`Pickler` or an :class:`Unpickler` "
 "object, respectively."
 msgstr ""
+"想要序列化一個物件，你只需要呼叫 :func:`dumps` 函數。而當你想要去序列化一個資"
+"料流時，你只需要呼叫 :func:`loads` 即可。不過，若你希望能各自對序列化和去序列"
+"化的過程中有更多的掌控度，你可以自訂一個 :class:`Pickler` 或 :class:"
+"`Unpickler` 物件。"
 
 #: ../../library/pickle.rst:188
 msgid "The :mod:`pickle` module provides the following constants:"
