Skip to content

Commit 9eb88da

Browse files
josixclaude
andcommitted
fix: polish howto/logging.po after reviewing rendered HTML
- Use \\ around emphasis/dfn next to Chinese so no stray spaces render - Use half-width " (English)" glosses consistently, as in the rest of the repo - Use 日誌紀錄 for log record and 回報 for report consistently - Reword awkward sentences (destinations, date/time format, library docs, production mode, numeric levels, headings) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 561c9e6 commit 9eb88da

1 file changed

Lines changed: 70 additions & 68 deletions

File tree

‎howto/logging.po‎

Lines changed: 70 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ msgstr ""
4141

4242
#: ../../howto/logging.rst:17
4343
msgid "Basic Logging Tutorial"
44-
msgstr "基礎 Logging 指南"
44+
msgstr "基礎日誌記錄教學"
4545

4646
#: ../../howto/logging.rst:19
4747
msgid ""
@@ -56,7 +56,7 @@ msgstr ""
5656
"軟體執行時,追蹤有什麼事件發生的動作稱為 Logging。軟體開發者會在程式碼中加入日"
5757
"誌記錄呼叫,以表示特定事件已經發生。事件會以一段描述訊息來說明,訊息中可以選擇"
5858
"性地包含變數資料(即每次事件發生時都可能不同的資料)。開發者也會為事件指定重要"
59-
"程度,重要程度也可以稱為 *等級 (level)* 或 *嚴重性 (severity)*。"
59+
"程度,重要程度也可以稱為\\ *等級 (level)*\\ 或\\ *嚴重性 (severity)*。"
6060

6161
#: ../../howto/logging.rst:28
6262
msgid "When to use logging"
@@ -98,7 +98,7 @@ msgstr ":func:`print`"
9898
msgid ""
9999
"Report events that occur during normal operation of a program (e.g. for "
100100
"status monitoring or fault investigation)"
101-
msgstr "報告在程式正常操作期間發生的事件(例如用於狀態監視或故障調查)"
101+
msgstr "回報在程式正常運作期間發生的事件(例如用於狀態監控或故障調查)"
102102

103103
#: ../../howto/logging.rst:44
104104
msgid ""
@@ -409,8 +409,8 @@ msgid ""
409409
"that logging event may not be handled in the desired manner."
410410
msgstr ""
411411
":func:`basicConfig` 的呼叫應該放在任何對記錄器方法(例如 "
412-
":meth:`~Logger.debug`、:meth:`~Logger.info` 等)的呼叫 *之前*。否則,該日誌事件"
413-
"可能無法以預期的方式處理。"
412+
":meth:`~Logger.debug`、:meth:`~Logger.info` 等)的呼叫\\ *之前*。否則,該日誌事"
413+
"件可能無法以預期的方式處理。"
414414

415415
#: ../../howto/logging.rst:199
416416
msgid ""
@@ -477,9 +477,9 @@ msgid ""
477477
msgstr ""
478478
"如你所見,將變數資料合併到事件描述訊息中使用的是舊的 %-style 字串格式化方式。這"
479479
"是為了向後相容:logging 套件早於 :meth:`str.format` 和 "
480-
":class:`string.Template` 等較新的格式化選項。這些較新的格式化選項\\ *有*\\ 支援"
481-
",但探索這些選項超出了本教學的範圍:請參閱 :ref:`formatting-styles` 以獲得更多"
482-
"資訊。"
480+
":class:`string.Template` 等較新的格式化選項。這些較新的格式化選項\\ *確實*\\ 受"
481+
"到支援,但探索這些選項超出了本教學的範圍:請參閱 :ref:`formatting-styles` 以獲"
482+
"得更多資訊。"
483483

484484
#: ../../howto/logging.rst:234
485485
msgid "Changing the format of displayed messages"
@@ -567,8 +567,9 @@ msgid ""
567567
"rfc:`3339`. If you need more control over the formatting of the date/time, "
568568
"provide a *datefmt* argument to ``basicConfig``, as in this example::"
569569
msgstr ""
570-
"預設的時間/日期格式遵照 ISO8601 或 :rfc:`3339`。如果你想要有更多的時間/日期控"
571-
"制,可以在 ``basicConfig`` 傳入 *datefmt* 的引數,如以下範例: ::"
570+
"日期/時間的預設顯示格式(如上所示)類似 ISO8601 或 :rfc:`3339`。如果你需要更精"
571+
"細地控制日期/時間的格式,可以在 ``basicConfig`` 傳入 *datefmt* 引數,如以下範例"
572+
": ::"
572573

573574
#: ../../howto/logging.rst:281
574575
msgid ""
@@ -608,9 +609,9 @@ msgid ""
608609
"time in reading the following sections. If you're ready for that, grab some "
609610
"of your favourite beverage and carry on."
610611
msgstr ""
611-
"這個基礎教學就到這裡了。它應該足以讓你開始使用記錄功能。日誌套件還提供了更多"
612-
"功能,但如果想要充分利用它,你需要再花些時間閱讀以下部分。如果你準備好了,就"
613-
"拿起你喜愛的飲料繼續閱讀吧。"
612+
"這個基礎教學就到這裡了。它應該足以讓你開始使用 logging。logging 套件還提供了更"
613+
"多功能,但如果想要充分利用它,你需要再花些時間閱讀以下章節。如果你準備好了,就"
614+
"拿杯你喜愛的飲料繼續閱讀吧。"
614615

615616
#: ../../howto/logging.rst:304
616617
msgid ""
@@ -620,9 +621,10 @@ msgid ""
620621
"`Python discussion forum <https://discuss.python.org/c/help/7>`_ and you "
621622
"should receive help before too long."
622623
msgstr ""
623-
"如果你需要一個簡單的日誌記錄的功能,可以參考上面的例子將它新增到你自己的腳本"
624-
"中。如果你遇到問題或不理解某些內容,可以在 `Python 討論論壇 <https://discuss."
625-
"python.org/c/help/7>`_ 的幫助類別中發問,你會很快得到幫助。"
624+
"如果你的日誌需求很簡單,可以參考上面的範例將 logging 加入你自己的腳本中。如果你"
625+
"遇到問題或不理解某些內容,可以在 `Python 討論論壇 "
626+
"<https://discuss.python.org/c/help/7>`_ 的 Help 分類中發問,應該很快就會得到幫"
627+
"助。"
626628

627629
#: ../../howto/logging.rst:310
628630
msgid ""
@@ -647,25 +649,24 @@ msgstr ""
647649

648650
#: ../../howto/logging.rst:323
649651
msgid "Loggers expose the interface that application code directly uses."
650-
msgstr "記錄器(logger)公開應用程式可以直接使用的介面。"
652+
msgstr "記錄器 (logger) 公開應用程式程式碼可以直接使用的介面。"
651653

652654
#: ../../howto/logging.rst:324
653655
msgid ""
654656
"Handlers send the log records (created by loggers) to the appropriate "
655657
"destination."
656658
msgstr ""
657-
"處理器(handlers)將由記錄器(loggers)建立的日誌記錄(log records)傳送"
658-
"到適當的目的地。"
659+
"處理器 (handler) 將(由記錄器建立的)日誌紀錄 (log record) 傳送到適當的目的地。"
659660

660661
#: ../../howto/logging.rst:326
661662
msgid ""
662663
"Filters provide a finer grained facility for determining which log records "
663664
"to output."
664-
msgstr "過濾器(filters)提供更精細的機制來決定輸出哪些日誌記錄。"
665+
msgstr "過濾器 (filter) 提供更精細的機制來決定要輸出哪些日誌紀錄。"
665666

666667
#: ../../howto/logging.rst:328
667668
msgid "Formatters specify the layout of log records in the final output."
668-
msgstr "格式化器 (formatters) 指定日誌紀錄在最終輸出中的格式。"
669+
msgstr "格式化器 (formatter) 指定日誌紀錄在最終輸出中的格式。"
669670

670671
#: ../../howto/logging.rst:330
671672
msgid ""
@@ -734,11 +735,11 @@ msgid ""
734735
"destination class if you have special requirements not met by any of the "
735736
"built-in handler classes."
736737
msgstr ""
737-
"當然,以不同的目的地記錄訊息是可能的。該套件支援將日誌訊息寫入檔案、HTTP GET/"
738-
"POST 位置、透過 SMTP 的電子郵件、通用的 sockets、佇列、或像 syslog 或 "
739-
"Windows NT 事件日誌等作業系統特定的日誌機制。這些目的地由 :dfn:`handler` 類別"
740-
"提供服務。如果你有特殊需求,而內建的 handler 類別無法滿足,則可以建立自己的日"
741-
"誌目的地類別。"
738+
"當然,也可以將訊息記錄到不同的目的地。該套件支援將日誌訊息寫入檔案、HTTP "
739+
"GET/POST 位置、透過 SMTP 寄送的電子郵件、通用 socket、佇列,或像 syslog 或 "
740+
"Windows NT 事件日誌等作業系統特定的日誌機制。這些目的地由\\ :dfn:`處理器 "
741+
"(handler)`\\ 類別負責。如果你有內建處理器類別無法滿足的特殊需求,可以建立自己的"
742+
"日誌目的地類別。"
742743

743744
#: ../../howto/logging.rst:361
744745
msgid ""
@@ -776,17 +777,17 @@ msgstr ""
776777

777778
#: ../../howto/logging.rst:380
778779
msgid "Logging Flow"
779-
msgstr "記錄流程"
780+
msgstr "日誌記錄流程"
780781

781782
#: ../../howto/logging.rst:382
782783
msgid ""
783784
"The flow of log event information in loggers and handlers is illustrated in "
784785
"the following diagram."
785-
msgstr "下面的圖表說明了記錄器(logger)和處理器(handler)中事件資訊的流動。"
786+
msgstr "下圖說明了日誌事件資訊在記錄器和處理器中的流程。"
786787

787788
#: ../../howto/logging.rst:433
788789
msgid "Loggers"
789-
msgstr "記錄器(Loggers)"
790+
msgstr "記錄器 (Loggers)"
790791

791792
#: ../../howto/logging.rst:435
792793
msgid ""
@@ -797,10 +798,10 @@ msgid ""
797798
"Third, logger objects pass along relevant log messages to all interested log "
798799
"handlers."
799800
msgstr ""
800-
":class:`Logger` 物件有三個工作。首先,它們向應用程式程式碼公開多個"
801-
"方法,讓應用程式可以在執行時記錄訊息。其次,記錄器物件基於嚴重性(預設過濾方"
802-
"式)或過濾器物件來決定要處理哪些日誌訊息。第三,記錄器物件將相關的日誌訊息傳"
803-
"遞給所有感興趣的日誌處理器。"
801+
":class:`Logger` 物件有三項職責。首先,它們向應用程式程式碼公開多個方法,讓應用"
802+
"程式可以在執行時記錄訊息。其次,記錄器物件根據嚴重性(預設的過濾機制)或過濾器"
803+
"物件來決定要處理哪些日誌訊息。第三,記錄器物件將相關的日誌訊息傳遞給所有感興趣"
804+
"的日誌處理器。"
804805

805806
#: ../../howto/logging.rst:441
806807
msgid ""
@@ -920,11 +921,11 @@ msgid ""
920921
"the logger is used to determine whether the event is passed to the logger's "
921922
"handlers."
922923
msgstr ""
923-
"記錄器有 *有效等級 (effective level)* 的概念。如果記錄器上沒有明確設定等級,則"
924-
"會改用其父記錄器的等級作為有效等級。如果父記錄器也沒有明確設定等級,就再檢查 "
925-
"*它的* 父記錄器,依此類推——會往上搜尋所有上層記錄器,直到找到明確設定的等級為止"
926-
"。根記錄器一定有明確設定的等級(預設為 ``WARNING``)。在決定是否處理某個事件時"
927-
",會使用記錄器的有效等級來判斷該事件是否要傳遞給記錄器的處理器。"
924+
"記錄器有\\ *有效等級 (effective level)*\\ 的概念。如果記錄器上沒有明確設定等級"
925+
",則會改用其父記錄器的等級作為有效等級。如果父記錄器也沒有明確設定等級,就再檢"
926+
"查\\ *它的*\\ 父記錄器,依此類推——會往上搜尋所有上層記錄器,直到找到明確設定的"
927+
"等級為止。根記錄器一定有明確設定的等級(預設為 ``WARNING``)。在決定是否處理某"
928+
"個事件時,會使用記錄器的有效等級來判斷該事件是否要傳遞給記錄器的處理器。"
928929

929930
#: ../../howto/logging.rst:499
930931
msgid ""
@@ -942,7 +943,7 @@ msgstr ""
942943

943944
#: ../../howto/logging.rst:510
944945
msgid "Handlers"
945-
msgstr "處理器"
946+
msgstr "處理器 (Handlers)"
946947

947948
#: ../../howto/logging.rst:512
948949
msgid ""
@@ -1018,9 +1019,9 @@ msgid ""
10181019
"the interface that all handlers should have and establishes some default "
10191020
"behavior that child classes can use (or override)."
10201021
msgstr ""
1021-
"應用程式程式碼不應直接實例化和使用 :class:`Handler` 的實例。相反的,:class:"
1022-
"`Handler` 類別是一個基礎類別,它定義了所有處理器應具備的介面(interface),並"
1023-
"建立了某些子類別可以使用(或可以覆寫)的預設行為。"
1022+
"應用程式程式碼不應直接實例化和使用 :class:`Handler` 的實例。:class:`Handler` 類"
1023+
"別是一個基礎類別,它定義了所有處理器應具備的介面,並建立了一些子類別可以使用("
1024+
"或覆寫)的預設行為。"
10241025

10251026
#: ../../howto/logging.rst:550
10261027
msgid "Formatters"
@@ -1112,11 +1113,11 @@ msgstr ""
11121113

11131114
#: ../../howto/logging.rst:597
11141115
msgid "Configuring Logging"
1115-
msgstr "設定日誌(Logging)"
1116+
msgstr "設定日誌 (Logging)"
11161117

11171118
#: ../../howto/logging.rst:601
11181119
msgid "Programmers can configure logging in three ways:"
1119-
msgstr "開發者有三種設定日誌(Logging)的方式:"
1120+
msgstr "開發者有三種設定日誌的方式:"
11201121

11211122
#: ../../howto/logging.rst:603
11221123
msgid ""
@@ -1418,8 +1419,8 @@ msgid ""
14181419
"If :data:`raiseExceptions` is ``False`` (production mode), the event is "
14191420
"silently dropped."
14201421
msgstr ""
1421-
"如果 :data:`raiseExceptions` 為 ``False``\\ (正式產品模式),則該事件將會被"
1422-
"靜默刪除。"
1422+
"如果 :data:`raiseExceptions` 為 ``False``\\ (正式環境模式),該事件會被靜默捨"
1423+
"棄。"
14231424

14241425
#: ../../howto/logging.rst:805
14251426
msgid ""
@@ -1432,7 +1433,7 @@ msgstr ""
14321433
#: ../../howto/logging.rst:808
14331434
msgid ""
14341435
"To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``."
1435-
msgstr "要獲得 3.2 之前的行為,可以將 :data:`lastResort` 設定為 ``None``。"
1436+
msgstr "若要恢復 3.2 之前的行為,可以將 :data:`lastResort` 設為 ``None``。"
14361437

14371438
#: ../../howto/logging.rst:814
14381439
msgid "Configuring Logging for a Library"
@@ -1448,10 +1449,10 @@ msgid ""
14481449
"of severity ``WARNING`` and greater will be printed to ``sys.stderr``. This "
14491450
"is regarded as the best default behaviour."
14501451
msgstr ""
1451-
"開發使用 logging 的函式庫時,應該注意記錄函式庫如何使用 logging,例如所使用的記"
1452-
"錄器名稱。也需要考慮其日誌設定。如果使用該函式庫的應用程式沒有使用 logging,而"
1453-
"函式庫程式碼有呼叫 logging,那麼(如上一節所述)嚴重性為 ``WARNING`` 及以上的事"
1454-
"件會被印到 ``sys.stderr``。這被視為最佳的預設行為。"
1452+
"開發使用 logging 的函式庫時,應該在文件中說明函式庫如何使用 logging,例如所使用"
1453+
"的記錄器名稱。也需要考慮其日誌設定。如果使用該函式庫的應用程式沒有使用 "
1454+
"logging,而函式庫程式碼有呼叫 logging,那麼(如上一節所述)嚴重性為 "
1455+
"``WARNING`` 及以上的事件會被印到 ``sys.stderr``。這被視為最佳的預設行為。"
14551456

14561457
#: ../../howto/logging.rst:824
14571458
msgid ""
@@ -1464,11 +1465,11 @@ msgid ""
14641465
"suitably configured then logging calls made in library code will send output "
14651466
"to those handlers, as normal."
14661467
msgstr ""
1467-
"如果因為某些原因,你 *不希望* 在沒有任何日誌設定的情況下印出這些訊息,你可以將"
1468-
"一個什麼也不做的處理器附加到你函式庫的頂層記錄器。這樣可以避免印出訊息,因為函"
1469-
"式庫的事件總會找到處理器:只是該處理器不會產生任何輸出。如果函式庫的使用者為應"
1470-
"用程式設定了日誌,該設定大概會新增一些處理器,而如果等級設定得當,函式庫程式碼"
1471-
"中的 logging 呼叫就會像平常一樣將輸出發送到這些處理器。"
1468+
"如果因為某些原因,你\\ *不希望*\\ 在沒有任何日誌設定的情況下印出這些訊息,你可"
1469+
"以將一個什麼也不做的處理器附加到你函式庫的頂層記錄器。這樣可以避免印出訊息,因"
1470+
"為函式庫的事件總會找到處理器:只是該處理器不會產生任何輸出。如果函式庫的使用者"
1471+
"為應用程式設定了日誌,該設定大概會新增一些處理器,而如果等級設定得當,函式庫程"
1472+
"式碼中的 logging 呼叫就會像平常一樣將輸出發送到這些處理器。"
14721473

14731474
#: ../../howto/logging.rst:833
14741475
msgid ""
@@ -1512,9 +1513,9 @@ msgid ""
15121513
"application developer to configure the logging verbosity or handlers of your "
15131514
"library as they wish."
15141515
msgstr ""
1515-
"強烈建議你在函式庫中 *不要記錄到根記錄器*。請改用一個具有獨特且易於識別名稱的記"
1516-
"錄器,例如你函式庫頂層套件或模組的 ``__name__``。記錄到根記錄器會讓應用程式開發"
1517-
"者很難或無法依自己的需求設定你函式庫的日誌詳細程度或處理器。"
1516+
"強烈建議你在函式庫中\\ *不要記錄到根記錄器*。請改用一個具有獨特且易於識別名稱的"
1517+
"記錄器,例如你函式庫頂層套件或模組的 ``__name__``。記錄到根記錄器會讓應用程式開"
1518+
"發者很難或無法依自己的需求設定你函式庫的日誌詳細程度或處理器。"
15181519

15191520
#: ../../howto/logging.rst:855
15201521
msgid ""
@@ -1526,10 +1527,11 @@ msgid ""
15261527
"handlers 'under the hood', you might well interfere with their ability to "
15271528
"carry out unit tests and deliver logs which suit their requirements."
15281529
msgstr ""
1529-
"強烈建議你 *不要在你的函式庫記錄器中新增除* :class:`~logging.NullHandler` *之外"
1530-
"的處理器*。這是因為處理器的設定是使用你函式庫的應用程式開發人員的特權。應用程式"
1531-
"開發人員了解他們的目標受眾,也知道哪些處理器最適合他們的應用程式:如果你在「幕"
1532-
"後」新增處理器,很可能會干擾他們進行單元測試,以及產出符合其需求之日誌的能力。"
1530+
"強烈建議你\\ *不要在你的函式庫記錄器中新增除* :class:`~logging.NullHandler` *之"
1531+
"外的處理器*。這是因為處理器的設定是使用你函式庫的應用程式開發人員的特權。應用程"
1532+
"式開發人員了解他們的目標受眾,也知道哪些處理器最適合他們的應用程式:如果你在「"
1533+
"幕後」新增處理器,很可能會干擾他們進行單元測試,以及產出符合其需求之日誌的能力"
1534+
"。"
15331535

15341536
#: ../../howto/logging.rst:866
15351537
msgid "Logging Levels"
@@ -1543,9 +1545,9 @@ msgid ""
15431545
"define a level with the same numeric value, it overwrites the predefined "
15441546
"value; the predefined name is lost."
15451547
msgstr ""
1546-
"日誌等級的數值定義如下表所示。如果你想要定義自己的等級,並且需要使它們相對於"
1547-
"預定義的等級具有特定的值,這些內容會對你非常有幫助。如果你定義一個與預設數值"
1548-
"相同的等級,它會覆寫原先對應的預設值;原本預設的名稱也會消失。"
1548+
"日誌等級的數值如下表所示。如果你想定義自己的等級,並需要它們相對於預定義等級具"
1549+
"有特定的值,這些數值就很重要。如果你定義的等級與某個預定義等級的數值相同,它會"
1550+
"覆寫該預定義的值;預定義的名稱也會因此消失。"
15491551

15501552
#: ../../howto/logging.rst:875
15511553
msgid "Numeric value"
@@ -1599,8 +1601,8 @@ msgid ""
15991601
"class. When a logger decides to actually log an event, a :class:`~logging."
16001602
"LogRecord` instance is created from the logging message."
16011603
msgstr ""
1602-
"記錄訊息被編碼成 :class:`~logging.LogRecord` 類別的實例。當記錄器決定要真正地"
1603-
"記錄事件時,會從日誌訊息建立 :class:`~logging.LogRecord` 的實例。"
1604+
"日誌訊息被編碼為 :class:`~logging.LogRecord` 類別的實例。當記錄器決定要實際記錄"
1605+
"某個事件時,會從日誌訊息建立一個 :class:`~logging.LogRecord` 實例。"
16041606

16051607
#: ../../howto/logging.rst:901
16061608
msgid ""

0 commit comments

Comments
 (0)