Skip to content

Working on howto/annotations.po #1242

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

Open
dyp1109 wants to merge 1 commit into
base: 3.14
Choose a base branch
from
Open

Working on howto/annotations.po #1242

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
154 changes: 87 additions & 67 deletions howto/annotations.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-01-22 16:55+0000\n"
"PO-Revision-Date: 2023-11-08 23:11+0800\n"
"Last-Translator: rockleon <therockleona@gmail.com>\n"
"PO-Revision-Date: 2026-09-12 20:49+0800\n"
"Last-Translator: dy1012 <dylanpong@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 3.4.1\n"
"X-Generator: Poedit 3.4.4\n"

#: ../../howto/annotations.rst:5
msgid "Annotations Best Practices"
Expand Down Expand Up @@ -60,8 +60,8 @@ msgstr ""
msgid ""
"Note that this document is specifically about working with "
"``__annotations__``, not uses *for* annotations. If you're looking for "
"information on how to use \"type hints\" in your code, please see the :mod:"
"`typing` module."
"information on how to use \"type hints\" in your code, please see "
"the :mod:`typing` module."
msgstr ""
"請注意，本文件是特別說明 ``__annotations__`` 的使用，而非\\ *如何使用*\\ 註"
"釋。如果你正在尋找如何在你的程式碼中使用「型別提示 (type hint)」的資訊，請查"
Expand All @@ -73,11 +73,11 @@ msgstr "在 Python 3.10 及更高版本中存取物件的註釋字典"

#: ../../howto/annotations.rst:35
msgid ""
"Python 3.10 adds a new function to the standard library: :func:`inspect."
"get_annotations`. In Python versions 3.10 through 3.13, calling this "
"function is the best practice for accessing the annotations dict of any "
"object that supports annotations. This function can also \"un-stringize\" "
"stringized annotations for you."
"Python 3.10 adds a new function to the standard "
"library: :func:`inspect.get_annotations`. In Python versions 3.10 through "
"3.13, calling this function is the best practice for accessing the "
"annotations dict of any object that supports annotations. This function can "
"also \"un-stringize\" stringized annotations for you."
msgstr ""
"Python 3.10 在標準函式庫中新增了一個新函式：:func:`inspect.get_annotations`。"
"在 Python 3.10 到 3.13，呼叫此函式是存取任何支援註釋的物件的註釋字典的最佳實"
Expand All @@ -86,17 +86,20 @@ msgstr ""
#: ../../howto/annotations.rst:42
msgid ""
"In Python 3.14, there is a new :mod:`annotationlib` module with "
"functionality for working with annotations. This includes a :func:"
"`annotationlib.get_annotations` function, which supersedes :func:`inspect."
"get_annotations`."
"functionality for working with annotations. This includes "
"a :func:`annotationlib.get_annotations` function, which "
"supersedes :func:`inspect.get_annotations`."
msgstr ""
"在 Python 3.14 中，新增了一個名為 :mod:`annotationlib` 的模組，具備處理註釋的"
"功能。其中包含一個名為 :func:`annotationlib.get_annotations` 的函式，該函式已"
"取代 :func:`inspect.get_annotations`。"

#: ../../howto/annotations.rst:47
msgid ""
"If for some reason :func:`inspect.get_annotations` isn't viable for your use "
"case, you may access the ``__annotations__`` data member manually. Best "
"practice for this changed in Python 3.10 as well: as of Python 3.10, ``o."
"__annotations__`` is guaranteed to *always* work on Python functions, "
"practice for this changed in Python 3.10 as well: as of Python 3.10, "
"``o.__annotations__`` is guaranteed to *always* work on Python functions, "
"classes, and modules. If you're certain the object you're examining is one "
"of these three *specific* objects, you may simply use ``o.__annotations__`` "
"to get at the object's annotations dict."
Expand All @@ -109,11 +112,12 @@ msgstr ""

#: ../../howto/annotations.rst:57
msgid ""
"However, other types of callables--for example, callables created by :func:"
"`functools.partial`--may not have an ``__annotations__`` attribute defined. "
"When accessing the ``__annotations__`` of a possibly unknown object, best "
"practice in Python versions 3.10 and newer is to call :func:`getattr` with "
"three arguments, for example ``getattr(o, '__annotations__', None)``."
"However, other types of callables--for example, callables created "
"by :func:`functools.partial`--may not have an ``__annotations__`` attribute "
"defined. When accessing the ``__annotations__`` of a possibly unknown "
"object, best practice in Python versions 3.10 and newer is to "
"call :func:`getattr` with three arguments, for example ``getattr(o, "
"'__annotations__', None)``."
msgstr ""
"但是，其他型別的 callable（可呼叫物件）（例如，由 :func:`functools.partial` "
"建立的 callable）可能沒有定義 ``__annotations__`` 屬性 (attribute)。當存取可"
Expand Down Expand Up @@ -205,9 +209,9 @@ msgid ""
msgstr ""
"如果你正在檢查的物件是一個類別 (``isinstance(o, type)``)，你的程式碼將必須有"
"一個單獨的程式碼路徑。在這種情況下，最佳實踐依賴 Python 3.9 及之前版本的實作"
"細節 (implementation detail)：如果一個類別定義了註釋，它們將儲存在該類別的 :"
"attr:`~type.__dict__` 字典中。由於類別可能定義了註釋，也可能沒有定義，因此最"
"佳實踐是在類別字典上呼叫 :meth:`~dict.get` 方法。"
"細節 (implementation detail)：如果一個類別定義了註釋，它們將儲存在該類別"
"的 :attr:`~type.__dict__` 字典中。由於類別可能定義了註釋，也可能沒有定義，因"
"此最佳實踐是在類別字典上呼叫 :meth:`~dict.get` 方法。"

#: ../../howto/annotations.rst:114
msgid ""
Expand All @@ -233,21 +237,21 @@ msgstr ""
#: ../../howto/annotations.rst:123
msgid ""
"After running this code, ``ann`` should be either a dictionary or ``None``. "
"You're encouraged to double-check the type of ``ann`` using :func:"
"`isinstance` before further examination."
"You're encouraged to double-check the type of ``ann`` "
"using :func:`isinstance` before further examination."
msgstr ""
"運行此程式碼後，``ann`` 應該是字典或 ``None``。我們鼓勵你在進一步檢查之前使"
"用 :func:`isinstance` 仔細檢查 ``ann`` 的型別。"

#: ../../howto/annotations.rst:128
msgid ""
"Note that some exotic or malformed type objects may not have a :attr:`~type."
"__dict__` attribute, so for extra safety you may also wish to use :func:"
"`getattr` to access :attr:`!__dict__`."
"Note that some exotic or malformed type objects may not have "
"a :attr:`~type.__dict__` attribute, so for extra safety you may also wish to "
"use :func:`getattr` to access :attr:`!__dict__`."
msgstr ""
"請注意，某些外來 (exotic) 或格式錯誤 (malform) 的型別物件可能沒有 :attr:"
"`~type.__dict__` 屬性，因此為了額外的安全，你可能還希望使用 :func:`getattr` "
"來存取 :attr:`!__dict__`。"
"請注意，某些外來 (exotic) 或格式錯誤 (malform) 的型別物件可能沒"
"有 :attr:`~type.__dict__` 屬性，因此為了額外的安全，你可能還希望使"
"用 :func:`getattr` 來存取 :attr:`!__dict__`。"

#: ../../howto/annotations.rst:134
msgid "Manually Un-Stringizing Stringized Annotations"
Expand All @@ -265,14 +269,15 @@ msgstr ""

#: ../../howto/annotations.rst:142
msgid ""
"If you're using Python 3.9 or older, or if for some reason you can't use :"
"func:`inspect.get_annotations`, you'll need to duplicate its logic. You're "
"encouraged to examine the implementation of :func:`inspect.get_annotations` "
"in the current Python version and follow a similar approach."
"If you're using Python 3.9 or older, or if for some reason you can't "
"use :func:`inspect.get_annotations`, you'll need to duplicate its logic. "
"You're encouraged to examine the implementation "
"of :func:`inspect.get_annotations` in the current Python version and follow "
"a similar approach."
msgstr ""
"如果你使用的是 Python 3.9 或更早版本，或者由於某種原因你無法使用 :func:"
"`inspect.get_annotations`，則需要複製其邏輯。我們鼓勵你檢查目前 Python 版本"
"中 :func:`inspect.get_annotations` 的實作並遵循類似的方法。"
"如果你使用的是 Python 3.9 或更早版本，或者由於某種原因你無法使"
"用 :func:`inspect.get_annotations`，則需要複製其邏輯。我們鼓勵你檢查目前 "
"Python 版本中 :func:`inspect.get_annotations` 的實作並遵循類似的方法。"

#: ../../howto/annotations.rst:148
msgid ""
Expand All @@ -282,40 +287,41 @@ msgstr "簡而言之，如果你希望評估任意物件 ``o`` 上的字串化

#: ../../howto/annotations.rst:151
msgid ""
"If ``o`` is a module, use ``o.__dict__`` as the ``globals`` when calling :"
"func:`eval`."
"If ``o`` is a module, use ``o.__dict__`` as the ``globals`` when "
"calling :func:`eval`."
msgstr ""
"如果 ``o`` 是一個模組，則在呼叫 :func:`eval` 時使用 ``o.__dict__`` 作為\\ ``"
"全域變數``。"

#: ../../howto/annotations.rst:153
msgid ""
"If ``o`` is a class, use ``sys.modules[o.__module__].__dict__`` as the "
"``globals``, and ``dict(vars(o))`` as the ``locals``, when calling :func:"
"`eval`."
"``globals``, and ``dict(vars(o))`` as the ``locals``, when "
"calling :func:`eval`."
msgstr ""
"如果 ``o`` 是一個類別，當呼叫 :func:`eval` 時，則使用 ``sys.modules[o."
"__module__].__dict__`` 作為\\ ``全域變數``，使用 ``dict(vars(o))`` 作為\\ ``"
"區域變數``。"
"如果 ``o`` 是一個類別，當呼叫 :func:`eval` 時，則使用 "
"``sys.modules[o.__module__].__dict__`` 作為\\ ``全域變數``，使用 "
"``dict(vars(o))`` 作為\\ ``區域變數``。"

#: ../../howto/annotations.rst:156
msgid ""
"If ``o`` is a wrapped callable using :func:`functools.update_wrapper`, :func:"
"`functools.wraps`, or :func:`functools.partial`, iteratively unwrap it by "
"accessing either ``o.__wrapped__`` or ``o.func`` as appropriate, until you "
"have found the root unwrapped function."
"If ``o`` is a wrapped callable "
"using :func:`functools.update_wrapper`, :deco:`functools.wraps`, "
"or :func:`functools.partial`, iteratively unwrap it by accessing either "
"``o.__wrapped__`` or ``o.func`` as appropriate, until you have found the "
"root unwrapped function."
msgstr ""
"如果 ``o`` 是使用 :func:`functools.update_wrapper`、:func:`functools.wraps` "
"或 :func:`functools.partial` 包裝的 callable ，請依據需求，透過存取 ``o."
"__wrapped__`` 或 ``o.func`` 來疊代解開它，直到找到根解包函式。"
"或 :func:`functools.partial` 包裝的 callable ，請依據需求，透過存取 "
"``o.__wrapped__`` 或 ``o.func`` 來疊代解開它，直到找到根解包函式。"

#: ../../howto/annotations.rst:160
msgid ""
"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ <function."
"__globals__>` as the globals when calling :func:`eval`."
"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ "
"<function.__globals__>` as the globals when calling :func:`eval`."
msgstr ""
"如果 ``o`` 是 callable（但不是類別），則在呼叫 :func:`eval` 時使用 :attr:`o."
"__globals__ <function.__globals__>` 作為全域變數。"
"如果 ``o`` 是 callable（但不是類別），則在呼叫 :func:`eval` 時使"
"用 :attr:`o.__globals__ <function.__globals__>` 作為全域變數。"

#: ../../howto/annotations.rst:164
msgid ""
Expand All @@ -338,8 +344,8 @@ msgstr ""

#: ../../howto/annotations.rst:173
msgid ""
"Definitions that aren't needed at runtime, only imported when :const:`typing."
"TYPE_CHECKING` is true."
"Definitions that aren't needed at runtime, only imported "
"when :const:`typing.TYPE_CHECKING` is true."
msgstr ""
"Runtime 中不需要的定義，僅在 :const:`typing.TYPE_CHECKING` 為 true 時匯入。"

Expand Down Expand Up @@ -376,9 +382,12 @@ msgstr ""
#: ../../howto/annotations.rst:192
msgid ""
"You should avoid accessing ``__annotations__`` directly on any object. "
"Instead, use :func:`annotationlib.get_annotations` (Python 3.14+) or :func:"
"`inspect.get_annotations` (Python 3.10+)."
"Instead, use :func:`annotationlib.get_annotations` (Python 3.14+) "
"or :func:`inspect.get_annotations` (Python 3.10+)."
msgstr ""
"你應該避免直接存取物件的 ``__annotations__`` 。請改"
"用 :func:`annotationlib.get_annotations` (Python 3.14+) "
"或 :func:`inspect.get_annotations` (Python 3.10+)."

#: ../../howto/annotations.rst:196
msgid ""
Expand Down Expand Up @@ -477,18 +486,29 @@ msgstr ""
msgid ""
"If you use a class with a custom metaclass and access ``__annotations__`` on "
"the class, you may observe unexpected behavior; see :pep:`749 <749#pep749-"
"metaclasses>` for some examples. You can avoid these quirks by using :func:"
"`annotationlib.get_annotations` on Python 3.14+ or :func:`inspect."
"get_annotations` on Python 3.10+. On earlier versions of Python, you can "
"avoid these bugs by accessing the annotations from the class's :attr:`~type."
"__dict__` (for example, ``cls.__dict__.get('__annotations__', None)``)."
msgstr ""
"metaclasses>` for some examples. You can avoid these quirks by "
"using :func:`annotationlib.get_annotations` on Python 3.14+ "
"or :func:`inspect.get_annotations` on Python 3.10+. On earlier versions of "
"Python, you can avoid these bugs by accessing the annotations from the "
"class's :attr:`~type.__dict__` (for example, "
"``cls.__dict__.get('__annotations__', None)``)."
msgstr ""
"如果你使用的類別具有自訂的元類別，並存取該類別的 ``__annotations__`` ，你可能"
"會觀察到出乎意料的行為；請查閱 :pep:`749 <749#pep749-metaclasses>` 的例子。你"
"可以在Python 3.14+ 使用 :func:`annotationlib.get_annotations` 或者在 Python "
"3.10+ 使用 :func:`inspect.get_annotations` 來避免這些問題。在更早期的版本，你"
"可以存取類別的 :attr:`~type.__dict__` 來避免這些問題。（例如："
"``cls.__dict__.get(‘__annotations__’, None)`` ）"

#: ../../howto/annotations.rst:253
msgid ""
"In some versions of Python, instances of classes may have an "
"``__annotations__`` attribute. However, this is not supported functionality. "
"If you need the annotations of an instance, you can use :func:`type` to "
"access its class (for example, ``annotationlib."
"get_annotations(type(myinstance))`` on Python 3.14+)."
"access its class (for example, "
"``annotationlib.get_annotations(type(myinstance))`` on Python 3.14+)."
msgstr ""
"在某些 Python 版本中，類別實例可能會帶有 ``__annotations__`` 的屬性，但這並非"
"受支援的功能。如果你需要取得實例的註釋，可以用 :func:`type` 來存取實例的類別"
"（例如在 Python 3.14+ 中使用 "
"``annotationlib.get_annotations(type(myinstance))`` )."