fix: resolve fuzzy entries in faq

mattwang44 · mattwang44 · commit c9179c1cf797 · 2023-07-19T01:00:30.000+08:00
diff --git a/faq/design.po b/faq/design.po
@@ -235,7 +235,6 @@ msgstr ""
 "綴 ``m_``，所以這種明確性在那些語言也是很好用的。"
 
 #: ../../faq/design.rst:127
-#, fuzzy
 msgid ""
 "Second, it means that no special syntax is necessary if you want to "
 "explicitly reference or call the method from a particular class.  In C++, if "
@@ -249,8 +248,8 @@ msgstr ""
 "第二，當你想明確地使用或呼叫在某個類別裡的方法的時候，你不需要特殊的語法。在 "
 "C++ 裡，如果你想用一個在繼承類別時被覆寫的基底類別方法，必須要用 ``::`` 運算"
 "子 -- 但在 Python 裡，你可以直接寫成 ``baseclass.methodname(self, <argument "
-"list>)``。這在 :meth:`__init__` 方法很好用，特別是在一個繼承的類別要擴充基底"
-"類別的方法而要呼叫他時。"
+"list>)``。這在 :meth:`~object.__init__` 方法很好用，特別是在一個繼承的類別要"
+"擴充基底類別的方法而要呼叫他時。"
 
 #: ../../faq/design.rst:136
 msgid ""
@@ -425,14 +424,14 @@ msgid "How fast are exceptions?"
 msgstr "例外處理有多快？"
 
 #: ../../faq/design.rst:235
-#, fuzzy
 msgid ""
 "A :keyword:`try`/:keyword:`except` block is extremely efficient if no "
 "exceptions are raised.  Actually catching an exception is expensive.  In "
 "versions of Python prior to 2.0 it was common to use this idiom::"
 msgstr ""
-"如果沒有例外被丟出，一個 try/except 區塊是非常有效率的。事實上，抓捕例外要付"
-"出昂貴的代價。在 Python 2.0 以前，這樣使用是相當常見的：\n"
+"如果沒有例外被丟出，一個 :keyword:`try`/:keyword:`except` 區塊是非常有效率"
+"的。事實上，抓捕例外要付出昂貴的代價。在 Python 2.0 以前，這樣使用是相當常見"
+"的：\n"
 "\n"
 "::"
 
@@ -613,16 +612,15 @@ msgstr ""
 "::"
 
 #: ../../faq/design.rst:355
-#, fuzzy
 msgid ""
 "Indeed, using CPython's reference counting and destructor scheme, each new "
 "assignment to ``f`` closes the previous file.  With a traditional GC, "
 "however, those file objects will only get collected (and closed) at varying "
 "and possibly long intervals."
 msgstr ""
-"實際上，使用 CPython 的參照計次和解構方案 (destructor scheme)，每個對\\ "
-"*f*\\ 的新指派都會關閉前面打開的檔案。然而用傳統的垃圾回收 (GC) 的話，這些檔"
-"案物件只會在不固定且有可能很長的時間後被收集（並關閉）。"
+"實際上，使用 CPython 的參照計次和解構方案 (destructor scheme)，每個對 ``f`` "
+"的新指派都會關閉前面打開的檔案。然而用傳統的垃圾回收 (GC) 的話，這些檔案物件"
+"只會在不固定且有可能很長的時間後被收集（並關閉）。"
 
 #: ../../faq/design.rst:360
 msgid ""
@@ -653,7 +651,6 @@ msgstr ""
 "大多數是通透的，也並不完全，要讓它跟 Python 相容還是需要做一些修補。）"
 
 #: ../../faq/design.rst:378
-#, fuzzy
 msgid ""
 "Traditional GC also becomes a problem when Python is embedded into other "
 "applications.  While in a standalone Python it's fine to replace the "
@@ -664,10 +661,10 @@ msgid ""
 "``free()`` properly."
 msgstr ""
 "傳統的垃圾收集 (GC) 在 Python 被嵌入其他應用程式時也成了一個問題。在獨立的 "
-"Python 程式裡當然可以把標準的 malloc() 和 free() 換成 GC 函式庫提供的其他版"
-"本；但一個嵌著 Python 的應用程式可能想用\\ *自己*\\ 的 malloc() 和 free() 替"
-"代品，而不是用 Python 的。以現在來說，CPython 和實作 malloc() 和 free() 的程"
-"式相處融洽。"
+"Python 程式裡當然可以把標準的 ``malloc()`` 和 ``free()`` 換成 GC 函式庫提供的"
+"其他版本；但一個嵌著 Python 的應用程式可能想用\\ *自己*\\ 的 malloc() 和 "
+"free() 替代品，而不是用 Python 的。以現在來說，CPython 和實作 malloc() 和 "
+"free() 的程式相處融洽。"
 
 #: ../../faq/design.rst:387
 msgid "Why isn't all memory freed when CPython exits?"
@@ -700,7 +697,6 @@ msgid "Why are there separate tuple and list data types?"
 msgstr "為何要把元組 (tuple) 和串列 (list) 分成兩個資料型態？"
 
 #: ../../faq/design.rst:403
-#, fuzzy
 msgid ""
 "Lists and tuples, while similar in many respects, are generally used in "
 "fundamentally different ways.  Tuples can be thought of as being similar to "
@@ -710,12 +706,11 @@ msgid ""
 "two or three numbers."
 msgstr ""
 "串列和元組在很多方面相當相似，但通常用在完全不同的地方。元組可以想成 Pascal "
-"的紀錄 (record) 或是 C 的結構 (struct)，是一小群相關聯但可能是不同型別的資料"
-"集合，以一組為單位進行操作。舉例來說，一個笛卡兒坐標系可以適當地表示成一個有"
-"二或三個值的元組。"
+"的 ``record`` 或是 C 的 ``struct``，是一小群相關聯但可能是不同型別的資料集"
+"合，以一組為單位進行操作。舉例來說，一個笛卡兒坐標系可以適當地表示成一個有二"
+"或三個值的元組。"
 
 #: ../../faq/design.rst:410
-#, fuzzy
 msgid ""
 "Lists, on the other hand, are more like arrays in other languages.  They "
 "tend to hold a varying number of objects all of which have the same type and "
@@ -725,8 +720,9 @@ msgid ""
 "if you added another file or two to the directory."
 msgstr ""
 "另一方面，串列更像是其他語言的陣列 (array)。他可以有不固定個同類別物件，且為"
-"逐項操作。舉例來說，``os.listdir('.')`` 回傳當下目錄裡的檔案，以包含字串的串"
-"列表示。如果你新增了幾個檔案到這個目錄，一般來說操作結果的函式也會正常運作。"
+"逐項操作。舉例來說，:func:`os.listdir('.') <os.listdir>` 回傳當下目錄裡的檔"
+"案，以包含字串的串列表示。如果你新增了幾個檔案到這個目錄，一般來說操作結果的"
+"函式也會正常運作。"
 
 #: ../../faq/design.rst:418
 msgid ""
@@ -787,7 +783,6 @@ msgstr ""
 "tree)，在搜尋（目前為止最常見的操作）方面有更好的表現，實作上也較為簡單。"
 
 #: ../../faq/design.rst:447
-#, fuzzy
 msgid ""
 "Dictionaries work by computing a hash code for each key stored in the "
 "dictionary using the :func:`hash` built-in function.  The hash code varies "
@@ -800,10 +795,10 @@ msgid ""
 "notation -- to retrieve a key."
 msgstr ""
 "字典利用內建 :func:`hash` 函式，對每個鍵做雜湊計算。雜湊結果依據鍵的值和個別"
-"執行緒 (processes) 的種子而有相當大的差距。例如，\"Python\" 的雜湊是 "
-"-539294296，而只差一個字的 \"python\" 則是 1142331976。雜湊結果接著被用來計算"
-"值在內部陣列儲存的位置。假設你存的鍵都有不同的雜湊值，那字典只需要常數時間 — "
-"用大 O 表示法 (Big-O notation) 就是 O(1) — 來找任意一個鍵。"
+"執行緒 (processes) 的種子而有相當大的差距。例如，``'Python'`` 的雜湊是 "
+"``-539294296``，而只差一個字的 ``'python'`` 則是 ``1142331976``。雜湊結果接著"
+"被用來計算值在內部陣列儲存的位置。假設你存的鍵都有不同的雜湊值，那字典只需要"
+"常數時間 — 用大 O 表示法 (Big-O notation) 就是 O(1) — 來找任意一個鍵。"
 
 #: ../../faq/design.rst:458
 msgid "Why must dictionary keys be immutable?"
@@ -895,7 +890,6 @@ msgstr ""
 "所有物件都標記成只能讀取 — 所以再一次，自己參照自己的物件會導致無窮迴圈。"
 
 #: ../../faq/design.rst:500
-#, fuzzy
 msgid ""
 "There is a trick to get around this if you need to, but use it at your own "
 "risk: You can wrap a mutable structure inside a class instance which has "
@@ -905,9 +899,9 @@ msgid ""
 "the object is in the dictionary (or other structure). ::"
 msgstr ""
 "如果你需要的話，這裡有個小技巧可以幫你，但請自己承擔風險：你可以把一個可變物"
-"件包裝進一個有 :meth:`__eq__` 和 :meth:`__hash__` 方法的類別實例。只要這種包"
-"裝物件還存在於字典（或其他類似結構）中，你就必須確定在字典（或其他用雜湊為基"
-"底的結構）中他們的雜湊值會保持恆定。\n"
+"件包裝進一個有 :meth:`~object.__eq__` 和 :meth:`~object.__hash__` 方法的類別"
+"實例。只要這種包裝物件還存在於字典（或其他類似結構）中，你就必須確定在字典"
+"（或其他用雜湊為基底的結構）中他們的雜湊值會保持恆定。\n"
 "\n"
 "::"
 
@@ -934,16 +928,15 @@ msgstr ""
 "為基底的結構會出現不正常的行為。"
 
 #: ../../faq/design.rst:534
-#, fuzzy
 msgid ""
 "In the case of :class:`!ListWrapper`, whenever the wrapper object is in a "
 "dictionary the wrapped list must not change to avoid anomalies.  Don't do "
 "this unless you are prepared to think hard about the requirements and the "
 "consequences of not meeting them correctly.  Consider yourself warned."
 msgstr ""
-"至於 ListWrapper，只要這個包裝過的物件在字典中，裡面的串列就不能改變以避免不"
-"正常的事情發生。除非你已經謹慎思考過你的需求和無法滿足條件的後果，不然請不要"
-"這麼做。請自行注意。"
+"至於 :class:`!ListWrapper`，只要這個包裝過的物件在字典中，裡面的串列就不能改"
+"變以避免不正常的事情發生。除非你已經謹慎思考過你的需求和無法滿足條件的後果，"
+"不然請不要這麼做。請自行注意。"
 
 #: ../../faq/design.rst:541
 msgid "Why doesn't list.sort() return the sorted list?"
@@ -1028,7 +1021,6 @@ msgstr ""
 "用來建構詳盡徹底的測試套件來測試模組裡的每一行程式碼。"
 
 #: ../../faq/design.rst:584
-#, fuzzy
 msgid ""
 "An appropriate testing discipline can help build large complex applications "
 "in Python as well as having interface specifications would.  In fact, it can "
@@ -1041,9 +1033,9 @@ msgid ""
 msgstr ""
 "就像介面規範一樣，一個適當的測試規則在建造大型又複雜的 Python 應用程式時可以"
 "幫上忙。事實上，他可能可以有更好的表現，因為介面規範無法測試程式的特定屬性。"
-"舉例來說，:meth:`append` 方法應該要在某個內部的串列最後面加上新的元素，而介面"
-"規範沒辦法測試你的 :meth:`append` 是不是真的有正確的實作，但這在測試套件裡是"
-"件很簡單的事。"
+"舉例來說，:meth:`list.append` 方法應該要在某個內部的串列最後面加上新的元素，"
+"而介面規範沒辦法測試你的 :meth:`list.append` 是不是真的有正確的實作，但這在測"
+"試套件裡是件很簡單的事。"
 
 #: ../../faq/design.rst:592
 msgid ""
@@ -1062,7 +1054,6 @@ msgid "Why is there no goto?"
 msgstr "為何沒有 goto 語法？"
 
 #: ../../faq/design.rst:602
-#, fuzzy
 msgid ""
 "In the 1970s people realized that unrestricted goto could lead to messy "
 "\"spaghetti\" code that was hard to understand and revise. In a high-level "
@@ -1074,30 +1065,30 @@ msgid ""
 msgstr ""
 "在 1970 年代，人們了解到沒有限制的 goto 會導致混亂、難以理解和修改的「義大利"
 "麵」程式碼 (\"spaghetti\" code)。在高階語言裡，這也是不需要的，因為有方法可以"
-"做邏輯分支（以 Python 來說，用 ``if`` 陳述式和 ``or``、``and`` 及 ``if-"
-"else`` 運算式）和迴圈（用 ``while`` 和 ``for`` 陳述式，可能會有 ``continue`` "
-"和 ``break``）。"
+"做邏輯分支（以 Python 來說，用 :keyword:`if` 陳述式和 :keyword:`or`、:"
+"keyword:`and` 及 :keyword:`if`/:keyword:`else` 運算式）和迴圈（用 :keyword:"
+"`while` 和 :keyword:`for` 陳述式，可能會有 :keyword:`continue` 和 :keyword:"
+"`break`）。"
 
 #: ../../faq/design.rst:609
-#, fuzzy
 msgid ""
 "One can also use exceptions to provide a \"structured goto\" that works even "
 "across function calls.  Many feel that exceptions can conveniently emulate "
 "all reasonable uses of the ``go`` or ``goto`` constructs of C, Fortran, and "
 "other languages.  For example::"
 msgstr ""
 "我們也可以用例外來做「結構化的 goto」，這甚至可以跨函式呼叫。很多人覺得例外可"
-"以方便地模擬在 C、Fortran 和其他語言裡各種合理使用的「go」和「goto」。例"
+"以方便地模擬在 C、Fortran 和其他語言裡各種合理使用的 ``go`` 和 ``goto``。例"
 "如：\n"
 "\n"
 "::"
 
 #: ../../faq/design.rst:625
-#, fuzzy
 msgid ""
 "This doesn't allow you to jump into the middle of a loop, but that's usually "
 "considered an abuse of ``goto`` anyway.  Use sparingly."
-msgstr "這依然不能讓你跳進迴圈內，這通常被認為是對 goto 的濫用。請小心使用。"
+msgstr ""
+"這依然不能讓你跳進迴圈內，這通常被認為是對 ``goto`` 的濫用。請小心使用。"
 
 #: ../../faq/design.rst:630
 msgid "Why can't raw strings (r-strings) end with a backslash?"
@@ -1148,14 +1139,13 @@ msgid "Why doesn't Python have a \"with\" statement for attribute assignments?"
 msgstr "為何 Python 沒有屬性賦值的 with 陳述式？"
 
 #: ../../faq/design.rst:658
-#, fuzzy
 msgid ""
 "Python has a :keyword:`with` statement that wraps the execution of a block, "
 "calling code on the entrance and exit from the block.  Some languages have a "
 "construct that looks like this::"
 msgstr ""
-"Python 的 with 陳述式包裝了一區塊程式的執行，在進入和離開該區塊時執行程式碼。"
-"一些語言會有像如下的結構：\n"
+"Python 的 :keyword:`with` 陳述式包裝了一區塊程式的執行，在進入和離開該區塊時"
+"執行程式碼。一些語言會有像如下的結構：\n"
 "\n"
 "::"
 
@@ -1194,28 +1184,26 @@ msgstr ""
 "::"
 
 #: ../../faq/design.rst:685
-#, fuzzy
 msgid ""
 "The snippet assumes that ``a`` must have a member attribute called ``x``. "
 "However, there is nothing in Python that tells the interpreter this. What "
 "should happen if ``a`` is, let us say, an integer?  If there is a global "
 "variable named ``x``, will it be used inside the :keyword:`with` block?  As "
 "you see, the dynamic nature of Python makes such choices much harder."
 msgstr ""
-"這段程式碼假設「a」有一個叫做「x」的成員屬性。然後，Python 裡並沒有任何跡象告"
-"訴直譯器這件事。在假設「a」是一個整數的話，那會發生什麼事？如果有一個全域變數"
-"稱為「x」，那在這個 with 區塊會被使用嗎？如你所見，Python 動態的天性使得這種"
-"選擇更加困難。"
+"這段程式碼假設 ``a`` 有一個叫做 ``x`` 的成員屬性。然後，Python 裡並沒有任何跡"
+"象告訴直譯器這件事。在假設「a」是一個整數的話，那會發生什麼事？如果有一個全域"
+"變數稱為 ``x``，那在這個 :keyword:`with` 區塊會被使用嗎？如你所見，Python 動"
+"態的天性使得這種選擇更加困難。"
 
 #: ../../faq/design.rst:691
-#, fuzzy
 msgid ""
 "The primary benefit of :keyword:`with` and similar language features "
 "(reduction of code volume) can, however, easily be achieved in Python by "
 "assignment.  Instead of::"
 msgstr ""
-"然而，with 陳述式或類似的語言特性（減少程式碼量）的主要好處可以透過賦值來達"
-"成。相較於這樣寫：\n"
+"然而 :keyword:`with` 陳述式或類似的語言特性（減少程式碼量）的主要好處可以透過"
+"賦值來達成。相較於這樣寫：\n"
 "\n"
 "::"
 
@@ -1247,7 +1235,6 @@ msgid "Why don't generators support the with statement?"
 msgstr "為何產生器 (generator) 不支援 with 陳述式？"
 
 #: ../../faq/design.rst:717
-#, fuzzy
 msgid ""
 "For technical reasons, a generator used directly as a context manager would "
 "not work correctly.  When, as is most common, a generator is used as an "
@@ -1257,7 +1244,8 @@ msgid ""
 msgstr ""
 "出於技術原因，把產生器直接用作情境 (context) 管理器會無法正常運作。因為通常來"
 "說，產生器是被當成疊代器 (iterator)，到最後完成時不需要被手動關閉。但如果你需"
-"要的話，你可以在 with 陳述式裡用「contextlib.closing(generator)」來包裝他。"
+"要的話，你可以在 :keyword:`with` 陳述式裡用 :func:`contextlib."
+"closing(generator) <contextlib.closing>` 來包裝他。"
 
 #: ../../faq/design.rst:725
 msgid "Why are colons required for the if/while/def/class statements?"
diff --git a/faq/extending.po b/faq/extending.po
@@ -331,9 +331,9 @@ msgid ""
 "work for C++ objects."
 msgstr ""
 "根據你的要求，有多種方法。要手動執行此操作，請先閱讀 :ref:`「擴充和嵌入」說明"
-"檔案 <extending-index>`。意識到對於 Python 執行環境 (run-time) 系統，C 和 C++ 之間並沒有太"
-"多區別——因此圍繞 C 結構（指標）型別構建新 Python 型別的策略也適用於 C++ 物"
-"件。"
+"檔案 <extending-index>`。意識到對於 Python 執行環境 (run-time) 系統，C 和 C+"
+"+ 之間並沒有太多區別——因此圍繞 C 結構（指標）型別構建新 Python 型別的策略也適"
+"用於 C++ 物件。"
 
 #: ../../faq/extending.rst:212
 msgid "For C++ libraries, see :ref:`c-wrapper-software`."
diff --git a/faq/gui.po b/faq/gui.po
@@ -62,8 +62,8 @@ msgid ""
 "frameworks can be found on the python wiki."
 msgstr ""
 "根據你要使用的平台，還有其他幾種選擇。在 python wiki 上可以找到一份\\ `跨平台"
-"的 <https://wiki.python.org/moin/GuiProgramming#Cross-Platform_Frameworks>`_"
-"\\ 以及\\ `各平台專屬的 <https://wiki.python.org/moin/"
+"的 <https://wiki.python.org/moin/GuiProgramming#Cross-"
+"Platform_Frameworks>`_\\ 以及\\ `各平台專屬的 <https://wiki.python.org/moin/"
 "GuiProgramming#Platform-specific_Frameworks>`_ GUI 框架清單。"
 
 #: ../../faq/gui.rst:36
@@ -89,8 +89,8 @@ msgid ""
 "point to them at run-time using the :envvar:`TCL_LIBRARY` and :envvar:"
 "`TK_LIBRARY` environment variables."
 msgstr ""
-"將應用程式與 Tcl 和 Tk 函式庫一併發送是一種解決方法，並在執行環境 (run-time) 使用 :envvar:"
-"`TCL_LIBRARY` 和 :envvar:`TK_LIBRARY` 環境變數來指向該函式庫。"
+"將應用程式與 Tcl 和 Tk 函式庫一併發送是一種解決方法，並在執行環境 (run-time) "
+"使用 :envvar:`TCL_LIBRARY` 和 :envvar:`TK_LIBRARY` 環境變數來指向該函式庫。"
 
 #: ../../faq/gui.rst:49
 msgid ""
diff --git a/faq/installed.po b/faq/installed.po
@@ -88,8 +88,8 @@ msgid ""
 "Apparently some of HP/Compaq's administrative tools are written in Python."
 msgstr ""
 "一些安裝 Windows 的機器也被安裝 Python。截至撰寫此文件的當下，我們得知 HP 與 "
-"Compaq 出廠的機器都預設安裝 Python。顯然的 HP 與 Compaq 部分的管理工具程式是透"
-"過 Python 語言所撰寫。"
+"Compaq 出廠的機器都預設安裝 Python。顯然的 HP 與 Compaq 部分的管理工具程式是"
+"透過 Python 語言所撰寫。"
 
 #: ../../faq/installed.rst:32
 msgid ""
@@ -133,5 +133,5 @@ msgid ""
 "would then be required to fix things again."
 msgstr ""
 "當作業系統預設安裝 Python，不建議移除它。對你而言某些工具程式是重要不可或缺"
-"的，若自行移除它，透過 Python 撰寫的工具程式將無法正常執行。重新安裝整個系統"
-"，才能再次解決這些問題。"
+"的，若自行移除它，透過 Python 撰寫的工具程式將無法正常執行。重新安裝整個系"
+"統，才能再次解決這些問題。"
diff --git a/faq/library.po b/faq/library.po
@@ -1064,17 +1064,16 @@ msgid ""
 "popular and feature-rich alternative."
 msgstr ""
 ":mod:`asyncio` 模組提供了一個通用的單執行緒並發非同步函式庫，可用於編寫非阻塞"
-"網路程式碼。第三方 `Twisted <https://twisted.org/>`_ 函式庫是一種流"
-"行且功能豐富的替代方案。"
+"網路程式碼。第三方 `Twisted <https://twisted.org/>`_ 函式庫是一種流行且功能豐"
+"富的替代方案。"
 
 #: ../../faq/library.rst:788
 msgid "Databases"
 msgstr "資料庫"
 
 #: ../../faq/library.rst:791
-#, fuzzy
 msgid "Are there any interfaces to database packages in Python?"
-msgstr "Python 中是否有任何資料庫包的介面？"
+msgstr "Python 中是否有任何資料庫套件的介面？"
 
 #: ../../faq/library.rst:793
 msgid "Yes."
diff --git a/faq/programming.po b/faq/programming.po
diff --git a/faq/windows.po b/faq/windows.po
