Skip to content

fix: refine howto/logging.po wording #1251

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
josix merged 2 commits into from
Oct 26, 2026
Merged

fix: refine howto/logging.po wording #1251

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b7ba407
fix: refine howto/logging.po wording after multi-round review
josix Oct 26, 2026
cd76dc1
fix: drop redundant 預設值 in the fileConfig note
josix Oct 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions howto/logging.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ msgstr ""

#: ../../howto/logging.rst:28
msgid "When to use logging"
msgstr "什麼時候使用 logging"
msgstr "何時使用日誌記錄"

#: ../../howto/logging.rst:30
msgid ""
Expand All @@ -75,7 +75,7 @@ msgstr ""
"存取日誌記錄功能，然後呼叫記錄器的 :meth:`~Logger.debug`、"
":meth:`~Logger.info`、:meth:`~Logger.warning`、:meth:`~Logger.error` 和 "
":meth:`~Logger.critical` 方法。為了確定何時該使用日誌記錄，以及何時該使用哪個記"
"錄器方法，請參見下表，表中針對每個常見任務列出最適合的工具。"
"錄器方法，請參閱下表，表中針對每個常見任務列出最適合的工具。"

#: ../../howto/logging.rst:38
msgid "Task you want to perform"
Expand Down Expand Up @@ -622,7 +622,7 @@ msgid ""
"should receive help before too long."
msgstr ""
"如果你的日誌需求很簡單，可以參考上面的範例將 logging 加入你自己的腳本中。如果你"
"遇到問題或不理解某些內容，可以在 `Python 討論論壇 "
"遇到問題或不理解某些內容，可以在 `Python 討論區 "
"<https://discuss.python.org/c/help/7>`_ 的 Help 分類中發問，應該很快就會得到幫"
"助。"

Expand Down Expand Up @@ -686,11 +686,11 @@ msgid ""
"want, and indicate the area of an application in which a logged message "
"originates."
msgstr ""
"記錄是透過呼叫 :class:`Logger` 類別實例（以下稱為 :dfn:`loggers`）上的方法來"
"進行。每個實例都有一個名稱，並在概念上以點（句號）作為分隔符號排列成命名空間階"
"層。例如，名為 'scan' 的記錄器是記錄器 'scan.text'、'scan.html' 和 'scan.pdf' "
"的父記錄器。記錄器名稱可以取任何你想要的名稱，用來表示記錄訊息源自應用程式中的"
"哪個區域。"
"日誌記錄是透過呼叫 :class:`Logger` 類別實例（以下稱為 :dfn:`loggers`）上的方法"
"來進行。每個實例都有一個名稱，並在概念上以點（句號）作為分隔符號排列成命名空間"
"階層。例如，名為 'scan' 的記錄器是記錄器 'scan.text'、'scan.html' 和 "
"'scan.pdf' 的父記錄器。記錄器名稱可以取任何你想要的名稱，用來表示記錄訊息源自"
"應用程式中的哪個區域。"

#: ../../howto/logging.rst:340
msgid ""
Expand Down Expand Up @@ -754,8 +754,8 @@ msgstr ""
"預設情況下，對於所有的日誌訊息都沒有設定目的地。你可以使用教學範例中的 :func:"
"`basicConfig` 指定目的地（例如控制台或檔案）。如果你呼叫 :func:`debug`、:"
"func:`info`、:func:`warning`、:func:`error` 和 :func:`critical` 函式，它們會"
"檢查是否已設定目的地，如果沒有，它們會設定目的地為控制台（``sys.stderr``）以及"
"顯示訊息的預設格式，然後委派給根記錄器來進行實際的訊息輸出。"
"檢查是否已設定目的地，如果沒有，它們會設定目的地為控制台 (``sys.stderr``) 以"
"及顯示訊息的預設格式，然後委派給根記錄器來進行實際的訊息輸出。"

#: ../../howto/logging.rst:369
msgid "The default format set by :func:`basicConfig` for messages is:"
Expand Down Expand Up @@ -846,7 +846,7 @@ msgstr ""
msgid ""
"You don't need to always call these methods on every logger you create. See "
"the last two paragraphs in this section."
msgstr "你並不需要在每個你建立的記錄器上都呼叫這些方法，請參考此節的最後兩段。"
msgstr "你並不需要在每個你建立的記錄器上都呼叫這些方法，請參閱本節的最後兩段。"

#: ../../howto/logging.rst:463
msgid ""
Expand Down Expand Up @@ -1286,11 +1286,11 @@ msgid ""
"configuration. Please refer to the reference documentation for more "
"information, and specify ``False`` for this parameter if you wish."
msgstr ""
":func:`fileConfig` 函式接受一個預設參數 ``disable_existing_loggers``，基於向後"
"相容的考量，其預設值為 ``True``。這可能不是你想要的，因為除非在設定中明確指名這"
"些記錄器（或其上層記錄器），否則它會導致在呼叫 :func:`fileConfig` 之前就已存在"
"的所有非根記錄器被停用。如需更多資訊請參閱參考文件，如有需要，可將此參數指定為"
" ``False``。"
":func:`fileConfig` 函式有一個參數 ``disable_existing_loggers``，基於向後相容的"
"考量，其預設值為 ``True``。這不一定符合你的需求，因為除非在設定中明確指名這些"
"記錄器（或其上層記錄器），否則它會導致在呼叫 :func:`fileConfig` 之前就已存在的"
"所有非根記錄器被停用。如需更多資訊請參閱參考文件，如有需要，可將此參數指定為 "
"``False``。"

#: ../../howto/logging.rst:725
msgid ""
Expand Down