Merge branch '3.13' into grp-trans

LamentXU123 · web-flow · commit a1b884a80be3 · 2025-06-30T23:24:59.000+08:00
diff --git a/c-api/marshal.po b/c-api/marshal.po
@@ -1,26 +1,28 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2022, Python Software Foundation
+# Copyright (C) 2001-2025, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
+# Adrian Liaw <adrianliaw2000@gmail.com>, 2018
+# Matt Wang <mattwang44@gmail.com>, 2025
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-07-20 00:03+0000\n"
-"PO-Revision-Date: 2018-05-23 14:06+0000\n"
-"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
+"PO-Revision-Date: 2025-06-28 02:44+0800\n"
+"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
+"X-Generator: Poedit 3.6\n"
 
 #: ../../c-api/marshal.rst:6
 msgid "Data marshalling support"
-msgstr "資料 marshal 的支援"
+msgstr "資料 marshal 操作的支援"
 
 #: ../../c-api/marshal.rst:8
 msgid ""
@@ -30,10 +32,13 @@ msgid ""
 "read the data back.  Files used to store marshalled data must be opened in "
 "binary mode."
 msgstr ""
+"這些例程允許 C 程式碼使用與 :mod:`marshal` 模組相同的資料格式來處理序列化物"
+"件。有函式可以將資料寫入序列化格式，還有其他函式可以用來讀取回資料。用來儲存 "
+"marshal 過的資料的檔案必須以二進位模式開啟。"
 
 #: ../../c-api/marshal.rst:14
 msgid "Numeric values are stored with the least significant byte first."
-msgstr ""
+msgstr "數值會以最低有效位元組 (the least significant byte) 優先的方式儲存。"
 
 #: ../../c-api/marshal.rst:16
 msgid ""
@@ -42,68 +47,85 @@ msgid ""
 "unmarshalling.  Version 2 uses a binary format for floating-point numbers. "
 "``Py_MARSHAL_VERSION`` indicates the current file format (currently 2)."
 msgstr ""
+"這個模組支援兩個版本的資料格式：版本 0 是歷史版本，版本 1 在檔案中共享駐留字"
+"串 (interned strings)，並在 unmarshal 時使用。版本 2 使用二進位格式來儲存浮點"
+"數。``Py_MARSHAL_VERSION`` 表示目前的檔案格式（目前為 2）。"
 
 #: ../../c-api/marshal.rst:24
 msgid ""
 "Marshal a :c:expr:`long` integer, *value*, to *file*.  This will only write "
 "the least-significant 32 bits of *value*; regardless of the size of the "
 "native :c:expr:`long` type.  *version* indicates the file format."
 msgstr ""
+"將一個 :c:expr:`long` 整數 *value* marshal 為 *file*。這只會寫入 *value* 的最"
+"低有效 32 位元；無論原生 :c:expr:`long` 型別的大小如何。*version* 表示檔案的格"
+"式。"
 
 #: ../../c-api/marshal.rst:28 ../../c-api/marshal.rst:36
 msgid ""
-"This function can fail, in which case it sets the error indicator. Use :c:"
-"func:`PyErr_Occurred` to check for that."
+"This function can fail, in which case it sets the error indicator. "
+"Use :c:func:`PyErr_Occurred` to check for that."
 msgstr ""
+"這個函式可能會失敗，這時會設定錯誤指示器。使用 :c:func:`PyErr_Occurred` 來檢"
+"查是否發生錯誤。"
 
 #: ../../c-api/marshal.rst:33
 msgid ""
 "Marshal a Python object, *value*, to *file*. *version* indicates the file "
 "format."
 msgstr ""
+"將一個 Python 物件 *value* marshal 為 *file*。*version* 表示檔案的格式。"
 
 #: ../../c-api/marshal.rst:41
 msgid ""
 "Return a bytes object containing the marshalled representation of *value*. "
 "*version* indicates the file format."
 msgstr ""
+"回傳一個位元組物件，包含 *value* 的 marshal 表示。*version* 為檔案的格式。"
 
 #: ../../c-api/marshal.rst:45
 msgid "The following functions allow marshalled values to be read back in."
-msgstr ""
+msgstr "以下函式允許將 marshal 過後的值讀取回來。"
 
 #: ../../c-api/marshal.rst:50
 msgid ""
 "Return a C :c:expr:`long` from the data stream in a :c:expr:`FILE*` opened "
 "for reading.  Only a 32-bit value can be read in using this function, "
 "regardless of the native size of :c:expr:`long`."
 msgstr ""
+"從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 C :c:expr:`long`。"
+"無論 :c:expr:`long` 的原生大小如何，這個函式只能讀取 32 位元的值。"
 
 #: ../../c-api/marshal.rst:54 ../../c-api/marshal.rst:64
 msgid ""
 "On error, sets the appropriate exception (:exc:`EOFError`) and returns "
 "``-1``."
-msgstr ""
+msgstr "在錯誤發生時，會設定合適的例外（:exc:`EOFError`）並回傳 ``-1``。"
 
 #: ../../c-api/marshal.rst:60
 msgid ""
 "Return a C :c:expr:`short` from the data stream in a :c:expr:`FILE*` opened "
 "for reading.  Only a 16-bit value can be read in using this function, "
 "regardless of the native size of :c:expr:`short`."
 msgstr ""
+"從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 C :c:expr:`short`。"
+"無論 :c:expr:`short` 的原生大小如何，這個函式只能讀取 16 位元的值。"
 
 #: ../../c-api/marshal.rst:70
 msgid ""
 "Return a Python object from the data stream in a :c:expr:`FILE*` opened for "
 "reading."
 msgstr ""
+"從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 Python 物件。"
 
 #: ../../c-api/marshal.rst:73 ../../c-api/marshal.rst:87
 #: ../../c-api/marshal.rst:96
 msgid ""
 "On error, sets the appropriate exception (:exc:`EOFError`, :exc:`ValueError` "
 "or :exc:`TypeError`) and returns ``NULL``."
 msgstr ""
+"在錯誤發生時，會設定合適的例外（:exc:`EOFError`、:exc:`ValueError` "
+"或 :exc:`TypeError`）並回傳 ``NULL``。"
 
 #: ../../c-api/marshal.rst:79
 msgid ""
@@ -115,9 +137,16 @@ msgid ""
 "file.  Only use these variant if you are certain that you won't be reading "
 "anything else from the file."
 msgstr ""
+"從一個為讀取而開啟的 :c:expr:`FILE*` 中的資料串流回傳一個 Python 物件。"
+"與 :c:func:`PyMarshal_ReadObjectFromFile` 不同，這個函式假設不會從檔案中讀取"
+"其他物件，允許它積極地將檔案資料載入記憶體，以便反序列化可以從記憶體中的資料"
+"操作，而不是從檔案中逐位元組讀取。只有在確定不會從檔案中讀取其他內容時，才使"
+"用這個變體。"
 
 #: ../../c-api/marshal.rst:93
 msgid ""
 "Return a Python object from the data stream in a byte buffer containing "
 "*len* bytes pointed to by *data*."
 msgstr ""
+"從一個包含 *len* 位元組、被 *data* 指向的位元組緩衝區中的資料串流回傳一個 "
+"Python 物件。"
diff --git a/library/custominterp.po b/library/custominterp.po
@@ -3,12 +3,13 @@
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
+# Weilin Du, 2025
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2022-07-06 00:17+0000\n"
-"PO-Revision-Date: 2015-12-09 17:51+0000\n"
+"PO-Revision-Date: 2025-06-28 10:57+0800\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -30,6 +31,9 @@ msgid ""
 "look at the :mod:`code` module.  (The :mod:`codeop` module is lower-level, "
 "used to support compiling a possibly incomplete chunk of Python code.)"
 msgstr ""
+"本章介紹的模組可用於編寫類似於 Python 交互式直譯器的介面。如果你需要一個在 "
+"Python 語言基礎上支援某些特殊功能的直譯器，可以參考 :mod:`code` 模組。（"
+" :mod:`codeop` 模組屬於底層工具，用於支援編譯可能不完整的 Python 程式碼。）"
 
 #: ../../library/custominterp.rst:13
 msgid "The full list of modules described in this chapter is:"
diff --git a/library/superseded.po b/library/superseded.po
@@ -3,21 +3,21 @@
 #
 # Translators:
 # Matt Wang <mattwang44@gmail.com>, 2022
+# Weilin Du, 2025
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-12-29 11:18+0000\n"
-"PO-Revision-Date: 2022-02-15 20:45+0800\n"
-"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
+"PO-Revision-Date: 2025-06-28 12:28+0800\n"
+"Last-Translator: Weilin Du <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Poedit 3.0.1\n"
 
 #: ../../library/superseded.rst:5
 msgid "Superseded Modules"
@@ -41,6 +41,11 @@ msgid ""
 "rather than the broader command line option parsing and argument parsing "
 "capabilities offered by :mod:`optparse` and :mod:`argparse`)."
 msgstr ""
+"某些模組出現在本章節，可能是因為它們能解決的問題是問題空間的有限子集，而標準函"
+"式庫的其他地方提供了更通用的解決方案（例如，:mod:`getopt` 只處理「在 Python "
+"中模擬 C 語言中 :c:func:`!getopt` 這個 API 」這項非常具體的任務，而非像 :mod:"
+"`optparse` 和 :mod:`argparse` 那樣提供更廣泛的命令列選項剖析與引數剖析功"
+"能）。"
 
 #: ../../library/superseded.rst:17
 msgid ""
@@ -50,3 +55,7 @@ msgid ""
 "projects. With the removal of various obsolete modules through :pep:`594`, "
 "there are currently no modules in this latter category."
 msgstr ""
+"或者， 某些模組出現在本章節，可能是因為它們已被明確棄用（deprecated），並將"
+"在未來版本中移除；又或者它們屬於 :term:`soft deprecated` 狀態，官方強烈不建"
+"議在新專案中使用。隨著 :pep:`594` 移除了多個過時模組，目前標準函式庫中已不存"
+"在後者（軟性棄用）這類模組。"
diff --git a/library/tty.po b/library/tty.po
@@ -5,21 +5,21 @@
 # Translators:
 # Liang-Bo Wang <me@liang2.tw>, 2016
 # Matt Wang <mattwang44@gmail.com>, 2021
+# Weilin Du, 2025
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-10-11 00:13+0000\n"
-"PO-Revision-Date: 2021-12-17 17:00+0800\n"
-"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
+"PO-Revision-Date: 2025-06-28 20:38+0800\n"
+"Last-Translator: Weilin Du\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Poedit 3.0.1\n"
 
 #: ../../library/tty.rst:2
 msgid ":mod:`!tty` --- Terminal control functions"
@@ -37,7 +37,7 @@ msgstr ":mod:`tty` 模組定義了將 tty 放入 cbreak 和 raw 模式的函式
 
 #: ../../library/tty.rst:18
 msgid "Availability"
-msgstr ""
+msgstr "可用性"
 
 #: ../../library/tty.rst:20
 msgid ""
@@ -53,24 +53,32 @@ msgid ""
 "Convert the tty attribute list *mode*, which is a list like the one returned "
 "by :func:`termios.tcgetattr`, to that of a tty in raw mode."
 msgstr ""
+"將 tty 屬性串列 *mode* 轉換成原始模式下的 tty 屬性串列，這個串列就像 :func:"
+"`termios.tcgetattr` 所回傳的一樣。"
 
 #: ../../library/tty.rst:35
 msgid ""
 "Convert the tty attribute list *mode*, which is a list like the one returned "
 "by :func:`termios.tcgetattr`, to that of a tty in cbreak mode."
 msgstr ""
+"將 tty 屬性串列 *mode* 轉換成 cbreak 模式下的 tty 屬性串列，這個串列就像 :"
+"func:`termios.tcgetattr` 所回傳的一樣。"
 
 #: ../../library/tty.rst:38
 msgid ""
 "This clears the ``ECHO`` and ``ICANON`` local mode flags in *mode* as well "
 "as setting the minimum input to 1 byte with no delay."
 msgstr ""
+"這會清除 *mode* 中的 ``ECHO`` 和 ``ICANON`` 本地模式旗標，並將最小輸入設定為 "
+"1 位元組，且無延遲。"
 
 #: ../../library/tty.rst:43
 msgid ""
 "The ``ICRNL`` flag is no longer cleared. This matches Linux and macOS ``stty "
 "cbreak`` behavior and what :func:`setcbreak` historically did."
 msgstr ""
+"不再清除 ``ICRNL`` 標記。這符合 Linux 和 macOS 的 ``stty cbreak`` 行為，也符"
+"合 :func:`setcbreak` 歷來的做法。"
 
 #: ../../library/tty.rst:50
 msgid ""
@@ -106,13 +114,17 @@ msgid ""
 "This clears the ``ECHO`` and ``ICANON`` local mode flags as well as setting "
 "the minimum input to 1 byte with no delay."
 msgstr ""
+"這會清除 ``ECHO`` 和 ``ICANON`` 本地模式旗標，並將最小輸入設定為 1 位元組，且"
+"無延遲。"
 
 #: ../../library/tty.rst:72
 msgid ""
 "The ``ICRNL`` flag is no longer cleared. This restores the behavior of "
 "Python 3.11 and earlier as well as matching what Linux, macOS, & BSDs "
 "describe in their ``stty(1)`` man pages regarding cbreak mode."
 msgstr ""
+"不再清除 ``ICRNL`` 旗標。這恢復了 Python 3.11 及更早版本的行為，也符合 "
+"Linux、macOS 及 BSD 在他們的 ``stty(1)`` man 頁面中描述的 cbreak 模式。"
 
 #: ../../library/tty.rst:80
 msgid "Module :mod:`termios`"
