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

Author: SkyLull

library/pickle.po

@@ -2,6 +2,7 @@
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
+# Skylull, 2024
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
@@ -25,6 +26,14 @@ msgstr ":mod:`!pickle` --- Python 物件序列化"
 msgid "**Source code:** :source:`Lib/pickle.py`"
 msgstr "**原始碼：**\\ :source:`Lib/pickle.py`"
 
+# Skylull: 我對 `pickle` 的命名原因進行了簡單的搜尋，只找到一則討論
+# https://stackoverflow.com/questions/27324986/pickles-why-are-they-called-
+# that
+# 其中表示這名字很可能只是為了隨便找一個p開頭的單字、或原始開發人員的內部玩笑造成的約定俗成。也有人表示醃製黃瓜（pickle-
+# ing）的目標就是保存和存放，所以取了這個名字。
+# 無論如何似乎沒有一個定論。
+# 因為不確定是否與醃漬的這個梗有關，我暫時選擇使用 `封裝` 與 `拆封` 作為譯文，大致保存那個把東西處裡後裝起來的感覺但又不至於太奇怪。
+# 唯一需要擔心的是是否有與 `encapsulation` （封裝，網路協定名詞）或 `package`（封包，網路協定名詞）搞混的可能。
 #: ../../library/pickle.rst:22
 msgid ""
 "The :mod:`pickle` module implements binary protocols for serializing and de-"
@@ -36,29 +45,40 @@ msgid ""
 "\"serialization\", \"marshalling,\" [#]_ or \"flattening\"; however, to "
 "avoid confusion, the terms used here are \"pickling\" and \"unpickling\"."
 msgstr ""
+":mod:`pickle` 模組實作的是一個在二進位層級上對 Python 物件進行序列化"
+"（serialize）或去序列化（de-serialize）。*\"Pickling\"* 用於專門指摘將一個 "
+"Python 物件轉換為一個二進位串流的過程，*\"unpickling\"* 則相反，指的是將一個"
+"（來自 :term:`binary file` 或 :term:`bytes-like object` 的）二進位串流轉換回 "
+"Python 物件的過程。Pickling（和 unpickling）的過程也可能被稱作 "
+"\"serialization\", \"marshalling,\" [#]_ 或 \"flattening\"。不過，為了避免混"
+"淆，本文件將統一稱作封裝（pickling）、拆封（unpickling）。"
 
 #: ../../library/pickle.rst:33
 msgid "The ``pickle`` module **is not secure**. Only unpickle data you trust."
-msgstr ""
+msgstr "``pickle`` 模組**並不安全**，切記只拆封你信任的資料。"
 
 #: ../../library/pickle.rst:35
 msgid ""
 "It is possible to construct malicious pickle data which will **execute "
 "arbitrary code during unpickling**. Never unpickle data that could have come "
 "from an untrusted source, or that could have been tampered with."
 msgstr ""
+"pickle 封包是有可能被建立來在拆封的時候**執行任意惡意程式碼**的。絕對不要拆封"
+"任何你無法信任其來源、或可能被修改過的 pickle 封包。"
 
 #: ../../library/pickle.rst:39
 msgid ""
 "Consider signing data with :mod:`hmac` if you need to ensure that it has not "
 "been tampered with."
-msgstr ""
+msgstr "建議你可以使用 :mod:`hmac` 模組來簽署這個封包，以確保其未被修改過。"
 
 #: ../../library/pickle.rst:42
 msgid ""
 "Safer serialization formats such as :mod:`json` may be more appropriate if "
 "you are processing untrusted data. See :ref:`comparison-with-json`."
 msgstr ""
+"如果你在處理不受信任的資料，其他比較安全的序列化格式（例如 :mod:`json`）可能"
+"會更適合。請參照 See :ref:`comparison-with-json` 的說明。"
 
 #: ../../library/pickle.rst:47
 msgid "Relationship to other Python modules"
@@ -75,19 +95,24 @@ msgid ""
 "Python objects.  :mod:`marshal` exists primarily to support Python's :file:`."
 "pyc` files."
 msgstr ""
+"Python 有另一個比較原始的序列化模組叫 :mod:`marshal`，不過其設計目的是為了支"
+"援 Python 的預編譯功能 :file:`.pyc` 運作。總地來說，沒事不要用 :mod:"
+"`marshal`。"
 
 #: ../../library/pickle.rst:57
 msgid ""
 "The :mod:`pickle` module differs from :mod:`marshal` in several significant "
 "ways:"
-msgstr ""
+msgstr ":mod:`pickle` 和 :mod:`marshal` 有幾個明顯不同的地方："
 
 #: ../../library/pickle.rst:59
 msgid ""
 "The :mod:`pickle` module keeps track of the objects it has already "
 "serialized, so that later references to the same object won't be serialized "
 "again. :mod:`marshal` doesn't do this."
 msgstr ""
+":mod:`pickle` 會記住哪些物件已經被序列化過了，稍後再次參照到這個物件的時候才"
+"不會進行重複的序列化。:mod:`marshal` 沒有這個功能。"
 
 #: ../../library/pickle.rst:63
 msgid ""
@@ -101,6 +126,11 @@ msgid ""
 "Shared objects remain shared, which can be very important for mutable "
 "objects."
 msgstr ""
+"這對遞迴物件和物件共用都有影響。遞迴物件是指包含自我參照的物件。這些情況在 "
+"marshal 模組中不會被處理，若嘗試使用 marshal 處理遞迴物件會導致 Python 直譯器"
+"崩潰。物件共用發生在序列化的物件階層中，不同位置對同一物件有多個參照時。:mod:"
+"`pickle` 只會儲存這個被參照的物件一次，並確保所有其他參照指向這個主要的版本。"
+"共用的物件會保持共用，這對於可變（mutable）物件來說非常重要。"
 
 #: ../../library/pickle.rst:72
 msgid ""
@@ -109,6 +139,9 @@ msgid ""
 "transparently, however the class definition must be importable and live in "
 "the same module as when the object was stored."
 msgstr ""
+":mod:`marshal` 無法序列化使用者自訂的類別和的實例。:mod:`pickle` 則可以讓使用"
+"者儲存並還原自訂的類別實例，前提是儲存時該類別的定義存在於與要被儲存的物件所"
+"在的模組中、且可以被引入（import）。"
 
 #: ../../library/pickle.rst:77
 msgid ""
@@ -122,6 +155,11 @@ msgid ""
 "differences if your data is crossing that unique breaking change language "
 "boundary."
 msgstr ""
+":mod:`marshal` 序列化格式無法保證能在不同版本的 Python 之間移植。因為其主要的"
+"作用是支援 :file:`.pyc` 檔案的運作，Python 的實作人員會在需要時實作無法前向相"
+"容的序列化方式。但只要選擇了相容的 pickle 協定，且處理了 Python 2 和 Python "
+"3 之間的資料類型差異，:mod:`pickle` 序列化協定能保證在不同 Python 版本間的相"
+"容性。"
 
 #: ../../library/pickle.rst:90
 msgid "Comparison with ``json``"
@@ -132,24 +170,34 @@ msgid ""
 "There are fundamental differences between the pickle protocols and `JSON "
 "(JavaScript Object Notation) <https://json.org>`_:"
 msgstr ""
+"pickle 協定和 `JSON (JavaScript Object Notation) <https://json.org>`_ 有一些"
+"根本上的不同："
 
 #: ../../library/pickle.rst:95
 msgid ""
 "JSON is a text serialization format (it outputs unicode text, although most "
 "of the time it is then encoded to ``utf-8``), while pickle is a binary "
 "serialization format;"
 msgstr ""
+"JSON 以文字形式作為序列化的輸出（輸出 unicode 文字，但大多數又會被編碼為 "
+"``UTF-8``），而 pickle 則是以二進位形式作為序列化的輸出；"
 
 #: ../../library/pickle.rst:99
 msgid "JSON is human-readable, while pickle is not;"
-msgstr "JSON 是人類可讀的，而 pickle 不是；"
+msgstr "JSON 是人類可讀的，而 pickle 則無法；"
 
 #: ../../library/pickle.rst:101
 msgid ""
 "JSON is interoperable and widely used outside of the Python ecosystem, while "
 "pickle is Python-specific;"
 msgstr ""
+"JSON 具有高互通性（interoperability）且在 Python 以外的環境也被大量利用，但 "
+"pickle 只能在 Python 內使用。"
 
+# Skylull: 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/
 #: ../../library/pickle.rst:104
 msgid ""
 "JSON, by default, can only represent a subset of the Python built-in types, "
@@ -158,6 +206,9 @@ msgid ""
 "introspection facilities; complex cases can be tackled by implementing :ref:"
 "`specific object APIs <pickle-inst>`);"
 msgstr ""
+"預設狀態下的 JSON 只能紀錄一小部份的 Python 內建型別，且無法紀錄自訂類別；但"
+"透過 Python 的自省功能，pickle 可以紀錄絕大多數的 Python 型別（其他比較複雜的"
+"狀況也可以透過實作 :ref:`specific object APIs <pickle-inst>` 來解決）；"
 
 #: ../../library/pickle.rst:110
 msgid ""