Merge branch '3.13' into pickle

library/email.charset.po

@@ -1,5 +1,4 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2022, Python Software Foundation
+# Copyright (C) 2001-2024, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
@@ -20,7 +19,7 @@ msgstr ""
 
 #: ../../library/email.charset.rst:2
 msgid ":mod:`!email.charset`: Representing character sets"
-msgstr ":mod:`!email.charset`：表示字元集合"
+msgstr ":mod:`!email.charset`：字元集合的表示"
 
 #: ../../library/email.charset.rst:7
 msgid "**Source code:** :source:`Lib/email/charset.py`"
@@ -38,7 +37,7 @@ msgstr ""
 msgid ""
 "The remaining text in this section is the original documentation of the "
 "module."
-msgstr "此章節的其餘文字是原始模組的說明文件"
+msgstr "此章節的其餘內容是模組的原始說明文件"
 
 #: ../../library/email.charset.rst:16
 msgid ""
@@ -48,17 +47,17 @@ msgid ""
 "Instances of :class:`Charset` are used in several other modules within the :"
 "mod:`email` package."
 msgstr ""
-"此模組提供一個 class（類別） :class:`Charset` 來表示電子郵件中的字元集合和字"
-"元集合轉換，以及字元集合登錄檔 (registry) 和其他許多便捷的方法以運用此登錄"
-"檔。在 :mod:`email` 套件中有許多其他模組使用 :class:`Charset` 的實例。"
+"此模組提供一個類別 :class:`Charset` 來表示電子郵件訊息中的字元集合和字元集合轉"
+"換，也包含字元集合登錄檔 (registry) 和其他許多運用此登錄檔的便捷方法。:class:"
+"`Charset` 的實例被 :mod:`email` 套件中其他數個模組所使用。"
 
 #: ../../library/email.charset.rst:22
 msgid "Import this class from the :mod:`email.charset` module."
-msgstr "從 :mod:`email.charset` 模組中 import 此類別"
+msgstr "從 :mod:`email.charset` 模組中引入此類別"
 
 #: ../../library/email.charset.rst:27
 msgid "Map character sets to their email properties."
-msgstr ""
+msgstr "將字元集合對映到其電子郵件特性 (properties)。"
 
 #: ../../library/email.charset.rst:29
 msgid ""
@@ -68,13 +67,20 @@ msgid ""
 "codecs.  Given a character set, it will do its best to provide information "
 "on how to use that character set in an email message in an RFC-compliant way."
 msgstr ""
+"此類別提供有關於電子郵件對特定字元集合的規範資訊。考慮到適用之編解碼器 "
+"(codec) 的可用性，它還提供了在字元集合之間進行轉換的便利例行操作 (routine)。"
+"給定一個字元集合，它將盡量提供有關如何以符合 RFC (RFC-compliant) 的方式在電子"
+"郵件訊息中使用該字元集合的資訊。"
 
 #: ../../library/email.charset.rst:35
 msgid ""
 "Certain character sets must be encoded with quoted-printable or base64 when "
 "used in email headers or bodies.  Certain character sets must be converted "
 "outright, and are not allowed in email."
 msgstr ""
+"在電子郵件標頭 (header) 或內文 (body) 用特定字元集合時必須使用可列印字元編碼 "
+"(quoted-printable) 或 base64 來編碼。特定字元集合不允許出現在電子郵件中、必須"
+"被徹底轉換。"
 
 #: ../../library/email.charset.rst:39
 msgid ""
@@ -88,17 +94,26 @@ msgid ""
 "with base64, bodies will not be encoded, but output text will be converted "
 "from the ``euc-jp`` character set to the ``iso-2022-jp`` character set."
 msgstr ""
+"可選的 *input_charset* 描述如下；*input_charset* 會被強制轉換 (coerced) 為小寫。經過"
+"別名標準化 (alias normalize) 後，會進到字元集合登錄檔 (registry) 去查詢此字元"
+"集合使用的標頭編碼、內文編碼以及輸出轉換編解碼器。舉例來說，如果 "
+"*input_charset* 是 ``iso-8859-1``，標頭跟內文會以可列印字元編碼並且不需要輸出"
+"轉換編解碼器。如果 *input_charset* 是 ``euc-jp``，標頭則會被編碼成 base64、內"
+"文不會被編碼，但輸出文字則會從 ``euc-jp`` 字元集合被轉換成 ``iso-2022-jp`` 字"
+"元集合。"
 
 #: ../../library/email.charset.rst:49
 msgid ":class:`Charset` instances have the following data attributes:"
-msgstr ""
+msgstr ":class:`Charset` 實例有以下資料屬性："
 
 #: ../../library/email.charset.rst:53
 msgid ""
 "The initial character set specified.  Common aliases are converted to their "
 "*official* email names (e.g. ``latin_1`` is converted to ``iso-8859-1``).  "
 "Defaults to 7-bit ``us-ascii``."
 msgstr ""
+"指定的初始字元集合。通用別名會被轉換成它們的\\ *官方*\\ 電子郵件名稱（例如："
+"``latin_1`` 會被轉換成 ``iso-8859-1``）。預設為 7 位元 ``us-ascii``。"
 
 #: ../../library/email.charset.rst:60
 msgid ""
@@ -107,13 +122,19 @@ msgid ""
 "``charset.BASE64`` (for base64 encoding), or ``charset.SHORTEST`` for the "
 "shortest of QP or BASE64 encoding. Otherwise, it will be ``None``."
 msgstr ""
+"如果字元集合在被用於電子郵件標頭前必須被編碼的話，這個屬性會被設為 ``charset."
+"QP``\\ （表示可列印字元編碼）、``charset.BASE64``\\ （表示 base64 編碼格式）或"
+"是 ``charset.SHORTEST`` 表示最短的 QP 或是 base64 編碼格式。不然這個屬性會是 "
+"``None``。"
 
 #: ../../library/email.charset.rst:69
 msgid ""
 "Same as *header_encoding*, but describes the encoding for the mail message's "
 "body, which indeed may be different than the header encoding. ``charset."
 "SHORTEST`` is not allowed for *body_encoding*."
 msgstr ""
+"與 *header_encoding* 相同，但表示郵件訊息內文的編碼，與上述的標頭編碼有可能不"
+"同。``charset.SHORTEST`` 是不允許於 *body_encoding* 使用的。"
 
 #: ../../library/email.charset.rst:76
 msgid ""
@@ -122,28 +143,35 @@ msgid ""
 "will contain the name of the character set output will be converted to. "
 "Otherwise, it will be ``None``."
 msgstr ""
+"部分的字元集合在用於電子郵件的標頭或內文前必須先被轉換。如果 *input_charset* "
+"是這些字元集合的其中之一，這個屬性將會包含輸出時轉換成的字元集合名稱。不然這"
+"個屬性則為 ``None``。"
 
 #: ../../library/email.charset.rst:84
 msgid ""
 "The name of the Python codec used to convert the *input_charset* to "
 "Unicode.  If no conversion codec is necessary, this attribute will be "
 "``None``."
 msgstr ""
+"用於將 *input_charset* 轉換成 Unicode 的 Python 編解碼器的名稱。如果不需要轉"
+"換編解碼器，這個屬性為 ``None``。"
 
 #: ../../library/email.charset.rst:91
 msgid ""
 "The name of the Python codec used to convert Unicode to the "
 "*output_charset*.  If no conversion codec is necessary, this attribute will "
 "have the same value as the *input_codec*."
 msgstr ""
+"用於將 Unicode 轉換成 *output_charset* 的 Python 編解碼器名稱。如果不需要轉換"
+"編解碼器，這個屬性將會與 *input_codec* 有相同的值。"
 
 #: ../../library/email.charset.rst:96
 msgid ":class:`Charset` instances also have the following methods:"
-msgstr ""
+msgstr ":class:`Charset` 實例還有以下方法："
 
 #: ../../library/email.charset.rst:100
 msgid "Return the content transfer encoding used for body encoding."
-msgstr ""
+msgstr "回傳用於內文編碼的內容傳輸編碼 (content transfer encoding)。"
 
 #: ../../library/email.charset.rst:102
 msgid ""
@@ -153,37 +181,44 @@ msgid ""
 "function should then set the :mailheader:`Content-Transfer-Encoding` header "
 "itself to whatever is appropriate."
 msgstr ""
+"這可以是字串 ``quoted-printable`` 或 ``base64``，具體取決於所使用的編碼，或者"
+"它也可以是一個函式，在這種情況下，你應該使用單個引數呼叫該函式，即正被編碼的 "
+"Message 物件。然後函式應將 :mailheader:`Content-Transfer-Encoding` 標頭本身設"
+"定為任何適當的值。"
 
 #: ../../library/email.charset.rst:108
 msgid ""
 "Returns the string ``quoted-printable`` if *body_encoding* is ``QP``, "
 "returns the string ``base64`` if *body_encoding* is ``BASE64``, and returns "
 "the string ``7bit`` otherwise."
 msgstr ""
+"如果 *body_encoding* 為 ``QP`` 則回傳字串 ``quoted-printable``，如果 "
+"*body_encoding* 為 ``BASE64`` 則回傳字串 ``base64``，否則回傳字串 ``7bit`` 。"
 
 #: ../../library/email.charset.rst:115
 msgid "Return the output character set."
-msgstr ""
+msgstr "回傳輸出字元集合。"
 
 #: ../../library/email.charset.rst:117
 msgid ""
 "This is the *output_charset* attribute if that is not ``None``, otherwise it "
 "is *input_charset*."
 msgstr ""
+"如果不為 ``None`` 則這會是 *output_charset* 屬性，否則它是 *input_charset*。"
 
 #: ../../library/email.charset.rst:123
 msgid "Header-encode the string *string*."
-msgstr ""
+msgstr "對字串 *string* 進行標頭編碼 (header-encode)。"
 
 #: ../../library/email.charset.rst:125
 msgid ""
 "The type of encoding (base64 or quoted-printable) will be based on the "
 "*header_encoding* attribute."
-msgstr ""
+msgstr "編碼類型（base64 或可列印字元編碼）將基於 *header_encoding* 屬性。"
 
 #: ../../library/email.charset.rst:131
 msgid "Header-encode a *string* by converting it first to bytes."
-msgstr ""
+msgstr "透過先將 *string* 轉換為位元組來對它進行標頭編碼。"
 
 #: ../../library/email.charset.rst:133
 msgid ""
@@ -192,56 +227,64 @@ msgid ""
 "iterator: each element returned from this iterator will provide the next "
 "maximum line length."
 msgstr ""
+"這與 :meth:`header_encode` 類似，只不過字串不會超過由引數 *maxlengths* 給定的"
+"最大列長度 (maximum line length)，該引數必須是個疊代器：從此疊代器回傳的每個"
+"元素將提供下一個最大列長度。"
 
 #: ../../library/email.charset.rst:141
 msgid "Body-encode the string *string*."
-msgstr ""
+msgstr "對字串 *string* 進行內文編碼 (body-encode)。"
 
 #: ../../library/email.charset.rst:143
 msgid ""
 "The type of encoding (base64 or quoted-printable) will be based on the "
 "*body_encoding* attribute."
-msgstr ""
+msgstr "編碼類型（base64 或可列印字元編碼）將基於 *body_encoding* 屬性。"
 
 #: ../../library/email.charset.rst:146
 msgid ""
 "The :class:`Charset` class also provides a number of methods to support "
 "standard operations and built-in functions."
-msgstr ""
+msgstr ":class:`Charset` 類別也提供了許多支援標準操作和內建函式的方法。"
 
 #: ../../library/email.charset.rst:152
 msgid ""
 "Returns *input_charset* as a string coerced to lower case. :meth:`!__repr__` "
 "is an alias for :meth:`!__str__`."
 msgstr ""
+"回傳強制轉換 *input_charset* 為小寫後的字串。:meth:`!__repr__` 是 :meth:`!"
+"__str__` 的別名。"
 
 #: ../../library/email.charset.rst:158
 msgid ""
 "This method allows you to compare two :class:`Charset` instances for "
 "equality."
-msgstr ""
+msgstr "此方法讓你比較兩個 :class:`Charset` 實例的相等性。"
 
 #: ../../library/email.charset.rst:164
 msgid ""
 "This method allows you to compare two :class:`Charset` instances for "
 "inequality."
-msgstr ""
+msgstr "此方法讓你比較兩個 :class:`Charset` 實例的不相等性。"
 
 #: ../../library/email.charset.rst:167
 msgid ""
 "The :mod:`email.charset` module also provides the following functions for "
 "adding new entries to the global character set, alias, and codec registries:"
 msgstr ""
+":mod:`email.charset` 模組還提供以下函式，用於將項目新增至全域字元集合、別名和"
+"編解碼器登錄檔中："
 
 #: ../../library/email.charset.rst:173
 msgid "Add character properties to the global registry."
-msgstr ""
+msgstr "將字元特性 (properties) 新增至全域登錄檔。"
 
 #: ../../library/email.charset.rst:175
 msgid ""
 "*charset* is the input character set, and must be the canonical name of a "
 "character set."
 msgstr ""
+"*charset* 是輸入的字元集合，且必須是字元集合的規範名稱 (canonical name)。"
 
 #: ../../library/email.charset.rst:178
 msgid ""
@@ -251,6 +294,10 @@ msgid ""
 "encoding.  ``SHORTEST`` is only valid for *header_enc*. The default is "
 "``None`` for no encoding."
 msgstr ""
+"可選的 *header_enc* 和 *body_enc* 為 ``charset.QP``\\ （表示可列印字元編"
+"碼）、``charset.BASE64``\\ （表示 base64 編碼）、``charset.SHORTEST``\\ （表"
+"示最短的 base64 或可列印字元編碼）或 ``None``\\ （表示無編碼）。``SHORTEST`` "
+"僅在用於 *header_enc* 時有效。預設為 ``None``，表示無編碼。"
 
 #: ../../library/email.charset.rst:184
 msgid ""
@@ -259,6 +306,9 @@ msgid ""
 "charset when the method :meth:`Charset.convert` is called.  The default is "
 "to output in the same character set as the input."
 msgstr ""
+"可選的 *output_charset* 是輸出應採用的字元集合。當呼叫 :meth:`Charset."
+"convert` 方法時，將從輸入字元集合轉換為 Unicode，再轉換為輸出字元集合。預設是"
+"以與輸入相同的字元集合輸出。"
 
 #: ../../library/email.charset.rst:189
 msgid ""
@@ -267,34 +317,42 @@ msgid ""
 "codecs the module does not know about.  See the :mod:`codecs` module's "
 "documentation for more information."
 msgstr ""
+"*input_charset* 和 *output_charset* 都必須在模組的字元集合到編解碼器對映 "
+"(character set-to-codec mapping) 中具有 Unicode 編解碼器項目；使用 :func:"
+"`add_codec` 來新增模組未知的編解碼器。有關更多資訊請參閱 :mod:`codecs` 模組的"
+"文件。"
 
 #: ../../library/email.charset.rst:194
 msgid ""
 "The global character set registry is kept in the module global dictionary "
 "``CHARSETS``."
-msgstr ""
+msgstr "全域字元集合登錄檔保存在模組全域字典 ``CHARSETS`` 中。"
 
 #: ../../library/email.charset.rst:200
 msgid ""
 "Add a character set alias.  *alias* is the alias name, e.g. ``latin-1``. "
 "*canonical* is the character set's canonical name, e.g. ``iso-8859-1``."
 msgstr ""
+"新增字元集合別名。*alias* 是別名，例如 ``latin-1``。*canonical* 是字元集合的"
+"規範名稱，例如 ``iso-8859-1``。"
 
 #: ../../library/email.charset.rst:203
 msgid ""
 "The global charset alias registry is kept in the module global dictionary "
 "``ALIASES``."
-msgstr ""
+msgstr "全域字元集合別名登錄檔保存在模組全域字典 ``ALIASES`` 中。"
 
 #: ../../library/email.charset.rst:209
 msgid ""
 "Add a codec that map characters in the given character set to and from "
 "Unicode."
-msgstr ""
+msgstr "新增一個編解碼器，將給定字元集合中的字元與 Unicode 進行對映。"
 
 #: ../../library/email.charset.rst:211
 msgid ""
 "*charset* is the canonical name of a character set. *codecname* is the name "
 "of a Python codec, as appropriate for the second argument to the :class:"
 "`str`'s :meth:`~str.encode` method."
 msgstr ""
+"*charset* 是字元集合的規範名稱。*codecname* 是 Python 編解碼器的名稱，適用"
+"於 :class:`str` 的 :meth:`~str.encode` 方法的第二個引數。"