From 683f7d847f2d12ce8681ad4d626f328f90195078 Mon Sep 17 00:00:00 2001 From: Matt Wang Date: Fri, 3 May 2024 03:12:10 +0800 Subject: [PATCH 1/2] Translate `library/devmode.po` --- library/devmode.po | 104 ++++++++++++++++++++++++++++++++------------- 1 file changed, 75 insertions(+), 29 deletions(-) diff --git a/library/devmode.po b/library/devmode.po index f5b9098f1f..dc581ee731 100644 --- a/library/devmode.po +++ b/library/devmode.po @@ -1,16 +1,16 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. -# FIRST AUTHOR , YEAR. # +# Translators: +# Matt Wang , 2024 #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-10-11 17:13+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2024-05-03 02:14+0800\n" +"Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" "Language: zh_TW\n" @@ -20,7 +20,7 @@ msgstr "" #: ../../library/devmode.rst:4 msgid "Python Development Mode" -msgstr "" +msgstr "Python 開發模式" #: ../../library/devmode.rst:8 msgid "" @@ -29,36 +29,42 @@ msgid "" "the default if the code is correct; new warnings are only emitted when an " "issue is detected." msgstr "" +"Python 開發模式引入了額外的 runtime 檢查，預設啟用這些檢查的成本太高。如果程" +"式碼正確，它不應比預設值更詳細；僅當偵測到問題時才會發出新警告。" #: ../../library/devmode.rst:13 msgid "" "It can be enabled using the :option:`-X dev <-X>` command line option or by " "setting the :envvar:`PYTHONDEVMODE` environment variable to ``1``." msgstr "" +"可以使用 :option:`-X dev <-X>` 命令列選項或將 :envvar:`PYTHONDEVMODE` 環境變" +"數設為 1 來啟用它。" #: ../../library/devmode.rst:16 msgid "See also :ref:`Python debug build `." -msgstr "" +msgstr "另請參閱 :ref:`Python 除錯建置 `。" #: ../../library/devmode.rst:19 msgid "Effects of the Python Development Mode" -msgstr "" +msgstr "Python 開發模式的影響" #: ../../library/devmode.rst:21 msgid "" "Enabling the Python Development Mode is similar to the following command, " "but with additional effects described below::" -msgstr "" +msgstr "啟用 Python 開發模式類似以下指令，但具有如下所述的附加效果：" #: ../../library/devmode.rst:26 msgid "Effects of the Python Development Mode:" -msgstr "" +msgstr "Python 開發模式的效果：" #: ../../library/devmode.rst:28 msgid "" "Add ``default`` :ref:`warning filter `. The " "following warnings are shown:" msgstr "" +"新增 ``default`` :ref:`警告過濾器 `。以下警告會被" +"顯示：" #: ../../library/devmode.rst:31 msgid ":exc:`DeprecationWarning`" @@ -81,11 +87,13 @@ msgid "" "Normally, the above warnings are filtered by the default :ref:`warning " "filters `." msgstr "" +"一般來說，上述警告會被預設的\\ :ref:`警告過濾器 `\\ 給過濾掉。" #: ../../library/devmode.rst:39 msgid "" "It behaves as if the :option:`-W default <-W>` command line option is used." -msgstr "" +msgstr "它的行為就像使用 :option:`-W default <-W>` 命令列選項一樣。" #: ../../library/devmode.rst:41 msgid "" @@ -93,36 +101,38 @@ msgid "" "`PYTHONWARNINGS` environment variable to ``error`` to treat warnings as " "errors." msgstr "" +"使用 :option:`-W error <-W>` 命令列選項或將 :envvar:`PYTHONWARNINGS` 環境變數" +"設為 ``error`` 會將警告視為錯誤。" #: ../../library/devmode.rst:45 msgid "Install debug hooks on memory allocators to check for:" -msgstr "" +msgstr "在記憶體分配器上安裝除錯 hook（掛鉤）以檢查：" #: ../../library/devmode.rst:47 msgid "Buffer underflow" -msgstr "" +msgstr "緩衝區下溢 (underflow)" #: ../../library/devmode.rst:48 msgid "Buffer overflow" -msgstr "" +msgstr "緩衝區溢位 (overflow)" #: ../../library/devmode.rst:49 msgid "Memory allocator API violation" -msgstr "" +msgstr "記憶體分配器 API 違規" #: ../../library/devmode.rst:50 msgid "Unsafe usage of the GIL" -msgstr "" +msgstr "GIL 的不安全使用" #: ../../library/devmode.rst:52 msgid "See the :c:func:`PyMem_SetupDebugHooks` C function." -msgstr "" +msgstr "請參閱 :c:func:`PyMem_SetupDebugHooks` C 函式。" #: ../../library/devmode.rst:54 msgid "" "It behaves as if the :envvar:`PYTHONMALLOC` environment variable is set to " "``debug``." -msgstr "" +msgstr "它的行為就好像是將 :envvar:`PYTHONMALLOC` 環境變數設定為 ``debug``。" #: ../../library/devmode.rst:57 msgid "" @@ -130,6 +140,8 @@ msgid "" "memory allocators, set the :envvar:`PYTHONMALLOC` environment variable to " "``default``." msgstr "" +"若要啟用 Python 開發模式而不在記憶體分配器上安裝偵錯 hook，請將 :envvar:" +"`PYTHONMALLOC` 環境變數設為 ``default``。" #: ../../library/devmode.rst:61 msgid "" @@ -138,6 +150,10 @@ msgid "" "SIGABRT`, :const:`~signal.SIGBUS` and :const:`~signal.SIGILL` signals to " "dump the Python traceback on a crash." msgstr "" +"在 Python 啟動時呼叫 :func:`faulthandler.enable` 來為 :const:`~signal." +"SIGSEGV`、:const:`~signal.SIGFPE`、:const:`~signal.SIGABRT`、:const:`~signal." +"SIGBUS` 和 :const:`~signal.SIGILL` 訊號安裝處理函式以在當機時傾印 (dump) " +"Python 回溯 (traceback)。" #: ../../library/devmode.rst:66 msgid "" @@ -145,18 +161,22 @@ msgid "" "used or if the :envvar:`PYTHONFAULTHANDLER` environment variable is set to " "``1``." msgstr "" +"它的行為就像使用 :option:`-X faulthandler <-X>` 命令列選項或將 :envvar:" +"`PYTHONFAULTHANDLER` 環境變數設定為 ``1``。" #: ../../library/devmode.rst:70 msgid "" "Enable :ref:`asyncio debug mode `. For example, :mod:" "`asyncio` checks for coroutines that were not awaited and logs them." msgstr "" +"啟用 :ref:`asyncio 除錯模式 `。例如 :mod:`asyncio` 會檢查" +"未被等待的 (not awaited) 協程並記錄 (log) 它們。" #: ../../library/devmode.rst:73 msgid "" "It behaves as if the :envvar:`PYTHONASYNCIODEBUG` environment variable is " "set to ``1``." -msgstr "" +msgstr "它的行為就像將 :envvar:`PYTHONASYNCIODEBUG` 環境變數設定為 1 一樣。" #: ../../library/devmode.rst:76 msgid "" @@ -164,6 +184,8 @@ msgid "" "operations. Examples: :func:`open`, :meth:`str.encode` and :meth:`bytes." "decode`." msgstr "" +"檢查字串編碼和解碼操作的 *encoding* 和 *errors* 引數。範例：:func:`open`、:" +"meth:`str.encode` 和 :meth:`bytes.decode`。" #: ../../library/devmode.rst:80 msgid "" @@ -171,16 +193,19 @@ msgid "" "the first encoding/decoding error and the *encoding* argument is sometimes " "ignored for empty strings." msgstr "" +"預設情況下，為了獲得最佳效能，僅在第一個編碼/解碼錯誤時檢查 *errors* 引數，並" +"且有時會因為是空字串而忽略 *encoding* 引數。" #: ../../library/devmode.rst:84 msgid "The :class:`io.IOBase` destructor logs ``close()`` exceptions." -msgstr "" +msgstr ":class:`io.IOBase` 解構函式會記錄 ``close()`` 例外。" #: ../../library/devmode.rst:85 msgid "" "Set the :attr:`~sys.flags.dev_mode` attribute of :data:`sys.flags` to " "``True``." msgstr "" +"將 :data:`sys.flags` 的 :attr:`~sys.flags.dev_mode` 屬性設為 ``True``。" #: ../../library/devmode.rst:88 msgid "" @@ -192,6 +217,10 @@ msgid "" "buffer overflow error logs the traceback where the memory block was " "allocated." msgstr "" +"Python 開發模式預設不會啟用 :mod:`tracemalloc` 模組，因為（效能和記憶體的）開" +"銷太大。啟用 :mod:`tracemalloc` 模組可提供有關某些錯誤來源的附加資訊。例如 :" +"exc:`ResourceWarning` 記錄了分配資源之處的回溯、緩衝區溢位錯誤記錄了分配記憶" +"體區塊的回溯。" #: ../../library/devmode.rst:95 msgid "" @@ -199,22 +228,26 @@ msgid "" "option from removing :keyword:`assert` statements nor from setting :const:" "`__debug__` to ``False``." msgstr "" +"Python 開發模式不會防止 :option:`-O` 命令列選項刪除 :keyword:`assert` 陳述" +"式，也不會防止將 :const:`__debug__` 設定為 ``False``。" #: ../../library/devmode.rst:99 msgid "" "The Python Development Mode can only be enabled at the Python startup. Its " "value can be read from :data:`sys.flags.dev_mode `." msgstr "" +"Python 開發模式只能在 Python 啟動時啟用。它的值可以從 :data:`sys.flags." +"dev_mode ` 讀取。" #: ../../library/devmode.rst:102 msgid "The :class:`io.IOBase` destructor now logs ``close()`` exceptions." -msgstr "" +msgstr ":class:`io.IOBase` 解構函式現在會記錄 ``close()`` 例外。" #: ../../library/devmode.rst:105 msgid "" "The *encoding* and *errors* arguments are now checked for string encoding " "and decoding operations." -msgstr "" +msgstr "現在會為字串編碼和解碼操作檢查 *encoding* 和 *errors* 引數。" #: ../../library/devmode.rst:111 msgid "ResourceWarning Example" @@ -224,30 +257,32 @@ msgstr "ResourceWarning 範例" msgid "" "Example of a script counting the number of lines of the text file specified " "in the command line::" -msgstr "" +msgstr "計算命令列中指定的文字檔案列數的腳本範例： ::" #: ../../library/devmode.rst:127 msgid "" "The script does not close the file explicitly. By default, Python does not " "emit any warning. Example using README.txt, which has 269 lines:" msgstr "" +"該腳本不會明確關閉檔案。預設情況下，Python 不會發出任何警告。使用 README.txt " +"的範例，該檔案有 269 列：" #: ../../library/devmode.rst:135 msgid "" "Enabling the Python Development Mode displays a :exc:`ResourceWarning` " "warning:" -msgstr "" +msgstr "啟用 Python 開發模式會顯示 :exc:`ResourceWarning` 警告：" #: ../../library/devmode.rst:145 msgid "" "In addition, enabling :mod:`tracemalloc` shows the line where the file was " "opened:" -msgstr "" +msgstr "此外，啟用 :mod:`tracemalloc` 會顯示檔案被開啟的那一列：" #: ../../library/devmode.rst:160 msgid "" "The fix is to close explicitly the file. Example using a context manager::" -msgstr "" +msgstr "修復方法是明確關閉該檔案。使用情境管理器的範例： ::" #: ../../library/devmode.rst:168 msgid "" @@ -256,24 +291,29 @@ msgid "" "CPython, but it is even worse in PyPy. Closing resources explicitly makes an " "application more deterministic and more reliable." msgstr "" +"不明確關閉資源可能會使資源開啟的時間比預期的長得多；它可能會在退出 Python 時" +"導致嚴重問題。在 CPython 中很糟糕，但在 PyPy 中更糟。明確關閉資源使應用程式更" +"具確定性和可靠性。" #: ../../library/devmode.rst:175 msgid "Bad file descriptor error example" -msgstr "" +msgstr "檔案描述器的錯誤範例" #: ../../library/devmode.rst:177 msgid "Script displaying the first line of itself::" -msgstr "" +msgstr "顯示自身第一行的腳本： ::" #: ../../library/devmode.rst:190 msgid "By default, Python does not emit any warning:" -msgstr "" +msgstr "預設情況下，Python 不會發出任何警告：" #: ../../library/devmode.rst:197 msgid "" "The Python Development Mode shows a :exc:`ResourceWarning` and logs a \"Bad " "file descriptor\" error when finalizing the file object:" msgstr "" +"Python 開發模式在最終化 (finalize) 檔案物件時顯示 :exc:`ResourceWarning` 並記" +"錄 \"Bad file descriptor\" 錯誤：" #: ../../library/devmode.rst:213 msgid "" @@ -283,9 +323,15 @@ msgid "" "worst case scenario, closing it twice can lead to a crash (see :issue:" "`18748` for an example)." msgstr "" +"``os.close(fp.fileno())`` 會關閉檔案描述器。當檔案物件最終化器 (finalizer) 嘗" +"試再次關閉檔案描述器時，它會失敗並出現 ``Bad file descriptor`` 錯誤。檔案描述" +"器只能關閉一次。在最壞的情況下，將它關閉兩次可能會導致崩潰 (crash)（相關範例" +"請參閱 :issue:`18748`）。" #: ../../library/devmode.rst:219 msgid "" "The fix is to remove the ``os.close(fp.fileno())`` line, or open the file " "with ``closefd=False``." msgstr "" +"修復方法是刪除 ``os.close(fp.fileno())`` 那列，或使用 ``closefd=False`` 開啟" +"檔案。" From 22c43f3691a257cfc07632b6929155d30b3f862a Mon Sep 17 00:00:00 2001 From: "Wei-Hsiang (Matt) Wang" Date: Thu, 16 May 2024 15:22:32 +0800 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Payon --- library/devmode.po | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/library/devmode.po b/library/devmode.po index dc581ee731..73632bf44b 100644 --- a/library/devmode.po +++ b/library/devmode.po @@ -132,7 +132,7 @@ msgstr "請參閱 :c:func:`PyMem_SetupDebugHooks` C 函式。" msgid "" "It behaves as if the :envvar:`PYTHONMALLOC` environment variable is set to " "``debug``." -msgstr "它的行為就好像是將 :envvar:`PYTHONMALLOC` 環境變數設定為 ``debug``。" +msgstr "它的行為就好像是將 :envvar:`PYTHONMALLOC` 環境變數設定為 ``debug`` 一樣。" #: ../../library/devmode.rst:57 msgid "" @@ -184,7 +184,7 @@ msgid "" "operations. Examples: :func:`open`, :meth:`str.encode` and :meth:`bytes." "decode`." msgstr "" -"檢查字串編碼和解碼操作的 *encoding* 和 *errors* 引數。範例：:func:`open`、:" +"檢查字串編碼和解碼操作的 *encoding* 和 *errors* 引數。例如：:func:`open`、:" "meth:`str.encode` 和 :meth:`bytes.decode`。" #: ../../library/devmode.rst:80 @@ -282,7 +282,7 @@ msgstr "此外，啟用 :mod:`tracemalloc` 會顯示檔案被開啟的那一列 #: ../../library/devmode.rst:160 msgid "" "The fix is to close explicitly the file. Example using a context manager::" -msgstr "修復方法是明確關閉該檔案。使用情境管理器的範例： ::" +msgstr "修復方法是明確關閉該檔案。以下是使用情境管理器的範例： ::" #: ../../library/devmode.rst:168 msgid "" @@ -301,7 +301,7 @@ msgstr "檔案描述器的錯誤範例" #: ../../library/devmode.rst:177 msgid "Script displaying the first line of itself::" -msgstr "顯示自身第一行的腳本： ::" +msgstr "顯示自身第一列的腳本： ::" #: ../../library/devmode.rst:190 msgid "By default, Python does not emit any warning:" @@ -323,7 +323,7 @@ msgid "" "worst case scenario, closing it twice can lead to a crash (see :issue:" "`18748` for an example)." msgstr "" -"``os.close(fp.fileno())`` 會關閉檔案描述器。當檔案物件最終化器 (finalizer) 嘗" +"``os.close(fp.fileno())`` 會關閉檔案描述器。當檔案物件最終化函式 (finalizer) 嘗" "試再次關閉檔案描述器時，它會失敗並出現 ``Bad file descriptor`` 錯誤。檔案描述" "器只能關閉一次。在最壞的情況下，將它關閉兩次可能會導致崩潰 (crash)（相關範例" "請參閱 :issue:`18748`）。"