Skip to content

feat: translate library/asyncio-graph.po#1208

Open
josix wants to merge 2 commits into3.14from
library/asyncio-graph
Open

feat: translate library/asyncio-graph.po#1208
josix wants to merge 2 commits into3.14from
library/asyncio-graph

Conversation

@josix
Copy link
Collaborator

@josix josix commented Feb 4, 2026

Complete translation of asyncio Call Graph Introspection documentation covering print_call_graph(), format_call_graph(), capture_call_graph() and low-level utility functions.

josix added 2 commits February 4, 2026 20:37
Complete translation of asyncio Call Graph Introspection documentation
covering print_call_graph(), format_call_graph(), capture_call_graph()
and low-level utility functions.
@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://python.github.io/python-docs-zh-tw/pr-preview/pr-1208/

Built to branch gh-pages at 2026-02-04 12:48 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@josix
Copy link
Collaborator Author

josix commented Feb 4, 2026

#: ../../library/asyncio-graph.rst:8
msgid "Call Graph Introspection"
msgstr ""
msgstr "呼叫圖內省(Graph Introspection)"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

「自識」(ref)、「內省」(wiki) 我都可以接受

@python python deleted a comment from wilson-wang-appier Mar 14, 2026
@python python deleted a comment from wilson-wang-appier Mar 14, 2026
@josix
Copy link
Collaborator Author

josix commented Mar 14, 2026

thanks 那保留內省好了看起來是常見的翻法
btw 補上 context

@mattwang44 @ken71301 你們對 Introspection 的翻譯有什麼想法嗎~ 意義上接近有一套可以觀察內部狀態的機制,但內省有點不到位的感覺

@josix josix requested a review from mattwang44 March 14, 2026 05:32
#: ../../library/asyncio-graph.rst:8
msgid "Call Graph Introspection"
msgstr ""
msgstr "呼叫圖內省(Graph Introspection)"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

只少掉一字 call 怕誤導

Suggested change
msgstr "呼叫圖內省(Graph Introspection)"
msgstr "呼叫圖內省(Call Graph Introspection)"

"within a Python program or by external profilers and debuggers."
msgstr ""
"asyncio 擁有強大的執行期呼叫圖內省工具,可以追蹤執行中的\\ *協程*\\ 或\\ "
"*任務*\\ ,或是暫停的\\ *future*\\ 的完整呼叫圖。這些工具和底層機制可以在 "
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"*任務*\\ ,或是暫停的\\ *future*\\ 的完整呼叫圖。這些工具和底層機制可以在 "
"*任務*,或是暫停的 *future* 的完整呼叫圖。這些工具和底層機制可以在 "

"*future*. These utilities and the underlying machinery can be used from "
"within a Python program or by external profilers and debuggers."
msgstr ""
"asyncio 擁有強大的執行期呼叫圖內省工具,可以追蹤執行中的\\ *協程*\\ 或\\ "
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

目前 runtime 都不翻

Suggested change
"asyncio 擁有強大的執行期呼叫圖內省工具,可以追蹤執行中的\\ *協程*\\ 或\\ "
"asyncio 擁有強大的 runtime 呼叫圖內省工具,可以追蹤執行中的\\ *協程*\\ 或\\ "

msgstr ""
"asyncio 擁有強大的執行期呼叫圖內省工具,可以追蹤執行中的\\ *協程*\\ 或\\ "
"*任務*\\ ,或是暫停的\\ *future*\\ 的完整呼叫圖。這些工具和底層機制可以在 "
"Python 程式內部使用,或被外部分析器和除錯器使用。"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"Python 程式內部使用,或被外部分析器和除錯器使用"
"Python 程式內部使用,或被外部分析器和偵錯器使用"

"*depth* argument can be used to skip the specified number of frames from top "
"of the stack."
msgstr ""
"如果在\\ *當前任務*\\ 上呼叫此函式,可以使用選擇性的僅限關鍵字引數 *depth* "
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://github.com/python/python-docs-zh-tw/wiki/%E8%A1%93%E8%AA%9E%E5%88%97%E8%A1%A8#%E5%85%B6%E4%BB%96%E7%BF%BB%E8%AD%AF%E7%BF%92%E6%85%A3

使用「目前」而非「當前」

Suggested change
"如果在\\ *當前任務*\\ 上呼叫此函式,可以使用選擇性的僅限關鍵字引數 *depth* "
"如果在\\ *目前任務*\\ 上呼叫此函式,可以使用選擇性的僅限關鍵字引數 *depth* "

Comment on lines +151 to +152
"類似於 :func:`print_call_graph`\\ ,但回傳一個字串。如果 *future* 為 "
"``None`` 且沒有當前任務,此函式回傳一個空字串。"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"類似於 :func:`print_call_graph`\\ ,但回傳一個字串。如果 *future* 為 "
"``None`` 且沒有當前任務,此函式回傳一個空字串。"
"類似於 :func:`print_call_graph`,但回傳一個字串。如果 *future* 為 "
"``None`` 且沒有目前任務,此函式回傳一個空字串。"

"Capture the async call graph for the current task or the "
"provided :class:`Task` or :class:`Future`."
msgstr ""
"捕獲當前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"捕獲當前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"
"捕獲目前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"

Comment on lines +167 to +168
"此函式接受一個選擇性的 *future* 引數。如果未傳入,將使用當前執行中的任務。"
"如果沒有當前任務,此函式回傳 ``None``\\ 。"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"此函式接受一個選擇性的 *future* 引數。如果未傳入,將使用當前執行中的任務"
"如果沒有當前任務,此函式回傳 ``None``\\ "
"此函式接受一個選擇性的 *future* 引數。如果未傳入,將使用目前執行中的任務"
"如果沒有目前任務,此函式回傳 ``None``。"

Comment on lines +219 to +220
"或 :class:`TaskGroup`\\ 。任何時候涉及使用低階 API(如 :meth:`Future."
"add_done_callback() <asyncio.Future.add_done_callback>`\\ )的中介 :class:"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"或 :class:`TaskGroup`\\ 。任何時候涉及使用低階 API(如 :meth:`Future."
"add_done_callback() <asyncio.Future.add_done_callback>`\\ )的中介 :class:"
"或 :class:`TaskGroup`。任何時候涉及使用低階 API(如 :meth:`Future."
"add_done_callback() <asyncio.Future.add_done_callback>`)的中介 :class:"

"This function prints entries starting from the top frame and going down "
"towards the invocation point."
msgstr ""
msgstr "此函式會從頂層框架開始印出條目,然後往下到呼叫點。"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto
這個 "frame" 出現比較早,原文附註應該在這邊

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants