Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
d33b8a0
Sync with cpython and translate new/fuzzy entries from upstream sync
claude Jul 5, 2026
e52c474
Translate fuzzy entries from upstream sync (cpython 07efb081)
claude Jul 5, 2026
2ec16fa
Use :term:`steal` role consistently for the "steals a reference" idiom
claude Jul 5, 2026
7e41056
Fix RST escaping bugs causing --fail-on-warning build failure
claude Jul 5, 2026
de1791a
Address review comments and fix remaining reference-count warning
claude Jul 5, 2026
bdae885
Translate fuzzy entries from upstream sync (cpython 7a7da86d)
claude Jul 10, 2026
be50f34
Translate new/fuzzy entries from upstream sync (cpython 9b33b258)
claude Jul 17, 2026
cc60e6a
Sync with cpython and translate new/fuzzy entries from upstream sync
claude Jul 24, 2026
e4f342b
Translate new/fuzzy entries from upstream sync (cpython 91abbe6f)
claude Jul 31, 2026
9d99613
Translate new/fuzzy entries from upstream sync (cpython 6e6984a)
claude Aug 7, 2026
142b0a8
Fix over-applied \\ escaping before closing/medial full-width punctua…
claude Aug 7, 2026
2723b80
Translate new/fuzzy entries from upstream sync (cpython 8f290e2c0)
claude Aug 14, 2026
b0c3eb1
Translate new/fuzzy entries from upstream sync (cpython 27349e70)
claude Aug 21, 2026
7e93e06
Translate new/fuzzy entries from upstream sync (cpython f9fdb30d)
claude Aug 28, 2026
fd92cef
Translate new/fuzzy entries from upstream sync (cpython 92cab347)
claude Sep 4, 2026
0696adf
Translate new/fuzzy entries from upstream sync (cpython 5400055d)
claude Sep 11, 2026
b9abde2
Translate new/fuzzy entries from upstream sync and port builtins/ reorg
claude Sep 18, 2026
0f3ceb2
Translate new/fuzzy entries from upstream sync (cpython 82075394)
claude Sep 25, 2026
a9a0580
Remove unnecessary backslash escaping before full-width close-paren
claude Sep 25, 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