translated library/contextvars.po; i added my personal interpreations of the original text, otherwise it wouldn't be understandable in chinese

husohome · husohome · commit 1d03bdd3d00f · 2025-07-17T20:51:50.000+08:00
diff --git a/library/contextvars.po b/library/contextvars.po
@@ -5,7 +5,7 @@ msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-10-31 00:13+0000\n"
-"PO-Revision-Date: 2025-07-13 00:28+0800\n"
+"PO-Revision-Date: 2025-07-17 20:49+0800\n"
 "Last-Translator: \n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -27,9 +27,10 @@ msgid ""
 "the :class:`~contextvars.Context` class should be used to manage the current "
 "context in asynchronous frameworks."
 msgstr ""
-"本模組供 API 來管理、儲存及存取 context-local 狀態。 用 :class:`~contextvars."
-"ContextVar` 型別宣告和處理 *情境變數*。 :func:`~contextvars.copy_context` 函式"
-"和 :class:`~contextvars.Context` 類別來在非同步框架中管理目前的情境。"
+"本模組供 API 來管理、儲存及存取單一情境各自的狀態（context-local state）。 "
+"用 :class:`~contextvars.ContextVar` 型別宣告和處理 *情境變數*。 :func:"
+"`~contextvars.copy_context` 函式和 :class:`~contextvars.Context` 類別來在非同"
+"步框架中管理目前的情境。"
 
 #: ../../library/contextvars.rst:17
 msgid ""
@@ -68,8 +69,8 @@ msgid ""
 "`ContextVar.get` when no value for the variable is found in the current "
 "context."
 msgstr ""
-"當在目前的情境中找不到變數的值時，:meth:`ContextVar.get` 會回傳 *default* 參數"
-"的值，此 *default* 參數只能用關鍵字來定義（關鍵字引數）。"
+"當在目前的情境中找不到變數的值時，:meth:`ContextVar.get` 會回傳 *default* 參"
+"數的值，此 *default* 參數只能用關鍵字來定義（關鍵字引數）。"
 
 #: ../../library/contextvars.rst:42
 msgid ""
@@ -78,9 +79,9 @@ msgid ""
 "context variables which prevents context variables from being properly "
 "garbage collected."
 msgstr ""
-"**重要：** 情境變數應該在最頂端的模組層級建立，絕對不要在閉包（closure）中建"
-"立。 :class:`Context` 物件持有情境變數的強參照，這會阻止情境變數被正確地垃圾"
-"回收（garbage collected）。"
+"**重要：**\\ 情境變數應該在最頂端的模組層級建立，絕對不要在閉包（closure）中"
+"建立。 :class:`Context` 物件持有情境變數的強參照，這會阻止情境變數被正確地垃"
+"圾回收（garbage collected）。"
 
 #: ../../library/contextvars.rst:49
 msgid "The name of the variable.  This is a read-only property."
@@ -99,17 +100,17 @@ msgstr "如果在當前情境中沒有變數的值，此方法將："
 #: ../../library/contextvars.rst:60
 msgid ""
 "return the value of the *default* argument of the method, if provided; or"
-msgstr "回傳方法的 *default* 引數值（如果有提供）；或"
+msgstr "回傳方法的 *default* 引數值（如果有的話）；否則"
 
 #: ../../library/contextvars.rst:63
 msgid ""
 "return the default value for the context variable, if it was created with "
 "one; or"
-msgstr "回傳情境變數的預設值（如果是用情境變量建立的的話）；或"
+msgstr "回傳情境變數的預設值（如果是用情境變量建立的的話）；否則"
 
 #: ../../library/contextvars.rst:66
 msgid "raise a :exc:`LookupError`."
-msgstr "引發一個 :exc:`LookupError`。"
+msgstr "會引發一個 :exc:`LookupError`。"
 
 #: ../../library/contextvars.rst:70
 msgid ""
@@ -126,8 +127,8 @@ msgid ""
 "Returns a :class:`~contextvars.Token` object that can be used to restore the "
 "variable to its previous value via the :meth:`ContextVar.reset` method."
 msgstr ""
-"回傳一個 :class:`~contextvars.Token` 物件，可以用來透過 :meth:`ContextVar."
-"reset` 方法還原變數到之前的值。"
+"回傳一個 :class:`~contextvars.Token` 物件，該物件可以用來還原變數到之前的值，"
+"透過 :meth:`ContextVar.reset` 方法"
 
 #: ../../library/contextvars.rst:82
 msgid ""
@@ -165,8 +166,8 @@ msgid ""
 "be passed to the :meth:`ContextVar.reset` method to revert the value of the "
 "variable to what it was before the corresponding *set*."
 msgstr ""
-"*Token* 物件由 :meth:`ContextVar.set` 方法回傳。它們可以丟進 :meth:"
-"`ContextVar.reset` 方法，用以將變數的值還原為相對應的 *set* 之前的值。"
+"*Token* 物件由 :meth:`ContextVar.set` 方法回傳，可以丟進 :meth:`ContextVar."
+"reset` 方法，用以將變數的值還原為相對應的 *set* 之前的值。"
 
 #: ../../library/contextvars.rst:106
 msgid ""
@@ -193,7 +194,7 @@ msgstr "手動情境管理"
 
 #: ../../library/contextvars.rst:126
 msgid "Returns a copy of the current :class:`~contextvars.Context` object."
-msgstr "傳回目前 :class:`~contextvars.Context` 物件的複本（copy）。"
+msgstr "回傳目前 :class:`~contextvars.Context` 物件的複本（copy）。"
 
 #: ../../library/contextvars.rst:128
 msgid ""
@@ -216,7 +217,7 @@ msgid ""
 "contexts with a few context variables and for contexts that have a lot of "
 "them."
 msgstr ""
-"這個函數具有 *O*\\ (1) 的複雜度，也就是說，對於只有少許情境變數的情境和有大量"
+"這個函式具有 *O*\\ (1) 的複雜度，也就是說，對於只有少許情境變數的情境和有大量"
 "情境變數的情境，速度都一樣快。"
 
 #: ../../library/contextvars.rst:141
@@ -228,7 +229,7 @@ msgid ""
 "``Context()`` creates an empty context with no values in it. To get a copy "
 "of the current context use the :func:`~contextvars.copy_context` function."
 msgstr ""
-"``Context()`` 會建立一個沒有值的空情境。要取得目前上下文的複本，請使用 :func:"
+"``Context()`` 會建立一個沒有值的空情境。要取得目前情境的複本，請使用 :func:"
 "`~contextvars.copy_context` 函式。"
 
 #: ../../library/contextvars.rst:147
@@ -238,18 +239,18 @@ msgid ""
 "current thread's stack.  All :class:`!Context` objects in the stacks are "
 "considered to be *entered*."
 msgstr ""
-"每個執行緒都有自己的 :class:`!Context` 物件的有效堆疊（stack）。  :term:"
-"`current context` 是目前執行緒堆疊頂端的 :class:`!Context` 物件。  堆疊中的所"
-"有 :class:`!Context` 物件都被視為 *entered*。"
+"每個執行緒都有自己的 :class:`!Context` 物件中目前主控中的堆疊（stack）。  :"
+"term:`current context` 是目前執行緒堆疊頂端的 :class:`!Context` 物件。  堆疊"
+"中的所有 :class:`!Context` 物件都被視為\\ *已進入*。"
 
 #: ../../library/contextvars.rst:152
 msgid ""
 "*Entering* a context, which can be done by calling its :meth:`~Context.run` "
 "method, makes the context the current context by pushing it onto the top of "
 "the current thread's context stack."
 msgstr ""
-"*進入* 一個情境，可以藉由呼叫其 :meth:`~Context.run` 方法來完成，此 *進入* 的動"
-"作會將一情境推到目前執行緒的情境堆疊的頂端，使該情境成為目前的情境。"
+"*進入*\\ 一個情境，可以藉由呼叫其 :meth:`~Context.run` 方法來完成，此 \\*進入"
+"*\\ 的動作會將一情境推到目前執行緒的情境堆疊的頂端，使該情境成為目前的情境。"
 
 #: ../../library/contextvars.rst:156
 msgid ""
@@ -258,9 +259,9 @@ msgid ""
 "context to what it was before the context was entered by popping the context "
 "off the top of the context stack."
 msgstr ""
-"*退出* 目前的情境，可以透過從傳遞給 :meth:`~Context.run` 方法的回呼函式"
-"（callback functions）中回傳來完成，這會將目前的情境還原到進入情境之前的狀"
-"態，方法是將情境從情境堆疊的頂端彈出。"
+"如果你傳遞給 :meth:`~Context.run` 方法的回呼函式（callback functions），該函"
+"式回傳之後，就會自動 \\*退出*\\ 目前的情境，這會將目前的情境還原到進入情境之"
+"前的狀態，方法是將情境從情境堆疊的頂端彈出。"
 
 #: ../../library/contextvars.rst:161
 msgid ""
@@ -293,22 +294,22 @@ msgid ""
 "the context)."
 msgstr ""
 "任何透過 :meth:`ContextVar.set` 方法對 :class:`ContextVar` 值的改變都會記錄在"
-"目前的情境中。  :meth:`ContextVar.get` 方法回傳與當前情境相關的值。  退出上下"
-"文會有效地還原在進入上下文時對上下文變數所做的任何變更（如果需要，可以透過重"
-"新進入上下文來還原值）。"
+"目前的情境中。  :meth:`ContextVar.get` 方法回傳與當前情境相關的值。  退出情境"
+"實際造成的效果會像是將其在進入情境時對情境變數所做的任何變一一彈出並還原（如"
+"果需要，可以透過重新進入情境來還原值）。"
 
 #: ../../library/contextvars.rst:177
 msgid "Context implements the :class:`collections.abc.Mapping` interface."
-msgstr "情境實作 :class:`collections.abc.Mapping` 介面。"
+msgstr "情境（Context）實作了 :class:`collections.abc.Mapping` 介面。"
 
 #: ../../library/contextvars.rst:181
 msgid ""
 "Enters the Context, executes ``callable(*args, **kwargs)``, then exits the "
 "Context.  Returns *callable*'s return value, or propagates an exception if "
 "one occurred."
 msgstr ""
-"進入 Context，執行``callable(*args, **kwargs)``，然後退出 Context。  返回 "
-"*callable* 的回傳值，如果發生異常，則傳播異常。"
+"進入 Context，執行``callable(*args, **kwargs)``，然後退出 Context。 回傳 "
+"*callable* 的回傳值，如果發生例外（exception），則傳播例外。"
 
 #: ../../library/contextvars.rst:185
 msgid "Example:"
@@ -386,14 +387,15 @@ msgstr "回傳情境物件的淺層複本（shallow copy）。"
 msgid ""
 "Return ``True`` if the *context* has a value for *var* set; return ``False`` "
 "otherwise."
-msgstr "如果*情境*裡面有 *var* 的值，則傳回 ``True``；否則傳回 ``False``。"
+msgstr ""
+"如果 \\*情境*\\ 裡面有 *var* 的值，則回傳 ``True``，否則回傳 ``False``。"
 
 #: ../../library/contextvars.rst:242
 msgid ""
 "Return the value of the *var* :class:`ContextVar` variable. If the variable "
 "is not set in the context object, a :exc:`KeyError` is raised."
 msgstr ""
-"傳回 *var* :class:`ContextVar` 變數的值。如果該變數並沒有在情境物件中設定，則"
+"回傳 *var* :class:`ContextVar` 變數的值。如果該變數並沒有在情境物件中設定，則"
 "會引發 :exc:`KeyError` 錯誤。"
 
 #: ../../library/contextvars.rst:248
@@ -438,8 +440,7 @@ msgid ""
 "available in the Task that handles that client::"
 msgstr ""
 ":mod:`asyncio` 原生支援情境變數，不需任何額外設定。 舉例來說，以下是一個簡單"
-"的 echo 伺服器，使用上下文變數讓遠端用客戶端的位址在處理該用戶端的任務中可"
-"用："
+"的 echo 伺服器，使用情境變數讓遠端用客戶端的位址在處理該用戶端的任務中可用："
 
 #: ../../library/contextvars.rst:285
 msgid ""
