Skip to content

Commit 15622c9

Browse files
josixclaude
andcommitted
fix: polish terminology and fluency in howto/logging.po
- Unify 開發人員 -> 開發者 and keep :dfn:`handler` in English like :dfn:`loggers` - Avoid 類別/處理器 ambiguity (categories -> 類型, error handler -> 錯誤處理程式) - Use project terms: 格式字串, 建構, 類檔案物件 - Translate "something like this" as 類似以下的內容 - Smooth awkward phrasing (依序, 未使用設定檔, 達到預期效果, 記載於) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 5982116 commit 15622c9

1 file changed

Lines changed: 25 additions & 27 deletions

File tree

‎howto/logging.po‎

Lines changed: 25 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ msgid ""
141141
"Report suppression of an error without raising an exception (e.g. error "
142142
"handler in a long-running server process)"
143143
msgstr ""
144-
"回報一個被抑制而未引發例外的錯誤(例如長時間執行的伺服器行程中的錯誤處理器)"
144+
"回報一個被抑制而未引發例外的錯誤(例如長時間執行的伺服器行程中的錯誤處理程式)"
145145

146146
#: ../../howto/logging.rst:63
147147
msgid ""
@@ -476,7 +476,7 @@ msgid ""
476476
"tutorial: see :ref:`formatting-styles` for more information."
477477
msgstr ""
478478
"如你所見,將變數資料合併到事件描述訊息中使用的是舊的 %-style 字串格式化方式。這"
479-
"是為了向後相容:logging 套件早於 :meth:`str.format` 和 "
479+
"是為了向後相容:logging 套件的出現早於 :meth:`str.format` 和 "
480480
":class:`string.Template` 等較新的格式化選項。這些較新的格式化選項\\ *確實*\\ 受"
481481
"到支援,但探索這些選項超出了本教學的範圍:請參閱 :ref:`formatting-styles` 以獲"
482482
"得更多資訊。"
@@ -541,7 +541,7 @@ msgid ""
541541
"To display the date and time of an event, you would place '%(asctime)s' in "
542542
"your format string::"
543543
msgstr ""
544-
"如果想要顯示事件的日期和時間,你可以在你的格式化字串中放置 '%(asctime)s': ::"
544+
"如果想要顯示事件的日期和時間,你可以在格式字串中放置 '%(asctime)s': ::"
545545

546546
#: ../../howto/logging.rst:267
547547
msgid ""
@@ -555,7 +555,7 @@ msgstr ""
555555

556556
#: ../../howto/logging.rst:271
557557
msgid "which should print something like this:"
558-
msgstr "會顯示以下訊息:"
558+
msgstr "應該會印出類似以下的內容:"
559559

560560
#: ../../howto/logging.rst:273
561561
msgid "2010-12-12 11:41:42,612 is when this event was logged."
@@ -585,7 +585,7 @@ msgstr ""
585585

586586
#: ../../howto/logging.rst:285
587587
msgid "which would display something like this:"
588-
msgstr "會顯示以下訊息:"
588+
msgstr "會顯示類似以下的內容:"
589589

590590
#: ../../howto/logging.rst:287
591591
msgid "12/12/2010 11:46:36 AM is when this event was logged."
@@ -644,7 +644,7 @@ msgid ""
644644
"The logging library takes a modular approach and offers several categories "
645645
"of components: loggers, handlers, filters, and formatters."
646646
msgstr ""
647-
"日誌記錄函式庫採用模組化方法,並提供多種類別的元件:記錄器、處理器、過濾器和格"
647+
"日誌記錄函式庫採用模組化方法,並提供多種類型的元件:記錄器、處理器、過濾器和格"
648648
"式化器。"
649649

650650
#: ../../howto/logging.rst:323
@@ -723,7 +723,7 @@ msgstr ""
723723
"記錄器階層的根部稱為根記錄器 (root logger)。這是由函式 :func:`debug`、"
724724
":func:`info`、:func:`warning`、:func:`error` 和 :func:`critical` 使用的記錄器,"
725725
"這些函式僅呼叫根記錄器的同名方法。這些函式和方法具有相同的簽名。根記錄器的名稱"
726-
"在記錄輸出中顯示為 'root'。"
726+
"在日誌輸出中顯示為 'root'。"
727727

728728
#: ../../howto/logging.rst:354
729729
msgid ""
@@ -737,9 +737,8 @@ msgid ""
737737
msgstr ""
738738
"當然,也可以將訊息記錄到不同的目的地。該套件支援將日誌訊息寫入檔案、HTTP "
739739
"GET/POST 位置、透過 SMTP 寄送的電子郵件、通用 socket、佇列,或像 syslog 或 "
740-
"Windows NT 事件日誌等作業系統特定的日誌機制。這些目的地由\\ :dfn:`處理器` "
741-
"(handler) 類別負責。如果你有內建處理器類別無法滿足的特殊需求,可以建立自己的日"
742-
"誌目的地類別。"
740+
"Windows NT 事件日誌等作業系統特定的日誌機制。這些目的地由 :dfn:`handler` 類別"
741+
"負責。如果你有內建處理器類別無法滿足的特殊需求,可以建立自己的日誌目的地類別。"
743742

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

761760
#: ../../howto/logging.rst:369
@@ -773,7 +772,7 @@ msgid ""
773772
"is constructed, see :ref:`formatter-objects`."
774773
msgstr ""
775774
"你可以透過傳遞格式字串到 :func:`basicConfig` 的 *format* 關鍵字引數來進行更"
776-
"改。有關格式字串構建的所有選項,請參閱 :ref:`formatter-objects`。"
775+
"改。有關格式字串建構的所有選項,請參閱 :ref:`formatter-objects`。"
777776

778777
#: ../../howto/logging.rst:380
779778
msgid "Logging Flow"
@@ -880,8 +879,8 @@ msgid ""
880879
"along with it. Call this method only from an exception handler."
881880
msgstr ""
882881
":meth:`Logger.exception` 建立的日誌訊息與 :meth:`Logger.error` 相似。差別在於 "
883-
":meth:`Logger.exception` 會同時傾印出堆疊追蹤 (stack trace)。請只在例外處理器中"
884-
"呼叫此方法。"
882+
":meth:`Logger.exception` 會同時傾印出堆疊追蹤 (stack trace)。請只在例外處理程式"
883+
"中呼叫此方法。"
885884

886885
#: ../../howto/logging.rst:479
887886
msgid ""
@@ -980,8 +979,8 @@ msgid ""
980979
"application developers who are using the built-in handler objects (that is, "
981980
"not creating custom handlers) are the following configuration methods:"
982981
msgstr ""
983-
"對於應用程式開發人員而言,需要關心的處理器方法非常少。使用內建的處理器物件(即"
984-
"未建立自訂處理器)時,似乎只有以下設定方法與應用程式開發人員有關:"
982+
"對於應用程式開發者而言,需要關心的處理器方法非常少。使用內建的處理器物件(即未"
983+
"建立自訂處理器)時,似乎只有以下設定方法與應用程式開發者有關:"
985984

986985
#: ../../howto/logging.rst:531
987986
msgid ""
@@ -1072,7 +1071,7 @@ msgid ""
10721071
"should conform to what is expected by :meth:`string.Template.substitute`."
10731072
msgstr ""
10741073
"如果 ``style`` 是 ``'%'``,則訊息格式字串使用 ``%(<dictionary key>)s`` 的樣式"
1075-
"字串替換;可能的鍵名已在 :ref:`logrecord-attributes` 中文件化。如果樣式是 "
1074+
"字串替換;可用的鍵名記載於 :ref:`logrecord-attributes`。如果樣式是 "
10761075
"``'{'``,則假設訊息格式字串與 :meth:`str.format` 相容(使用關鍵字引數),而如"
10771076
"果樣式是 ``'$'``,則訊息格式字串應符合 :meth:`string.Template.substitute` 預"
10781077
"期的格式。"
@@ -1087,8 +1086,7 @@ msgid ""
10871086
"format, the severity of the message, and the contents of the message, in "
10881087
"that order::"
10891088
msgstr ""
1090-
"下列訊息格式字串將以人類可讀的方式記錄訊息時間、訊息嚴重性和訊息內容,按照這"
1091-
"個順序: ::"
1089+
"下列訊息格式字串會依序以人類可讀的格式記錄時間、訊息嚴重性和訊息內容: ::"
10921090

10931091
#: ../../howto/logging.rst:585
10941092
msgid "'%(asctime)s - %(levelname)s - %(message)s'"
@@ -1257,7 +1255,7 @@ msgstr ""
12571255
#: ../../howto/logging.rst:702
12581256
msgid ""
12591257
"The output is nearly identical to that of the non-config-file-based example:"
1260-
msgstr "輸出結果和不基於設定檔的範例幾乎完全相同:"
1258+
msgstr "輸出結果和未使用設定檔的範例幾乎完全相同:"
12611259

12621260
#: ../../howto/logging.rst:704
12631261
msgid ""
@@ -1276,7 +1274,7 @@ msgid ""
12761274
"ability of noncoders to easily modify the logging properties."
12771275
msgstr ""
12781276
"可以看出,相較於 Python 程式碼的方式,設定檔的方式有一些優點,主要是設定與程式"
1279-
"碼分離,以及讓非開發人員也能輕鬆修改日誌屬性。"
1277+
"碼分離,以及讓不寫程式的人也能輕鬆修改日誌屬性。"
12801278

12811279
#: ../../howto/logging.rst:717
12821280
msgid ""
@@ -1377,7 +1375,7 @@ msgid ""
13771375
"For more information about logging using a dictionary, see :ref:`logging-"
13781376
"config-api`."
13791377
msgstr ""
1380-
"欲了解更多使用字典進行日誌設定的資訊,請參考 :ref:`logging-config-api`。"
1378+
"欲了解更多使用字典進行日誌設定的資訊,請參閱 :ref:`logging-config-api`。"
13811379

13821380
#: ../../howto/logging.rst:783
13831381
msgid "What happens if no configuration is provided"
@@ -1501,7 +1499,7 @@ msgid ""
15011499
"libraries, then the logger name specified can be 'orgname.foo' rather than "
15021500
"just 'foo'."
15031501
msgstr ""
1504-
"應該要有預期的結果。如果一個組織生產了多個函式庫,則指定的記錄器名稱可以是 "
1502+
"就能達到預期效果。如果一個組織開發了多個函式庫,則指定的記錄器名稱可以是 "
15051503
"'orgname.foo',而不只是 'foo'。"
15061504

15071505
#: ../../howto/logging.rst:848
@@ -1528,8 +1526,8 @@ msgid ""
15281526
"carry out unit tests and deliver logs which suit their requirements."
15291527
msgstr ""
15301528
"強烈建議你\\ *不要在你的函式庫記錄器中新增除* :class:`~logging.NullHandler` *之"
1531-
"外的處理器*。這是因為處理器的設定是使用你函式庫的應用程式開發人員的特權。應用程"
1532-
"式開發人員了解他們的目標受眾,也知道哪些處理器最適合他們的應用程式:如果你在「"
1529+
"外的處理器*。這是因為處理器的設定是使用你函式庫的應用程式開發者的特權。應用程"
1530+
"式開發者了解他們的目標受眾,也知道哪些處理器最適合他們的應用程式:如果你在「"
15331531
"幕後」新增處理器,很可能會干擾他們進行單元測試,以及產出符合其需求之日誌的能力"
15341532
"。"
15351533

@@ -1590,7 +1588,7 @@ msgid ""
15901588
"the method call's, no logging message is actually generated. This is the "
15911589
"basic mechanism controlling the verbosity of logging output."
15921590
msgstr ""
1593-
"等級也可以與記錄器關聯,由開發人員設定或透過載入已儲存的日誌設定來設定。當在記"
1591+
"等級也可以與記錄器關聯,由開發者設定或透過載入已儲存的日誌設定來設定。當在記"
15941592
"錄器上呼叫記錄方法時,記錄器會將自己的等級與該方法呼叫所對應的等級進行比較。如"
15951593
"果記錄器的等級高於方法呼叫的等級,就不會真的產生日誌訊息。這是控制日誌輸出詳細"
15961594
"程度的基本機制。"
@@ -1663,7 +1661,7 @@ msgid ""
16631661
":class:`StreamHandler` instances send messages to streams (file-like "
16641662
"objects)."
16651663
msgstr ""
1666-
":class:`StreamHandler` 實例會將訊息傳送到資料串流(與檔案相似的物件)中。"
1664+
":class:`StreamHandler` 實例會將訊息傳送到串流(類檔案物件)中。"
16671665

16681666
#: ../../howto/logging.rst:947
16691667
msgid ":class:`FileHandler` instances send messages to disk files."

0 commit comments

Comments
 (0)