Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
35209c1
Sync with cpython and translate new/fuzzy entries from upstream sync
claude Jul 5, 2026
8cb2282
Translate fuzzy entries from upstream sync (cpython 07efb081)
claude Jul 5, 2026
18a12e1
Use :term:`steal` role consistently for the "steals a reference" idiom
claude Jul 5, 2026
61f3c90
Fix RST escaping bugs causing --fail-on-warning build failure
claude Jul 5, 2026
1ebe0dc
Address review comments and fix remaining reference-count warning
claude Jul 5, 2026
7127012
Translate fuzzy entries from upstream sync (cpython 7a7da86d)
claude Jul 10, 2026
ed4879c
Translate new/fuzzy entries from upstream sync (cpython 9b33b258)
claude Jul 17, 2026
800c3f3
Sync with cpython and translate new/fuzzy entries from upstream sync
claude Jul 24, 2026
55f6383
Translate new/fuzzy entries from upstream sync (cpython 91abbe6f)
claude Jul 31, 2026
5d24162
Translate new/fuzzy entries from upstream sync (cpython 6e6984a)
claude Aug 7, 2026
5116521
Fix over-applied \\ escaping before closing/medial full-width punctua…
claude Aug 7, 2026
3ee122d
Translate new/fuzzy entries from upstream sync (cpython 8f290e2c0)
claude Aug 14, 2026
181e57b
Translate new/fuzzy entries from upstream sync (cpython 27349e70)
claude Aug 21, 2026
4dda009
Translate new/fuzzy entries from upstream sync (cpython f9fdb30d)
claude Aug 28, 2026
39cfe1e
Translate new/fuzzy entries from upstream sync (cpython 92cab347)
claude Sep 4, 2026
a9a6ad6
Translate new/fuzzy entries from upstream sync (cpython 5400055d)
claude Sep 11, 2026
beed5ec
Translate new/fuzzy entries from upstream sync and port builtins/ reorg
claude Sep 18, 2026
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
7 changes: 7 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,13 @@ make progress # Check translation progress
### reST Syntax
- Preserve `:mod:`, `:func:`, `:class:`, `:term:`, `:ref:`, `:pep:` roles
- Use `\\ ` as zero-width separator when Chinese precedes reST syntax
- `\\ ` is also required when a role/literal/emphasis close is immediately followed by an
**opening** full-width punctuation mark (`(`, `「`, `『`) — confirmed by corpus-wide grep:
~1 unescaped vs ~473 escaped occurrences. Example: `` :class:`Widget`\\ ( ``.
- `\\ ` is **not** needed before **closing/medial** full-width punctuation (`。`, `,`, `:`,
`;`, `!`, `?`, `」`, `』`, `)`) — this is the dominant, unescaped, CI-passing convention
throughout the corpus (thousands of unescaped examples vs. a handful of escaped outliers).
Do not add `\\ ` there even if it looks visually similar to the open-paren case.

## Key Resources

Expand Down
58 changes: 51 additions & 7 deletions builtins/constants.po
Original file line number Diff line number Diff line change
Expand Up @@ -19,23 +19,27 @@ msgstr ""

#: ../../builtins/constants.rst:4
msgid "Built-in Constants"
msgstr ""
msgstr "內建常數"

#: ../../builtins/constants.rst:6
msgid "A small number of constants live in the built-in namespace. They are:"
msgstr ""
msgstr "有一小部分的常數存在於內建命名空間中。他們是:"

#: ../../builtins/constants.rst:10
msgid ""
"The false value of the :class:`bool` type. Assignments to ``False`` are "
"illegal and raise a :exc:`SyntaxError`."
msgstr ""
"在 :class:`bool` 型別中的 false 值。對於 ``False`` 的賦值是不合法的,並且會拋"
"出 :exc:`SyntaxError`。"

#: ../../builtins/constants.rst:16
msgid ""
"The true value of the :class:`bool` type. Assignments to ``True`` are "
"illegal and raise a :exc:`SyntaxError`."
msgstr ""
"在 :class:`bool` 型別中的 true 值。對於 ``True`` 的賦值是不合法的,並且會拋"
"出 :exc:`SyntaxError`。"

#: ../../builtins/constants.rst:22
msgid ""
Expand All @@ -44,6 +48,9 @@ msgid ""
"illegal and raise a :exc:`SyntaxError`. ``None`` is the sole instance of "
"the :class:`~types.NoneType` type."
msgstr ""
"一個經常被使用來表達缺少值的物件,例如未傳送預設的引數至函式時。對於 "
"``None`` 的賦值是不合法的,並且會引發 :exc:`SyntaxError`。``None`` 是 :class:"
"`~types.NoneType` 型別的唯一實例。"

#: ../../builtins/constants.rst:30
msgid ""
Expand All @@ -56,6 +63,12 @@ msgid ""
"boolean context. :data:`!NotImplemented` is the sole instance of the :class:"
"`types.NotImplementedType` type."
msgstr ""
"會被二元特殊方法 (binary special methods)(如::meth:`~object.__eq__`、:meth:"
"`~object.__lt__`、:meth:`~object.__add__`、:meth:`~object.__rsub__` 等)所回"
"傳的特殊值,代表著該運算沒有針對其他型別的實作。同理也可以被原地二元特殊方法 "
"(in-place binary special methods) (如::meth:`~object.__imul__`、:meth:"
"`~object.__iand__` 等)回傳。它不應該被作為 boolean(布林)來解讀。:data:`!"
"NotImplemented` 是 :class:`types.NotImplementedType` 型別的唯一實例。"

#: ../../builtins/constants.rst:40
msgid ""
Expand All @@ -67,28 +80,40 @@ msgid ""
"error message or the :data:`!NotImplemented` value being returned to Python "
"code."
msgstr ""
"當一個二元 (binary) 或原地 (in-place) 方法回傳 :data:`!NotImplemented`,直譯"
"器會嘗試反映該操作到其他型別(或是其他後備 (fallback),取決於是哪種運算子)。"
"如果所有的常識都回傳 :data:`!NotImplemented`,直譯器會拋出適當的例外。不正確"
"的回傳 :data:`!NotImplemented` 會造成誤導的錯誤訊息或是 :data:`!"
"NotImplemented` 值被傳回到 Python 程式碼中。"

#: ../../builtins/constants.rst:47
msgid "See :ref:`implementing-the-arithmetic-operations` for examples."
msgstr ""
msgstr "請參見 :ref:`implementing-the-arithmetic-operations` 以找到更多範例。"

#: ../../builtins/constants.rst:51
msgid ""
":data:`!NotImplemented` and :exc:`!NotImplementedError` are not "
"interchangeable. This constant should only be used as described above; see :"
"exc:`NotImplementedError` for details on correct usage of the exception."
msgstr ""
":data:`!NotImplemented` 與 :exc:`!NotImplementedError` 並不一樣且不可互換。這"
"個常數只能用於上述的情況;欲知更多如何正確使用它們的細節,請參見 :exc:"
"`NotImplementedError`。"

#: ../../builtins/constants.rst:56
msgid "Evaluating :data:`!NotImplemented` in a boolean context was deprecated."
msgstr ""
"在 boolean(布林)上下文中對 :data:`!NotImplemented` 求值的操作已被棄用。"

#: ../../builtins/constants.rst:59
msgid ""
"Evaluating :data:`!NotImplemented` in a boolean context now raises a :exc:"
"`TypeError`. It previously evaluated to :const:`True` and emitted a :exc:"
"`DeprecationWarning` since Python 3.9."
msgstr ""
"在 boolean 上下文中解讀 :data:`!NotImplemented` 現在會引發 :exc:`TypeError`。"
"過去自 Python 3.9 以來,這會被解讀成 :const:`True`,並發出 :exc:"
"`DeprecationWarning`"

#: ../../builtins/constants.rst:68
msgid ""
Expand All @@ -97,23 +122,31 @@ msgid ""
"but assignment to ``...`` raises a :exc:`SyntaxError`. ``Ellipsis`` is the "
"sole instance of the :class:`types.EllipsisType` type."
msgstr ""
"與刪節號 \"``...``\" 字面相同,是一個經常被用來表示某些東西被省略的物件。對"
"於 ``Ellipsis`` 的賦值是可能的,但對於 ``...`` 的賦值會引發 :exc:"
"`SyntaxError`。``Ellipsis`` 是 :class:`types.EllipsisType` 型別的唯一實例。"

#: ../../builtins/constants.rst:76
msgid ""
"This constant is true if Python was not started with an :option:`-O` option. "
"See also the :keyword:`assert` statement."
msgstr ""
"如果 Python 沒有被以 :option:`-O` 選項啟動,則此常數為 true。請參見 :keyword:"
"`assert` 陳述式。"

#: ../../builtins/constants.rst:82
msgid ""
"The names :data:`None`, :data:`False`, :data:`True` and :data:`__debug__` "
"cannot be reassigned (assignments to them, even as an attribute name, raise :"
"exc:`SyntaxError`), so they can be considered \"true\" constants."
msgstr ""
":data:`None`,:data:`False`,:data:`True`,以及 :data:`__debug__` 都是不能被"
"重新賦值的(任何對它們的賦值,即使是屬性的名稱,也會拋出 :exc:"
"`SyntaxError`)。因此,它們可以被視為”真正的”常數。"

#: ../../builtins/constants.rst:90
msgid "Constants added by the :mod:`site` module"
msgstr ""
msgstr "由 :mod:`site` module(模組)所添增的常數"

#: ../../builtins/constants.rst:92
msgid ""
Expand All @@ -122,13 +155,19 @@ msgid ""
"constants to the built-in namespace. They are useful for the interactive "
"interpreter shell and should not be used in programs."
msgstr ""
":mod:`site` module(模組)(在啟動期間自動 import ,除非有給予 :option:`-S` "
"指令行選項)會添增一些常數到內建命名空間 (built-in namespace) 中。它們在互動"
"式直譯器中是很有幫助的,但不應該在程式 (programs) 中被使用。"

#: ../../builtins/constants.rst:100
msgid ""
"Objects that when printed, print a message like \"Use quit() or Ctrl-D (i.e. "
"EOF) to exit\", and when accessed directly in the interactive interpreter or "
"called as functions, raise :exc:`SystemExit` with the specified exit code."
msgstr ""
"當印出物件時,會印出一個訊息:\"Use quit() or Ctrl-D (i.e. EOF) to exit\"。當"
"直接在互動式直譯器中存取或作為函式呼叫時,會引發 :exc:`SystemExit` 並帶有指定"
"的返回碼(exit code)。"

#: ../../builtins/constants.rst:108
msgid ""
Expand All @@ -137,24 +176,29 @@ msgid ""
"in the interactive interpreter, invokes the built-in help system (see :func:"
"`help`)."
msgstr ""
"當印出此物件時,會印出訊息 \"Type help() for interactive help, or "
"help(object) for help about object.\",並在互動式直譯器中直接存取時,會叫用內"
"建的幫助系統(參見 :func:`help`)。"

#: ../../builtins/constants.rst:116
msgid ""
"Objects that when printed or called, print the text of copyright or credits, "
"respectively."
msgstr ""
msgstr "當印出或是呼叫此物件時,分別會印出版權與致謝的文字。"

#: ../../builtins/constants.rst:121
msgid ""
"Object that when printed, prints the message \"Type license() to see the "
"full license text\", and when called, displays the full license text in a "
"pager-like fashion (one screen at a time)."
msgstr ""
"當印出此物件時,會印出訊息 \"Type license() to see the full license text\","
"並在呼叫時以分頁形式印出完整的許可證文字(一次一整個畫面)。"

#: ../../builtins/constants.rst:65
msgid "..."
msgstr ""
msgstr "..."

#: ../../builtins/constants.rst:65
msgid "ellipsis literal"
msgstr ""
msgstr "ellipsis literal(刪節號字面值)"
Loading
Loading