Translate code comments and docstrings (batch 1)

Copilot · mattwang44 · Copilot · commit 969797e34e35 · 2025-07-14T06:16:19.000Z
Co-authored-by: mattwang44 &lt;24987826+mattwang44@users.noreply.github.com&gt;
diff --git a/tutorial/classes.po b/tutorial/classes.po
@@ -831,9 +831,9 @@ msgstr ""
 "\n"
 ">>> d = Dog('Fido')\n"
 ">>> e = Dog('Buddy')\n"
-">>> d.kind                  # 所有狗共享\n"
+">>> d.kind                  # 為所有 Dog 實例所共享\n"
 "'canine'\n"
-">>> e.kind                  # 所有狗共享\n"
+">>> e.kind                  # 為所有 Dog 實例所共享\n"
 "'canine'\n"
 ">>> d.name                  # d 獨有\n"
 "'Fido'\n"
@@ -1397,7 +1397,7 @@ msgid ""
 "        for item in iterable:\n"
 "            self.items_list.append(item)\n"
 "\n"
-"    __update = update   # private copy of original update() method\n"
+"    __update = update   # 原始 update() 方法的私有副本\n"
 "\n"
 "class MappingSubclass(Mapping):\n"
 "\n"
@@ -1416,13 +1416,13 @@ msgstr ""
 "        for item in iterable:\n"
 "            self.items_list.append(item)\n"
 "\n"
-"    __update = update   # private copy of original update() method\n"
+"    __update = update   # 原始 update() 方法的私有副本\n"
 "\n"
 "class MappingSubclass(Mapping):\n"
 "\n"
 "    def update(self, keys, values):\n"
-"        # provides new signature for update()\n"
-"        # but does not break __init__()\n"
+"        # 為 update() 提供新的函式簽名\n"
+"        # 但不會破壞 __init__()\n"
 "        for item in zip(keys, values):\n"
 "            self.items_list.append(item)"
 
@@ -1655,7 +1655,7 @@ msgid ""
 "        return self.data[self.index]"
 msgstr ""
 "class Reverse:\n"
-"    \"\"\"用於向後迴圈遍歷序列的迭代器。\"\"\"\n"
+"    \"\"\"用於向後迴圈遍歷序列的疊代器。\"\"\"\n"
 "    def __init__(self, data):\n"
 "        self.data = data\n"
 "        self.index = len(data)\n"
@@ -1813,12 +1813,12 @@ msgid ""
 ">>> list(data[i] for i in range(len(data)-1, -1, -1))\n"
 "['f', 'l', 'o', 'g']"
 msgstr ""
-">>> sum(i*i for i in range(10))                 # sum of squares\n"
+">>> sum(i*i for i in range(10))                 # 平方和\n"
 "285\n"
 "\n"
 ">>> xvec = [10, 20, 30]\n"
 ">>> yvec = [7, 5, 3]\n"
-">>> sum(x*y for x,y in zip(xvec, yvec))         # dot product\n"
+">>> sum(x*y for x,y in zip(xvec, yvec))         # 向量內積\n"
 "260\n"
 "\n"
 ">>> unique_words = set(word for line in page  for word in line.split())\n"
diff --git a/tutorial/controlflow.po b/tutorial/controlflow.po
@@ -125,7 +125,7 @@ msgid ""
 "window 6\n"
 "defenestrate 12"
 msgstr ""
-">>> # Measure some strings:\n"
+">>> # 測量一些字串：\n"
 ">>> words = ['cat', 'window', 'defenestrate']\n"
 ">>> for w in words:\n"
 "...     print(w, len(w))\n"
@@ -162,7 +162,7 @@ msgstr ""
 "# 建立一個範例集合\n"
 "users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'}\n"
 "\n"
-"# 策略：對副本進行迭代\n"
+"# 策略：對副本進行疊代\n"
 "for user, status in users.copy().items():\n"
 "    if status == 'inactive':\n"
 "        del users[user]\n"
@@ -470,7 +470,7 @@ msgstr ""
 "...             print(n, 'equals', x, '*', n//x)\n"
 "...             break\n"
 "...     else:\n"
-"...         # loop fell through without finding a factor\n"
+"...         # 迴圈結束但沒有找到因數\n"
 "...         print(n, 'is a prime number')\n"
 "...\n"
 "2 is a prime number\n"
@@ -536,7 +536,7 @@ msgid ""
 "..."
 msgstr ""
 ">>> while True:\n"
-"...     pass  # Busy-wait for keyboard interrupt (Ctrl+C)\n"
+"...     pass  # 忙碌等待鍵盤中斷 (Ctrl+C)\n"
 "..."
 
 #: ../../tutorial/controlflow.rst:266
@@ -570,7 +570,7 @@ msgid ""
 "..."
 msgstr ""
 ">>> def initlog(*args):\n"
-"...     pass   # Remember to implement this!\n"
+"...     pass   # 記得要實作這個！\n"
 "..."
 
 #: ../../tutorial/controlflow.rst:284
@@ -667,7 +667,7 @@ msgid ""
 "    case _:\n"
 "        raise ValueError(\"Not a point\")"
 msgstr ""
-"# point is an (x, y) tuple\n"
+"# point 是一個 (x, y) 元組\n"
 "match point:\n"
 "    case (0, 0):\n"
 "        print(\"Origin\")\n"
@@ -987,15 +987,15 @@ msgid ""
 ">>> fib(2000)\n"
 "0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597"
 msgstr ""
-">>> def fib(n):    # write Fibonacci series less than n\n"
-"...     \"\"\"Print a Fibonacci series less than n.\"\"\"\n"
+">>> def fib(n):    # 寫出小於 n 的費氏數列\n"
+"...     \"\"\"印出小於 n 的費氏數列。\"\"\"\n"
 "...     a, b = 0, 1\n"
 "...     while a < n:\n"
 "...         print(a, end=' ')\n"
 "...         a, b = b, a+b\n"
 "...     print()\n"
 "...\n"
-">>> # Now call the function we just defined:\n"
+">>> # 現在呼叫我們剛才定義的函式：\n"
 ">>> fib(2000)\n"
 "0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597"
 
@@ -1131,17 +1131,17 @@ msgid ""
 ">>> f100                # write the result\n"
 "[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]"
 msgstr ""
-">>> def fib2(n):  # return Fibonacci series up to n\n"
-"...     \"\"\"Return a list containing the Fibonacci series up to n.\"\"\"\n"
+">>> def fib2(n):  # 回傳到 n 為止的費氏數列\n"
+"...     \"\"\"回傳包含到 n 為止的費氏數列的列表。\"\"\"\n"
 "...     result = []\n"
 "...     a, b = 0, 1\n"
 "...     while a < n:\n"
-"...         result.append(a)    # see below\n"
+"...         result.append(a)    # 見下方\n"
 "...         a, b = b, a+b\n"
 "...     return result\n"
 "...\n"
-">>> f100 = fib2(100)    # call it\n"
-">>> f100                # write the result\n"
+">>> f100 = fib2(100)    # 呼叫它\n"
+">>> f100                # 寫出結果\n"
 "[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]"
 
 #: ../../tutorial/controlflow.rst:550
@@ -1401,9 +1401,9 @@ msgid ""
 msgstr ""
 "parrot(1000)                                          # 1 positional "
 "argument\n"
-"parrot(voltage=1000)                                  # 1 keyword argument\n"
-"parrot(voltage=1000000, action='VOOOOOM')             # 2 keyword arguments\n"
-"parrot(action='VOOOOOM', voltage=1000000)             # 2 keyword arguments\n"
+"parrot(voltage=1000)                                  # 1 個關鍵字引數\n"
+"parrot(voltage=1000000, action='VOOOOOM')             # 2 個關鍵字引數\n"
+"parrot(action='VOOOOOM', voltage=1000000)             # 2 個關鍵字引數\n"
 "parrot('a million', 'bereft of life', 'jump')         # 3 positional "
 "arguments\n"
 "parrot('a thousand', state='pushing up the daisies')  # 1 positional, 1 "
@@ -1421,11 +1421,11 @@ msgid ""
 "parrot(110, voltage=220)     # duplicate value for the same argument\n"
 "parrot(actor='John Cleese')  # unknown keyword argument"
 msgstr ""
-"parrot()                     # required argument missing\n"
+"parrot()                     # 缺少必要引數\n"
 "parrot(voltage=5.0, 'dead')  # non-keyword argument after a keyword "
 "argument\n"
-"parrot(110, voltage=220)     # duplicate value for the same argument\n"
-"parrot(actor='John Cleese')  # unknown keyword argument"
+"parrot(110, voltage=220)     # 同一個引數有重複值\n"
+"parrot(actor='John Cleese')  # 未知的關鍵字引數"
 
 #: ../../tutorial/controlflow.rst:684
 msgid ""
@@ -1989,7 +1989,7 @@ msgid ""
 "list\n"
 "[3, 4, 5]"
 msgstr ""
-">>> list(range(3, 6))            # normal call with separate arguments\n"
+">>> list(range(3, 6))            # 使用分離引數的一般呼叫\n"
 "[3, 4, 5]\n"
 ">>> args = [3, 6]\n"
 ">>> list(range(*args))            # call with arguments unpacked from a "
@@ -2160,9 +2160,9 @@ msgid ""
 "No, really, it doesn't do anything."
 msgstr ""
 ">>> def my_function():\n"
-"...     \"\"\"Do nothing, but document it.\n"
+"...     \"\"\"不做任何事，但有文件說明。\n"
 "...\n"
-"...     No, really, it doesn't do anything.\n"
+"...     不，真的，它什麼都不做。\n"
 "...     \"\"\"\n"
 "...     pass\n"
 "...\n"
diff --git a/tutorial/datastructures.po b/tutorial/datastructures.po
@@ -458,23 +458,23 @@ msgid ""
 "[1, 2, 3, 4, 5, 6, 7, 8, 9]"
 msgstr ""
 ">>> vec = [-4, -2, 0, 2, 4]\n"
-">>> # create a new list with the values doubled\n"
+">>> # 建立一個值加倍的新列表\n"
 ">>> [x*2 for x in vec]\n"
 "[-8, -4, 0, 4, 8]\n"
-">>> # filter the list to exclude negative numbers\n"
+">>> # 過濾列表以排除負數\n"
 ">>> [x for x in vec if x >= 0]\n"
 "[0, 2, 4]\n"
-">>> # apply a function to all the elements\n"
+">>> # 對所有元素套用函式\n"
 ">>> [abs(x) for x in vec]\n"
 "[4, 2, 0, 2, 4]\n"
-">>> # call a method on each element\n"
+">>> # 對每個元素呼叫方法\n"
 ">>> freshfruit = ['  banana', '  loganberry ', 'passion fruit  ']\n"
 ">>> [weapon.strip() for weapon in freshfruit]\n"
 "['banana', 'loganberry', 'passion fruit']\n"
-">>> # create a list of 2-tuples like (number, square)\n"
+">>> # 建立像 (數字, 平方) 的 2-元組列表\n"
 ">>> [(x, x**2) for x in range(6)]\n"
 "[(0, 0), (1, 1), (2, 4), (3, 9), (4, 16), (5, 25)]\n"
-">>> # the tuple must be parenthesized, otherwise an error is raised\n"
+">>> # 元組必須加上括號，否則會產生錯誤\n"
 ">>> [x, x**2 for x in range(6)]\n"
 "  File \"<stdin>\", line 1\n"
 "    [x, x**2 for x in range(6)]\n"
@@ -887,24 +887,24 @@ msgstr ""
 ">>> print(basket)                      # show that duplicates have been "
 "removed\n"
 "{'orange', 'banana', 'pear', 'apple'}\n"
-">>> 'orange' in basket                 # fast membership testing\n"
+">>> 'orange' in basket                 # 快速成員測試\n"
 "True\n"
 ">>> 'crabgrass' in basket\n"
 "False\n"
 "\n"
-">>> # Demonstrate set operations on unique letters from two words\n"
+">>> # 示範對兩個字的唯一字母進行集合運算\n"
 ">>>\n"
 ">>> a = set('abracadabra')\n"
 ">>> b = set('alacazam')\n"
-">>> a                                  # unique letters in a\n"
+">>> a                                  # a 中的唯一字母\n"
 "{'a', 'r', 'b', 'c', 'd'}\n"
-">>> a - b                              # letters in a but not in b\n"
+">>> a - b                              # 在 a 中但不在 b 中的字母\n"
 "{'r', 'd', 'b'}\n"
-">>> a | b                              # letters in a or b or both\n"
+">>> a | b                              # 在 a 或 b 或兩者中的字母\n"
 "{'a', 'c', 'r', 'd', 'b', 'm', 'z', 'l'}\n"
-">>> a & b                              # letters in both a and b\n"
+">>> a & b                              # 同時在 a 和 b 中的字母\n"
 "{'a', 'c'}\n"
-">>> a ^ b                              # letters in a or b but not both\n"
+">>> a ^ b                              # 在 a 或 b 中但不在兩者中的字母\n"
 "{'r', 'd', 'b', 'm', 'z', 'l'}"
 
 #: ../../tutorial/datastructures.rst:482
diff --git a/tutorial/floatingpoint.po b/tutorial/floatingpoint.po
@@ -215,10 +215,10 @@ msgid ""
 ">>> repr(math.pi)\n"
 "'3.141592653589793'"
 msgstr ""
-">>> format(math.pi, '.12g')  # give 12 significant digits\n"
+">>> format(math.pi, '.12g')  # 給出 12 個有效位數\n"
 "'3.14159265359'\n"
 "\n"
-">>> format(math.pi, '.2f')   # give 2 digits after the point\n"
+">>> format(math.pi, '.2f')   # 小數點後給出 2 位數字\n"
 "'3.14'\n"
 "\n"
 ">>> repr(math.pi)\n"
@@ -502,9 +502,9 @@ msgid ""
 msgstr ""
 ">>> arr = [-0.10430216751806065, -266310978.67179024, 143401161448607.16,\n"
 "...        -143401161400469.7, 266262841.31058735, -0.003244936839808227]\n"
-">>> float(sum(map(Fraction, arr)))   # Exact summation with single rounding\n"
+">>> float(sum(map(Fraction, arr)))   # 單次四捨五入的精確加總\n"
 "8.042173697819788e-13\n"
-">>> math.fsum(arr)                   # Single rounding\n"
+">>> math.fsum(arr)                   # 單次四捨五入\n"
 "8.042173697819788e-13\n"
 ">>> sum(arr)                         # Multiple roundings in extended "
 "precision\n"
diff --git a/tutorial/introduction.po b/tutorial/introduction.po
@@ -75,10 +75,10 @@ msgid ""
 "          # ... and now a third!\n"
 "text = \"# This is not a comment because it's inside quotes.\""
 msgstr ""
-"# this is the first comment\n"
-"spam = 1  # and this is the second comment\n"
-"          # ... and now a third!\n"
-"text = \"# This is not a comment because it's inside quotes.\""
+"# 這是第一個註解\n"
+"spam = 1  # 這是第二個註解\n"
+"          # ... 現在是第三個！\n"
+"text = \"# 這不是註解，因為它在引號內。\""
 
 #: ../../tutorial/introduction.rst:41
 msgid "Using Python as a Calculator"
@@ -124,7 +124,7 @@ msgstr ""
 "20\n"
 ">>> (50 - 5*6) / 4\n"
 "5.0\n"
-">>> 8 / 5  # division always returns a floating-point number\n"
+">>> 8 / 5  # 除法總是回傳浮點數\n"
 "1.6"
 
 #: ../../tutorial/introduction.rst:67
@@ -158,14 +158,14 @@ msgid ""
 ">>> 5 * 3 + 2  # floored quotient * divisor + remainder\n"
 "17"
 msgstr ""
-">>> 17 / 3  # classic division returns a float\n"
+">>> 17 / 3  # 傳統除法回傳浮點數\n"
 "5.666666666666667\n"
 ">>>\n"
-">>> 17 // 3  # floor division discards the fractional part\n"
+">>> 17 // 3  # 下取整除法捨棄小數部分\n"
 "5\n"
-">>> 17 % 3  # the % operator returns the remainder of the division\n"
+">>> 17 % 3  # % 運算子回傳除法的餘數\n"
 "2\n"
-">>> 5 * 3 + 2  # floored quotient * divisor + remainder\n"
+">>> 5 * 3 + 2  # 下取整商 * 除數 + 餘數\n"
 "17"
 
 #: ../../tutorial/introduction.rst:85
@@ -181,9 +181,9 @@ msgid ""
 ">>> 2 ** 7  # 2 to the power of 7\n"
 "128"
 msgstr ""
-">>> 5 ** 2  # 5 squared\n"
+">>> 5 ** 2  # 5 的平方\n"
 "25\n"
-">>> 2 ** 7  # 2 to the power of 7\n"
+">>> 2 ** 7  # 2 的 7 次方\n"
 "128"
 
 #: ../../tutorial/introduction.rst:92
