Merge branch '3.14' into cron/sync/3.14

Author: mattwang44

README.rst

@@ -367,6 +367,89 @@ reST 語法注意事項
 
     以下是個程式範例： ::
 
+使用 Skills 協助翻譯
+====================
+
+本專案在 ``.claude/skills/`` 目錄底下提供三個 Skill，協助你依照\ `翻譯守則`_\ 與\
+`術語表 Glossary`_\ 進行翻譯與校對。
+
+除了 `Claude Code <https://docs.anthropic.com/en/docs/claude-code>`_\ ，只要你使用
+的 coding agent 支援 Skills（``SKILL.md``\ ）格式，並設定好對應的載入路徑，就能
+共用同一套 Skill。本專案目前已內建以下 coding agent 的設定：
+
+- **Claude Code**\ ：Skill 位於 ``.claude/skills/``\ ，在專案根目錄啟動時會自動\
+  載入。
+- **Codex**\ ：透過 ``.codex/AGENTS.md`` 以及 ``.codex/skills``\ （指向
+  ``.claude/skills/`` 的符號連結）載入相同的 Skill。
+
+其他 coding agent 只要建立指向 ``.claude/skills/`` 的對應設定，即可比照使用。
+
+可用的 Skill 如下：
+
+- ``translate-po``\ ：將 po 檔中尚未翻譯的條目由英文翻譯為臺灣繁體中文，並\
+  遵循本專案的翻譯慣例。
+- ``check-terminology``\ ：檢查用詞是否與術語表一致，並找出需要轉換為臺灣繁體\
+  中文的用語。
+- ``validate-translation``\ ：審閱已翻譯的條目，檢查用詞、標點、reST 語法與行\
+  寬等問題。
+
+事前準備
+--------
+
+- 安裝並設定好你偏好的 coding agent（例如 `Claude Code
+  <https://docs.anthropic.com/en/docs/claude-code>`_ 或 Codex）。
+- 將本專案 clone 到本機，並切換到對應的版本 branch（例如 ``3.14``\ ）。
+- 在專案根目錄底下啟動 coding agent，Skill 才會被正確載入。
+
+使用方式與範例
+--------------
+
+在 coding agent 的對話中，以自然語言請它使用對應的 Skill 並指定要處理的 po
+檔即可。以下以 Claude Code 為例，示範如何翻譯 ``tutorial/introduction.po``\ ，並\
+校對翻譯結果（其他 coding agent 的操作方式類似）。
+
+**第一步：翻譯**
+
+對 coding agent 輸入類似以下的指示：
+
+.. code-block:: text
+
+  請使用 translate-po skill 翻譯 tutorial/introduction.po 中尚未翻譯的條目
+
+Skill 會找出 ``msgstr`` 為空或標記為 fuzzy 的條目，並依照翻譯守則填入譯文。
+例如翻譯前：
+
+.. code-block:: po
+
+  #: ../../tutorial/introduction.rst:5
+  msgid "An Informal Introduction to Python"
+  msgstr ""
+
+翻譯後（中英文之間會加入空白，專有名詞 ``Python`` 維持英文）：
+
+.. code-block:: po
+
+  #: ../../tutorial/introduction.rst:5
+  msgid "An Informal Introduction to Python"
+  msgstr "一個非正式的 Python 簡介"
+
+**第二步：校對**
+
+接著請 coding agent 使用 ``validate-translation`` 校對剛才的譯文：
+
+.. code-block:: text
+
+  請使用 validate-translation skill 檢查 tutorial/introduction.po
+
+Skill 會將發現的問題分類為 ERROR、WARNING、INFO 並逐項列出，例如建議執行
+``make lint`` 確認格式。你也可以使用 ``check-terminology`` 單獨檢查某個用詞，\
+或整份 po 檔的術語一致性。
+
+.. note::
+
+  Skill 產生的譯文僅供輔助，送出 Pull Request 前請務必人工確認每一條翻譯是否\
+  正確、是否符合\ `翻譯守則`_\ 。
+
 術語表 Glossary
 ===============
 

bugs.po

@@ -261,6 +261,7 @@ msgid ""
 "any and all questions pertaining to the process of fixing issues in Python."
 msgstr ""
 "除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。"
-"你可以在 `Python 開發者指南`_\\ 中找到如何開始修補 Python 的更多資訊。如果你"
-"有任何問題，`核心導師郵寄清單`_\\ 是一個友善的地方，你可以在那裡得到，關於 "
-"Python 修正錯誤的過程中，所有問題的答案。"
+"你可以在 `Python 開發者指南 <Python Developer's Guide_>`_\\ "
+"中找到如何開始修補 Python 的更多資訊。如果你有任何問題，"
+"`核心導師郵寄清單 <core-mentorship mailing list_>`_\\ "
+"是個友善的地方，任何關於修正 Python 問題之流程的疑問，都能在那裡得到解答。"

faq/design.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-09-04 00:18+0000\n"
+"POT-Creation-Date: 2026-09-13 20:11+0800\n"
 "PO-Revision-Date: 2023-08-31 11:34+0800\n"
 "Last-Translator: Steven Hsu <hsuhaochun@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -523,6 +523,11 @@ msgid ""
 "statements. An older alternative is a sequence of ``if... elif... elif... "
 "else``."
 msgstr ""
+"一般來說，結構化的 switch 陳述式會在運算式具有特定值或一組值時，執行一個程式"
+"碼區塊。從 Python 3.10 開始，可以使用 ``match ... case`` 陳述式來匹配字面值，"
+"或命名空間中的常數。更多關於 :keyword:`match` 陳述式的資訊，請參閱\\ :ref:`規"
+"格說明 <match>`\\ 和\\ :ref:`教學 <tut-match>`。較舊的替代方案是一連串的 "
+"``if... elif... elif... else``。"
 
 #: ../../faq/design.rst:270
 msgid ""
@@ -540,10 +545,12 @@ msgid ""
 "func = functions[value]\n"
 "func()"
 msgstr ""
-"if key in mydict:\n"
-"    value = mydict[key]\n"
-"else:\n"
-"    value = mydict[key] = getvalue(key)"
+"functions = {'a': function_1,\n"
+"             'b': function_2,\n"
+"             'c': self.method_1}\n"
+"\n"
+"func = functions[value]\n"
+"func()"
 
 #: ../../faq/design.rst:281
 msgid ""
@@ -588,6 +595,8 @@ msgid ""
 "Imitating switch with fallthrough, as with C's switch-case-default, is "
 "possible, much harder, and less needed."
 msgstr ""
+"模仿具有穿透 (fallthrough) 特性的 switch 雖然可行（就像 C 的 switch-case-"
+"default 一樣），但實作起來較為困難，實用性也不高。"
 
 #: ../../faq/design.rst:302
 msgid ""
@@ -878,7 +887,7 @@ msgstr ""
 #: ../../faq/design.rst:448
 msgid ""
 "See :ref:`time-complexity` for the costs of the various list operations."
-msgstr ""
+msgstr "各種串列操作的時間複雜度請參閱 :ref:`time-complexity`。"
 
 #: ../../faq/design.rst:454
 msgid "How are dictionaries implemented in CPython?"
@@ -916,7 +925,7 @@ msgstr ""
 msgid ""
 "See :ref:`time-complexity` for the costs of the various dictionary "
 "operations."
-msgstr ""
+msgstr "各種字典操作的時間複雜度請參閱 :ref:`time-complexity`。"
 
 #: ../../faq/design.rst:473
 msgid "Why must dictionary keys be immutable?"
@@ -1129,6 +1138,8 @@ msgid ""
 "for key in sorted(mydict):\n"
 "    ...  # do whatever with mydict[key]..."
 msgstr ""
+"for key in sorted(mydict):\n"
+"    ...  # do whatever with mydict[key]..."
 
 #: ../../faq/design.rst:574
 msgid "How do you specify and enforce an interface spec in Python?"
@@ -1255,6 +1266,15 @@ msgid ""
 "    pass\n"
 "..."
 msgstr ""
+"class label(Exception): pass  # 宣告一個標籤\n"
+"\n"
+"try:\n"
+"    ...\n"
+"    if condition: raise label()  # goto 標籤\n"
+"    ...\n"
+"except label:  # 跳轉目標\n"
+"    pass\n"
+"..."
 
 #: ../../faq/design.rst:640
 msgid ""
@@ -1299,7 +1319,7 @@ msgstr ""
 
 #: ../../faq/design.rst:661
 msgid "f = open(\"/mydir/file.txt\")  # works fine!"
-msgstr ""
+msgstr "f = open(\"/mydir/file.txt\")  # 正常運作!"
 
 #: ../../faq/design.rst:663
 msgid ""
@@ -1312,6 +1332,9 @@ msgid ""
 "dir = r\"\\this\\is\\my\\dos\\dir\\ \"[:-1]\n"
 "dir = \"\\\\this\\\\is\\\\my\\\\dos\\\\dir\\\\\""
 msgstr ""
+"dir = r\"\\this\\is\\my\\dos\\dir\" \"\\\\\"\n"
+"dir = r\"\\this\\is\\my\\dos\\dir\\ \"[:-1]\n"
+"dir = \"\\\\this\\\\is\\\\my\\\\dos\\\\dir\\\\\""
 
 #: ../../faq/design.rst:671
 msgid "Why doesn't Python have a \"with\" statement for attribute assignments?"
@@ -1332,6 +1355,9 @@ msgid ""
 "    a = 1               # equivalent to obj.a = 1\n"
 "    total = total + 1   # obj.total = obj.total + 1"
 msgstr ""
+"with obj:\n"
+"    a = 1               # 等同於 obj.a = 1\n"
+"    total = total + 1   # obj.total = obj.total + 1"
 
 #: ../../faq/design.rst:681
 msgid "In Python, such a construct would be ambiguous."
@@ -1527,6 +1553,12 @@ msgid ""
 "    \"B\": [6, 7],  # last trailing comma is optional but good style\n"
 "}"
 msgstr ""
+"[1, 2, 3,]\n"
+"('a', 'b', 'c',)\n"
+"d = {\n"
+"    \"A\": [1, 5],\n"
+"    \"B\": [6, 7],  # 最尾的逗號是可選的，但符合良好的規範\n"
+"}"
 
 #: ../../faq/design.rst:775
 msgid "There are several reasons to allow this."