From 7780a769f6d50a43efdfa5ff10226c21d8f69ed9 Mon Sep 17 00:00:00 2001 From: Liang-Bo Wang Date: Thu, 12 Jul 2018 20:52:12 +0800 Subject: [PATCH] WIP: Add translation of tutorial/controlflow Complete translation until section 4.7. More on Defining Functions --- tutorial/controlflow.po | 64 +++++++++++++++++++++++++++++++++++------ 1 file changed, 56 insertions(+), 8 deletions(-) diff --git a/tutorial/controlflow.po b/tutorial/controlflow.po index f5ee62a4ce..f4f88f346f 100644 --- a/tutorial/controlflow.po +++ b/tutorial/controlflow.po @@ -10,16 +10,17 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6 TW\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-06-26 18:54+0800\n" -"PO-Revision-Date: 2018-05-23 16:18+0000\n" -"Last-Translator: Adrian Liaw \n" +"POT-Creation-Date: 2018-05-23 22:27+0800\n" +"PO-Revision-Date: 2018-07-12 20:50+0800\n" +"Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese Traditional (http://www.transifex.com/python-tw-doc/" "python-36-tw/language/zh-Hant/)\n" -"Language: zh_TW\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: zh_TW\n" "Plural-Forms: nplurals=1; plural=0;\n" +"X-Generator: Poedit 2.0.8\n" #: ../../tutorial/controlflow.rst:5 msgid "More Control Flow Tools" @@ -98,6 +99,8 @@ msgid "" "With ``for w in words:``, the example would attempt to create an infinite " "list, inserting ``defenestrate`` over and over again." msgstr "" +"在 ``for w in words:`` 的情況，這個例子會試著重覆不斷地插入 " +"``defenestrate``，產生一個無限長的 list。" #: ../../tutorial/controlflow.rst:88 msgid "The :func:`range` Function" @@ -122,7 +125,7 @@ msgid "" msgstr "" "給定的結束值永遠不會出現在生成的序列中；\\ ``range(10)`` 生成的 10 個數值，即" "對應存取一個長度為 10 的序列內每一個元素的索引值。也可以讓 range 從其他數值計" -"數，或者給定不同的級距（甚至為負；有時稱之為 'step'）：\n" +"數，或者給定不同的級距（甚至為負；有時稱之為 step）：\n" "\n" "::" @@ -195,6 +198,8 @@ msgid "" "The :keyword:`break` statement, like in C, breaks out of the innermost " "enclosing :keyword:`for` or :keyword:`while` loop." msgstr "" +":keyword:`break` 陳述，如同 C 語言，終止包含其最內部的 :keyword:`for` 或 :" +"keyword:`while` 迴圈。" #: ../../tutorial/controlflow.rst:163 msgid "" @@ -237,7 +242,7 @@ msgid "" "The :keyword:`continue` statement, also borrowed from C, continues with the " "next iteration of the loop::" msgstr "" -":keyword:`continue` 陳述，亦承襲於 C 語言，讓迴圈於下個选代起繼續執行：\n" +":keyword:`continue` 陳述，亦承襲於 C 語言，讓所屬的迴圈繼續執行下個选代：\n" "\n" "::" @@ -270,7 +275,7 @@ msgid "" "ignored::" msgstr "" ":keyword:`pass` 亦可作為一個函式或條件判斷主體的預留位置，它可幫助你以更宏觀" -"的角度思考並撰寫新的程式碼。\\ :keyword:`pass` 可自動忽略：\n" +"的角度思考並撰寫新的程式碼。\\ :keyword:`pass` 可被忽略：\n" "\n" "::" @@ -283,6 +288,9 @@ msgid "" "We can create a function that writes the Fibonacci series to an arbitrary " "boundary::" msgstr "" +"我們可以建立一個函式來產生費式數列到任何一個上界：\n" +"\n" +"::" #: ../../tutorial/controlflow.rst:265 msgid "" @@ -291,6 +299,8 @@ msgid "" "parameters. The statements that form the body of the function start at the " "next line, and must be indented." msgstr "" +"關鍵字 :keyword:`def` 帶入一個函式的\\ *定義*。它之後必須連著該函式的名稱和置" +"於括號之中的參數們。自下一行起，所有縮排的陳述成為該函式的主體。" #: ../../tutorial/controlflow.rst:270 msgid "" @@ -302,6 +312,11 @@ msgid "" "through code; it's good practice to include docstrings in code that you " "write, so make a habit of it." msgstr "" +"一個函式的第一個陳述可以是一個字串值；此情況該字串值被視為該函式的說明文件字" +"串，即 :dfn:`docstring`\\ 。（關於 docstring 的細節請參見\\ :ref:`tut-" +"docstrings`\\ 段落。）有些工具可以使用 docstring 來自動產生線上或可列印的文" +"件，或讓使用者能自由地自原始碼中瀏覽文件。在原始碼中加入 docstring 是個好慣" +"例，應該養成這樣的習慣。" #: ../../tutorial/controlflow.rst:277 msgid "" @@ -314,6 +329,11 @@ msgid "" "assigned a value within a function (unless named in a :keyword:`global` " "statement), although they may be referenced." msgstr "" +"函式執行期間會建立一個新的符號表（symbol table）來儲存該函式內的區域變數。更" +"精確地說，所有在函式內的變數賦值都會把該值儲存在一個區域符號表。然而，在讀取" +"一個變數時，會先從區域符號表起搜尋，其次為所有包含其函式的區域符號表們，其次" +"為全域符號表，最後為所有內建的名稱。因此，在函式中，全域變數無法被直接賦值" +"（除非該變數是透過 :keyword:`global` 陳述建立），但它們可以被讀取。" #: ../../tutorial/controlflow.rst:286 msgid "" @@ -323,6 +343,10 @@ msgid "" "*reference*, not the value of the object). [#]_ When a function calls " "another function, a new local symbol table is created for that call." msgstr "" +"在一個函式被呼叫的時候，實際傳入的參數們（引數）會被加入至該函數的區域符號" +"表。因此，引數傳入的方式為\\ *傳值呼叫 (call by value)*\\ （這裡傳遞的「值」" +"永遠是一個物件的參照，而不是該物件的值）。\\ [#]_ 當一個函式呼叫別的函式時，" +"在被呼叫的函式中會建立一個新的區域符號表。" #: ../../tutorial/controlflow.rst:292 msgid "" @@ -332,6 +356,11 @@ msgid "" "another name which can then also be used as a function. This serves as a " "general renaming mechanism::" msgstr "" +"一個函式定義會把該函式名稱加入至當前的符號表。該函式名稱的值帶有一個型別，並" +"被直譯器辨識為使用者自定函式。該值可以被賦予別的變數名。這即是常見的重新命名" +"方式：\n" +"\n" +"::" #: ../../tutorial/controlflow.rst:304 msgid "" @@ -343,16 +372,25 @@ msgid "" "the only value written. You can see it if you really want to using :func:" "`print`::" msgstr "" +"如果你是來自別的語言，你可能不同意 ``fib`` 是個函式，而是個程序 (procedure)，" +"因為它為沒有回傳值。實際上，即使一個函式缺少一個 :keyword:`return` 陳述，它亦" +"有一個固定的回傳值。這個值為 ``None``\\ （它是一個內建名稱）。在直譯器中單獨" +"使用 ``None`` 時，通常不會被顯示。你可以使用 :func:`print` 來看到它：\n" +"\n" +"::" #: ../../tutorial/controlflow.rst:315 msgid "" "It is simple to write a function that returns a list of the numbers of the " "Fibonacci series, instead of printing it::" msgstr "" +"如果要寫一個函式回傳費式數列的 list 而不是直接印出它，這也很容易：\n" +"\n" +"::" #: ../../tutorial/controlflow.rst:331 msgid "This example, as usual, demonstrates some new Python features:" -msgstr "" +msgstr "這個例子一樣示範了一些新的 Python 特性：" #: ../../tutorial/controlflow.rst:333 msgid "" @@ -360,6 +398,8 @@ msgid "" "keyword:`return` without an expression argument returns ``None``. Falling " "off the end of a function also returns ``None``." msgstr "" +":keyword:`return` 陳述會讓一個函式回傳一個值。單獨使用 :keyword:`return` 不外" +"加一個表達引數會回傳 ``None``\\ 。一個函式執行到結束也會回傳 ``None``\\ 。" #: ../../tutorial/controlflow.rst:337 msgid "" @@ -374,6 +414,14 @@ msgid "" "for list objects; it adds a new element at the end of the list. In this " "example it is equivalent to ``result = result + [a]``, but more efficient." msgstr "" +"``result.append(a)`` 陳述呼叫了一個 list 物件 ``result`` 的 method（方法）。" +"method 為「屬於」一個物件的函式，命名規則為 ``obj.methodname``\\ ，其中 " +"``obj`` 為某個物件（亦可為一表達式），而 ``methodname`` 為該 method 的名稱，" +"並被該物件決定其型別。不同的型別代表不同的 method。不同型別的 method 可以擁有" +"一樣的名稱而不會讓 Python 混淆。（你可以使用 class 定自己的物件型別和 " +"method，見 :ref:`tut-classes`\\ ）這裡 :meth:`append` method 定義在 list 物件" +"中；它會加入一個新的元素在該 list 的末端。這個例子等同於 ``result = result + " +"[a]``\\ ，但更有效率。" #: ../../tutorial/controlflow.rst:352 msgid "More on Defining Functions"