Complete translation of all code comments and docstrings

Copilot · mattwang44 · Copilot · commit 06b87f4b268a · 2025-07-14T06:30:12.000Z
Co-authored-by: mattwang44 &lt;24987826+mattwang44@users.noreply.github.com&gt;
diff --git a/tutorial/introduction.po b/tutorial/introduction.po
@@ -221,7 +221,7 @@ msgid ""
 "  File \"<stdin>\", line 1, in <module>\n"
 "NameError: name 'n' is not defined"
 msgstr ""
-">>> n  # try to access an undefined variable\n"
+">>> n  # 嘗試存取未定義的變數\n"
 "Traceback (most recent call last):\n"
 "  File \"<stdin>\", line 1, in <module>\n"
 "NameError: name 'n' is not defined"
@@ -319,11 +319,11 @@ msgid ""
 ">>> '1975'  # digits and numerals enclosed in quotes are also strings\n"
 "'1975'"
 msgstr ""
-">>> 'spam eggs'  # single quotes\n"
+">>> 'spam eggs'  # 單引號\n"
 "'spam eggs'\n"
-">>> \"Paris rabbit got your back :)! Yay!\"  # double quotes\n"
+">>> \"Paris rabbit got your back :)! Yay!\"  # 雙引號\n"
 "'Paris rabbit got your back :)! Yay!'\n"
-">>> '1975'  # digits and numerals enclosed in quotes are also strings\n"
+">>> '1975'  # 以引號包含的數字和數值也是字串\n"
 "'1975'"
 
 #: ../../tutorial/introduction.rst:158
@@ -349,7 +349,7 @@ msgid ""
 msgstr ""
 ">>> 'doesn\\'t'  # use \\' to escape the single quote...\n"
 "\"doesn't\"\n"
-">>> \"doesn't\"  # ...or use double quotes instead\n"
+">>> \"doesn't\"  # ...或改用雙引號\n"
 "\"doesn't\"\n"
 ">>> '\"Yes,\" they said.'\n"
 "'\"Yes,\" they said.'\n"
@@ -378,8 +378,8 @@ msgid ""
 "First line.\n"
 "Second line."
 msgstr ""
-">>> s = 'First line.\\nSecond line.'  # \\n means newline\n"
-">>> s  # without print(), special characters are included in the string\n"
+">>> s = 'First line.\\nSecond line.'  # \\n 表示換行\n"
+">>> s  # 沒有 print()，特殊字元會包含在字串中\n"
 "'First line.\\nSecond line.'\n"
 ">>> print(s)  # with print(), special characters are interpreted, so \\n "
 "produces new line\n"
@@ -403,10 +403,10 @@ msgid ""
 ">>> print(r'C:\\some\\name')  # note the r before the quote\n"
 "C:\\some\\name"
 msgstr ""
-">>> print('C:\\some\\name')  # here \\n means newline!\n"
+">>> print('C:\\some\\name')  # 這裡 \\n 表示換行！\n"
 "C:\\some\n"
 "ame\n"
-">>> print(r'C:\\some\\name')  # note the r before the quote\n"
+">>> print(r'C:\\some\\name')  # 注意引號前的 r\n"
 "C:\\some\\name"
 
 #: ../../tutorial/introduction.rst:193
@@ -468,7 +468,7 @@ msgid ""
 ">>> 3 * 'un' + 'ium'\n"
 "'unununium'"
 msgstr ""
-">>> # 3 times 'un', followed by 'ium'\n"
+">>> # 3 次 'un'，接著是 'ium'\n"
 ">>> 3 * 'un' + 'ium'\n"
 "'unununium'"
 
@@ -526,7 +526,7 @@ msgid ""
 "SyntaxError: invalid syntax"
 msgstr ""
 ">>> prefix = 'Py'\n"
-">>> prefix 'thon'  # can't concatenate a variable and a string literal\n"
+">>> prefix 'thon'  # 無法串接變數和字串字面值\n"
 "  File \"<stdin>\", line 1\n"
 "    prefix 'thon'\n"
 "           ^^^^^^\n"
@@ -568,9 +568,9 @@ msgid ""
 "'n'"
 msgstr ""
 ">>> word = 'Python'\n"
-">>> word[0]  # character in position 0\n"
+">>> word[0]  # 位置 0 的字元\n"
 "'P'\n"
-">>> word[5]  # character in position 5\n"
+">>> word[5]  # 位置 5 的字元\n"
 "'n'"
 
 #: ../../tutorial/introduction.rst:264
@@ -587,9 +587,9 @@ msgid ""
 ">>> word[-6]\n"
 "'P'"
 msgstr ""
-">>> word[-1]  # last character\n"
+">>> word[-1]  # 最後一個字元\n"
 "'n'\n"
-">>> word[-2]  # second-last character\n"
+">>> word[-2]  # 倒數第二個字元\n"
 "'o'\n"
 ">>> word[-6]\n"
 "'P'"
@@ -614,9 +614,9 @@ msgid ""
 ">>> word[2:5]  # characters from position 2 (included) to 5 (excluded)\n"
 "'tho'"
 msgstr ""
-">>> word[0:2]  # characters from position 0 (included) to 2 (excluded)\n"
+">>> word[0:2]  # 從位置 0 (包含) 到 2 (不包含) 的字元\n"
 "'Py'\n"
-">>> word[2:5]  # characters from position 2 (included) to 5 (excluded)\n"
+">>> word[2:5]  # 從位置 2 (包含) 到 5 (不包含) 的字元\n"
 "'tho'"
 
 #: ../../tutorial/introduction.rst:283
@@ -636,11 +636,11 @@ msgid ""
 ">>> word[-2:]  # characters from the second-last (included) to the end\n"
 "'on'"
 msgstr ""
-">>> word[:2]   # character from the beginning to position 2 (excluded)\n"
+">>> word[:2]   # 從開頭到位置 2 (不包含) 的字元\n"
 "'Py'\n"
-">>> word[4:]   # characters from position 4 (included) to the end\n"
+">>> word[4:]   # 從位置 4 (包含) 到結尾的字元\n"
 "'on'\n"
-">>> word[-2:]  # characters from the second-last (included) to the end\n"
+">>> word[-2:]  # 從倒數第二個 (包含) 到結尾的字元\n"
 "'on'"
 
 #: ../../tutorial/introduction.rst:293
@@ -889,11 +889,11 @@ msgid ""
 ">>> squares[-3:]  # slicing returns a new list\n"
 "[9, 16, 25]"
 msgstr ""
-">>> squares[0]  # indexing returns the item\n"
+">>> squares[0]  # 索引回傳項目\n"
 "1\n"
 ">>> squares[-1]\n"
 "25\n"
-">>> squares[-3:]  # slicing returns a new list\n"
+">>> squares[-3:]  # 切片回傳新列表\n"
 "[9, 16, 25]"
 
 #: ../../tutorial/introduction.rst:407
@@ -925,10 +925,10 @@ msgid ""
 ">>> cubes\n"
 "[1, 8, 27, 64, 125]"
 msgstr ""
-">>> cubes = [1, 8, 27, 65, 125]  # something's wrong here\n"
-">>> 4 ** 3  # the cube of 4 is 64, not 65!\n"
+">>> cubes = [1, 8, 27, 65, 125]  # 這裡有問題\n"
+">>> 4 ** 3  # 4 的立方是 64，不是 65！\n"
 "64\n"
-">>> cubes[3] = 64  # replace the wrong value\n"
+">>> cubes[3] = 64  # 替換錯誤的值\n"
 ">>> cubes\n"
 "[1, 8, 27, 64, 125]"
 
@@ -947,8 +947,8 @@ msgid ""
 ">>> cubes\n"
 "[1, 8, 27, 64, 125, 216, 343]"
 msgstr ""
-">>> cubes.append(216)  # add the cube of 6\n"
-">>> cubes.append(7 ** 3)  # and the cube of 7\n"
+">>> cubes.append(216)  # 加入 6 的立方\n"
+">>> cubes.append(7 ** 3)  # 以及 7 的立方\n"
 ">>> cubes\n"
 "[1, 8, 27, 64, 125, 216, 343]"
 
diff --git a/tutorial/modules.po b/tutorial/modules.po
@@ -1070,13 +1070,13 @@ msgid ""
 "    return msg[::-1]    #     in the case of a 'from sound.effects import *'"
 msgstr ""
 "__all__ = [\n"
-"    \"echo\",      # refers to the 'echo.py' file\n"
-"    \"surround\",  # refers to the 'surround.py' file\n"
-"    \"reverse\",   # !!! refers to the 'reverse' function now !!!\n"
+"    \"echo\",      # 指向 'echo.py' 檔案\n"
+"    \"surround\",  # 指向 'surround.py' 檔案\n"
+"    \"reverse\",   # !!! 現在指向 'reverse' 函式 !!!\n"
 "]\n"
 "\n"
-"def reverse(msg: str):  # <-- this name shadows the 'reverse.py' submodule\n"
-"    return msg[::-1]    #     in the case of a 'from sound.effects import *'"
+"def reverse(msg: str):  # <-- 這個名稱遮蔽了 'reverse.py' 子模組\n"
+"    return msg[::-1]    #     在 'from sound.effects import *' 的情況下"
 
 #: ../../tutorial/modules.rst:534
 msgid ""
diff --git a/tutorial/stdlib2.po b/tutorial/stdlib2.po
@@ -148,7 +148,7 @@ msgstr ""
 ">>> import locale\n"
 ">>> locale.setlocale(locale.LC_ALL, 'English_United States.1252')\n"
 "'English_United States.1252'\n"
-">>> conv = locale.localeconv()          # get a mapping of conventions\n"
+">>> conv = locale.localeconv()          # 取得慣例的對映\n"
 ">>> x = 1234567.8\n"
 ">>> locale.format_string(\"%d\", x, grouping=True)\n"
 "'1,234,567'\n"
@@ -337,7 +337,7 @@ msgstr ""
 "    data = f.read()\n"
 "\n"
 "start = 0\n"
-"for i in range(3):                      # show the first 3 file headers\n"
+"for i in range(3):                      # 顯示前 3 個檔案標頭\n"
 "    start += 14\n"
 "    fields = struct.unpack('<IIIHH', data[start:start+16])\n"
 "    crc32, comp_size, uncomp_size, filenamesize, extra_size = fields\n"
@@ -348,7 +348,7 @@ msgstr ""
 "    extra = data[start:start+extra_size]\n"
 "    print(filename, hex(crc32), comp_size, uncomp_size)\n"
 "\n"
-"    start += extra_size + comp_size     # skip to the next header"
+"    start += extra_size + comp_size     # 跳到下一個標頭"
 
 #: ../../tutorial/stdlib2.rst:167
 msgid "Multi-threading"
@@ -578,18 +578,18 @@ msgstr ""
 "...     def __repr__(self):\n"
 "...         return str(self.value)\n"
 "...\n"
-">>> a = A(10)                   # create a reference\n"
+">>> a = A(10)                   # 建立一個參考\n"
 ">>> d = weakref.WeakValueDictionary()\n"
-">>> d['primary'] = a            # does not create a reference\n"
-">>> d['primary']                # fetch the object if it is still alive\n"
+">>> d['primary'] = a            # 不會建立參考\n"
+">>> d['primary']                # 如果物件仍然存在則取得它\n"
 "10\n"
-">>> del a                       # remove the one reference\n"
-">>> gc.collect()                # run garbage collection right away\n"
+">>> del a                       # 移除一個參考\n"
+">>> gc.collect()                # 立即執行垃圾回收\n"
 "0\n"
-">>> d['primary']                # entry was automatically removed\n"
+">>> d['primary']                # 項目被自動移除\n"
 "Traceback (most recent call last):\n"
 "  File \"<stdin>\", line 1, in <module>\n"
-"    d['primary']                # entry was automatically removed\n"
+"    d['primary']                # 項目被自動移除\n"
 "  File \"C:/python313/lib/weakref.py\", line 46, in __getitem__\n"
 "    o = self.data[key]()\n"
 "KeyError: 'primary'"
@@ -725,9 +725,9 @@ msgid ""
 msgstr ""
 ">>> from heapq import heapify, heappop, heappush\n"
 ">>> data = [1, 3, 5, 7, 9, 2, 4, 6, 8, 0]\n"
-">>> heapify(data)                      # rearrange the list into heap order\n"
-">>> heappush(data, -5)                 # add a new entry\n"
-">>> [heappop(data) for i in range(3)]  # fetch the three smallest entries\n"
+">>> heapify(data)                      # 將列表重新排列為堆積順序\n"
+">>> heappush(data, -5)                 # 加入新項目\n"
+">>> [heappop(data) for i in range(3)]  # 取得三個最小的項目\n"
 "[-5, 0, 1]"
 
 #: ../../tutorial/stdlib2.rst:356
