Complete translation of all tutorial .po files - 57 entries translated and 2 fuzzy entries fixed

Co-authored-by: mattwang44 <[email protected]>

Author: Copilot

tutorial/classes.po

@@ -375,6 +375,28 @@ msgid ""
 "scope_test()\n"
 "print(\"In global scope:\", spam)"
 msgstr ""
+"def scope_test():\n"
+"    def do_local():\n"
+"        spam = \"local spam\"\n"
+"\n"
+"    def do_nonlocal():\n"
+"        nonlocal spam\n"
+"        spam = \"nonlocal spam\"\n"
+"\n"
+"    def do_global():\n"
+"        global spam\n"
+"        spam = \"global spam\"\n"
+"\n"
+"    spam = \"test spam\"\n"
+"    do_local()\n"
+"    print(\"After local assignment:\", spam)\n"
+"    do_nonlocal()\n"
+"    print(\"After nonlocal assignment:\", spam)\n"
+"    do_global()\n"
+"    print(\"After global assignment:\", spam)\n"
+"\n"
+"scope_test()\n"
+"print(\"In global scope:\", spam)"
 
 #: ../../tutorial/classes.rst:191
 msgid "The output of the example code is:"
@@ -387,6 +409,10 @@ msgid ""
 "After global assignment: nonlocal spam\n"
 "In global scope: global spam"
 msgstr ""
+"After local assignment: test spam\n"
+"After nonlocal assignment: nonlocal spam\n"
+"After global assignment: nonlocal spam\n"
+"In global scope: global spam"
 
 #: ../../tutorial/classes.rst:200
 msgid ""
@@ -665,6 +691,7 @@ msgid ""
 "The other kind of instance attribute reference is a *method*. A method is a "
 "function that \"belongs to\" an object."
 msgstr ""
+"另一種執行個體屬性參考是 *方法* (method)。方法是\"屬於\"一個物件的函式。"
 
 #: ../../tutorial/classes.rst:345
 msgid ""
@@ -795,6 +822,23 @@ msgid ""
 ">>> e.name                  # unique to e\n"
 "'Buddy'"
 msgstr ""
+"class Dog:\n"
+"\n"
+"    kind = 'canine'         # class variable shared by all instances\n"
+"\n"
+"    def __init__(self, name):\n"
+"        self.name = name    # instance variable unique to each instance\n"
+"\n"
+">>> d = Dog('Fido')\n"
+">>> e = Dog('Buddy')\n"
+">>> d.kind                  # shared by all dogs\n"
+"'canine'\n"
+">>> e.kind                  # shared by all dogs\n"
+"'canine'\n"
+">>> d.name                  # unique to d\n"
+"'Fido'\n"
+">>> e.name                  # unique to e\n"
+"'Buddy'"
 
 #: ../../tutorial/classes.rst:422
 msgid ""
@@ -1363,6 +1407,24 @@ msgid ""
 "        for item in zip(keys, values):\n"
 "            self.items_list.append(item)"
 msgstr ""
+"class Mapping:\n"
+"    def __init__(self, iterable):\n"
+"        self.items_list = []\n"
+"        self.__update(iterable)\n"
+"\n"
+"    def update(self, iterable):\n"
+"        for item in iterable:\n"
+"            self.items_list.append(item)\n"
+"\n"
+"    __update = update   # private copy of original update() method\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"
+"        for item in zip(keys, values):\n"
+"            self.items_list.append(item)"
 
 #: ../../tutorial/classes.rst:718
 msgid ""
@@ -1592,6 +1654,20 @@ msgid ""
 "        self.index = self.index - 1\n"
 "        return self.data[self.index]"
 msgstr ""
+"class Reverse:\n"
+"    \"\"\"Iterator for looping over a sequence backwards.\"\"\"\n"
+"    def __init__(self, data):\n"
+"        self.data = data\n"
+"        self.index = len(data)\n"
+"\n"
+"    def __iter__(self):\n"
+"        return self\n"
+"\n"
+"    def __next__(self):\n"
+"        if self.index == 0:\n"
+"            raise StopIteration\n"
+"        self.index = self.index - 1\n"
+"        return self.data[self.index]"
 
 #: ../../tutorial/classes.rst:845
 msgid ""
@@ -1737,6 +1813,22 @@ 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"
+"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"
+"260\n"
+"\n"
+">>> unique_words = set(word for line in page  for word in line.split())\n"
+"\n"
+">>> valedictorian = max((student.gpa, student.name) for student in "
+"graduates)\n"
+"\n"
+">>> data = 'golf'\n"
+">>> list(data[i] for i in range(len(data)-1, -1, -1))\n"
+"['f', 'l', 'o', 'g']"
 
 #: ../../tutorial/classes.rst:932
 msgid "Footnotes"

tutorial/datastructures.po

@@ -457,6 +457,33 @@ msgid ""
 ">>> [num for elem in vec for num in elem]\n"
 "[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"
+">>> [x*2 for x in vec]\n"
+"[-8, -4, 0, 4, 8]\n"
+">>> # filter the list to exclude negative numbers\n"
+">>> [x for x in vec if x >= 0]\n"
+"[0, 2, 4]\n"
+">>> # apply a function to all the elements\n"
+">>> [abs(x) for x in vec]\n"
+"[4, 2, 0, 2, 4]\n"
+">>> # call a method on each element\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"
+">>> [(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"
+">>> [x, x**2 for x in range(6)]\n"
+"  File \"<stdin>\", line 1\n"
+"    [x, x**2 for x in range(6)]\n"
+"     ^^^^^^^\n"
+"SyntaxError: did you forget parentheses around the comprehension target?\n"
+">>> # flatten a list using a listcomp with two 'for'\n"
+">>> vec = [[1,2,3], [4,5,6], [7,8,9]]\n"
+">>> [num for elem in vec for num in elem]\n"
+"[1, 2, 3, 4, 5, 6, 7, 8, 9]"
 
 #: ../../tutorial/datastructures.rst:279
 msgid ""
@@ -856,6 +883,29 @@ msgid ""
 ">>> a ^ b                              # letters in a or b but not both\n"
 "{'r', 'd', 'b', 'm', 'z', 'l'}"
 msgstr ""
+">>> basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'}\n"
+">>> print(basket)                      # show that duplicates have been "
+"removed\n"
+"{'orange', 'banana', 'pear', 'apple'}\n"
+">>> 'orange' in basket                 # fast membership testing\n"
+"True\n"
+">>> 'crabgrass' in basket\n"
+"False\n"
+"\n"
+">>> # Demonstrate set operations on unique letters from two words\n"
+">>>\n"
+">>> a = set('abracadabra')\n"
+">>> b = set('alacazam')\n"
+">>> a                                  # unique letters in a\n"
+"{'a', 'r', 'b', 'c', 'd'}\n"
+">>> a - b                              # letters in a but not in b\n"
+"{'r', 'd', 'b'}\n"
+">>> a | b                              # letters in a or b or both\n"
+"{'a', 'c', 'r', 'd', 'b', 'm', 'z', 'l'}\n"
+">>> a & b                              # letters in both a and b\n"
+"{'a', 'c'}\n"
+">>> a ^ b                              # letters in a or b but not both\n"
+"{'r', 'd', 'b', 'm', 'z', 'l'}"
 
 #: ../../tutorial/datastructures.rst:482
 msgid ""

tutorial/floatingpoint.po

@@ -215,6 +215,14 @@ msgid ""
 ">>> repr(math.pi)\n"
 "'3.141592653589793'"
 msgstr ""
+">>> format(math.pi, '.12g')  # give 12 significant digits\n"
+"'3.14159265359'\n"
+"\n"
+">>> format(math.pi, '.2f')   # give 2 digits after the point\n"
+"'3.14'\n"
+"\n"
+">>> repr(math.pi)\n"
+"'3.141592653589793'"
 
 #: ../../tutorial/floatingpoint.rst:111
 msgid ""
@@ -492,6 +500,23 @@ msgid ""
 "digits!\n"
 "-0.0051575902860057365"
 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"
+"8.042173697819788e-13\n"
+">>> math.fsum(arr)                   # Single rounding\n"
+"8.042173697819788e-13\n"
+">>> sum(arr)                         # Multiple roundings in extended "
+"precision\n"
+"8.042178034628478e-13\n"
+">>> total = 0.0\n"
+">>> for x in arr:\n"
+"...     total += x                   # Multiple roundings in standard "
+"precision\n"
+"...\n"
+">>> total                            # Straight addition has no correct "
+"digits!\n"
+"-0.0051575902860057365"
 
 #: ../../tutorial/floatingpoint.rst:260
 msgid "Representation Error"

tutorial/interpreter.po

@@ -221,6 +221,11 @@ msgid ""
 "...\n"
 "Be careful not to fall off!"
 msgstr ""
+">>> the_world_is_flat = True\n"
+">>> if the_world_is_flat:\n"
+"...     print(\"Be careful not to fall off!\")\n"
+"...\n"
+"Be careful not to fall off!"
 
 #: ../../tutorial/interpreter.rst:118
 msgid "For more on interactive mode, see :ref:`tut-interac`."
@@ -274,7 +279,7 @@ msgstr "比如，聲明使用 Windows-1252 編碼，源碼檔案要寫成： ::"
 
 #: ../../tutorial/interpreter.rst:150
 msgid "# -*- coding: cp1252 -*-"
-msgstr ""
+msgstr "# -*- coding: cp1252 -*-"
 
 #: ../../tutorial/interpreter.rst:152
 msgid ""

tutorial/modules.po

@@ -861,6 +861,29 @@ msgid ""
 "              karaoke.py\n"
 "              ..."
 msgstr ""
+"sound/                          Top-level package\n"
+"      __init__.py               Initialize the sound package\n"
+"      formats/                  Subpackage for file format conversions\n"
+"              __init__.py\n"
+"              wavread.py\n"
+"              wavwrite.py\n"
+"              aiffread.py\n"
+"              aiffwrite.py\n"
+"              auread.py\n"
+"              auwrite.py\n"
+"              ...\n"
+"      effects/                  Subpackage for sound effects\n"
+"              __init__.py\n"
+"              echo.py\n"
+"              surround.py\n"
+"              reverse.py\n"
+"              ...\n"
+"      filters/                  Subpackage for filters\n"
+"              __init__.py\n"
+"              equalizer.py\n"
+"              vocoder.py\n"
+"              karaoke.py\n"
+"              ..."
 
 #: ../../tutorial/modules.rst:438
 msgid ""
@@ -1046,6 +1069,14 @@ msgid ""
 "def reverse(msg: str):  # <-- this name shadows the 'reverse.py' submodule\n"
 "    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"
+"]\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 *'"
 
 #: ../../tutorial/modules.rst:534
 msgid ""

tutorial/stdlib2.po

@@ -145,6 +145,16 @@ msgid ""
 "...                      conv['frac_digits'], x), grouping=True)\n"
 "'$1,234,567.80'"
 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"
+">>> x = 1234567.8\n"
+">>> locale.format_string(\"%d\", x, grouping=True)\n"
+"'1,234,567'\n"
+">>> locale.format_string(\"%s%.*f\", (conv['currency_symbol'],\n"
+"...                      conv['frac_digits'], x), grouping=True)\n"
+"'$1,234,567.80'"
 
 #: ../../tutorial/stdlib2.rst:72
 msgid "Templating"
@@ -321,6 +331,24 @@ msgid ""
 "\n"
 "    start += extra_size + comp_size     # skip to the next header"
 msgstr ""
+"import struct\n"
+"\n"
+"with open('myfile.zip', 'rb') as f:\n"
+"    data = f.read()\n"
+"\n"
+"start = 0\n"
+"for i in range(3):                      # show the first 3 file headers\n"
+"    start += 14\n"
+"    fields = struct.unpack('<IIIHH', data[start:start+16])\n"
+"    crc32, comp_size, uncomp_size, filenamesize, extra_size = fields\n"
+"\n"
+"    start += 16\n"
+"    filename = data[start:start+filenamesize]\n"
+"    start += filenamesize\n"
+"    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"
 
 #: ../../tutorial/stdlib2.rst:167
 msgid "Multi-threading"
@@ -543,6 +571,28 @@ msgid ""
 "    o = self.data[key]()\n"
 "KeyError: 'primary'"
 msgstr ""
+">>> import weakref, gc\n"
+">>> class A:\n"
+"...     def __init__(self, value):\n"
+"...         self.value = value\n"
+"...     def __repr__(self):\n"
+"...         return str(self.value)\n"
+"...\n"
+">>> a = A(10)                   # create a reference\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"
+"10\n"
+">>> del a                       # remove the one reference\n"
+">>> gc.collect()                # run garbage collection right away\n"
+"0\n"
+">>> d['primary']                # entry was automatically removed\n"
+"Traceback (most recent call last):\n"
+"  File \"<stdin>\", line 1, in <module>\n"
+"    d['primary']                # entry was automatically removed\n"
+"  File \"C:/python313/lib/weakref.py\", line 46, in __getitem__\n"
+"    o = self.data[key]()\n"
+"KeyError: 'primary'"
 
 #: ../../tutorial/stdlib2.rst:290
 msgid "Tools for Working with Lists"
@@ -673,6 +723,12 @@ msgid ""
 ">>> [heappop(data) for i in range(3)]  # fetch the three smallest entries\n"
 "[-5, 0, 1]"
 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"
+"[-5, 0, 1]"
 
 #: ../../tutorial/stdlib2.rst:356
 msgid "Decimal Floating-Point Arithmetic"