Skip to content

Commit c14b87d

Browse files
josixclaude
andauthored
fix: refine howto/logging.po wording (#1251)
* fix: refine howto/logging.po wording after multi-round review - Align the "When to use logging" heading with other headings (何時使用日誌記錄) - Unify cross-references to 請參閱 within the file - Use 討論區 for the Python discussion forum, matching bugs.po - Clarify the subject of the Logger paragraph (日誌記錄是透過…) - Use half-width parentheses around ``sys.stderr`` per README - Reword the fileConfig ``disable_existing_loggers`` note to match the source's neutral tone Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014pJTfUKUkCc4HFprcvhxRe * fix: drop redundant 預設值 in the fileConfig note Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014pJTfUKUkCc4HFprcvhxRe --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 3276402 commit c14b87d

1 file changed

Lines changed: 16 additions & 16 deletions

File tree

‎howto/logging.po‎

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ msgstr ""
6060

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

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

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

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

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

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

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

12951295
#: ../../howto/logging.rst:725
12961296
msgid ""

0 commit comments

Comments
 (0)