Fix RST escaping bugs causing --fail-on-warning build failure · mattwang44/python-docs-zh-tw@a99f0d0 · GitHub

1. mattwang44
2. python-docs-zh-tw

Repository navigation

• Code
• Pull requests
• Actions
• Projects
• Security and quality
• Insights

Commit a99f0d0

Browse filesBrowse the repository at this point in the historyBrowse files

claude

committed

Fix RST escaping bugs causing --fail-on-warning build failure

CI builds with sphinx-build --fail-on-warning, so the 56 warnings from the previous push were hard failures. Root cause: two escaping bugs introduced across the large tkinter.po translation batch. 1. A role/literal close (`` ` `` or ``` `` ```) directly followed by a full-width （ with no `\ ` separator confuses docutils' inline markup boundary detection, which can silently swallow or merge adjacent role references in the same paragraph -- surfacing as Sphinx's i18n.inconsistent_references warnings (dropped or merged :class:/ :meth:/:attr:/:term: references) in tkinter.po, tkinter.ttk.po, http.cookiejar.po, and c-api/unicode.po. 2. The same applies to *emphasis*（ with no space/separator before the parenthesis, which docutils reports as "Inline emphasis start-string without end-string" since the closing `*` isn't followed by a recognized boundary character. Fixed by adding the space that's already the established convention elsewhere in this file. Also fixes a review comment on PR python#1239: removes a stray literal space that rendered as a visible gap between adjacent Chinese text and a role's Chinese display text in c-api/dict.po. Co-authored-by: Claude <noreply@anthropic.com>

1 parent 70eb6f8 commit a99f0d0
Copy full SHA for a99f0d0

6 files changed

+110-108Lines changed: 110 additions & 108 deletions

File tree

Expand file treeCollapse file tree

Open diff view settings

Filter options

• c-api
  • dict.po
  • unicode.po
• library
  • dialog.po
  • http.cookiejar.po
  • tkinter.po
  • tkinter.ttk.po

Expand file treeCollapse file tree

Open diff view settings

Collapse file

‎c-api/dict.po‎

Copy file name to clipboardExpand all lines: c-api/dict.po

+1-1Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
@@ -110,7 +110,7 @@ msgid ""
110	110	"on success or ``-1`` on failure. This function *does not* \":term:`steal`\" "
111	111	"a reference to *val*."
112	112	msgstr ""
113		- "以 *key* 為鍵，將 *val* 插入至字典 *p* 中。*key* 必須是 :term:`可雜湊的 "
	113	+ "以 *key* 為鍵，將 *val* 插入至字典 *p* 中。*key* 必須是\\ :term:`可雜湊的 "
114	114	"<hashable>`，否則將引發 :exc:`TypeError`。成功時回傳 ``0``，失敗時回傳 "
115	115	"``-1``。此函式\\ *不會*\\ 「:term:`竊取 <steal>`」對 *val* 的參照。"
116	116

Collapse file

‎c-api/unicode.po‎

Copy file name to clipboardExpand all lines: c-api/unicode.po

+2-2Lines changed: 2 additions & 2 deletions

Original file line number	Diff line number	Diff line change
@@ -926,8 +926,8 @@ msgid ""
926	926	"releases (\":term:`steals <steal>`\") this reference."
927	927	msgstr ""
928	928	"將字串 *right* 附加到 *p_left* 的結尾。*p_left* 必須指向一個 Unicode 物件的 :"
929		- "term:`強參照 <strong reference>`；:c:func:`!PyUnicode_Append` 會釋放（「竊"
930		- "取」）此參照。"
	929	+ "term:`強參照 <strong reference>`；:c:func:`!PyUnicode_Append` 會釋放（「:"
	930	+ "term:`竊取 <steal>`」）此參照。"
931	931
932	932	#: ../../c-api/unicode.rst:669
933	933	msgid "On error, set *\\*p_left* to ``NULL`` and set an exception."

Collapse file

‎library/dialog.po‎

Copy file name to clipboardExpand all lines: library/dialog.po

+4-4Lines changed: 4 additions & 4 deletions

Original file line number	Diff line number	Diff line change
@@ -416,10 +416,10 @@ msgid ""
416	416	"num` attribute holds the index of the button the user pressed."
417	417	msgstr ""
418	418	"顯示一個由傳統（非主題化）Tk 元件建立的互動 (modal) 對話框，並等待使用者按下"
419		- "其中一個按鈕。透過 *cnf* 或關鍵字引數提供的選項包括：*title*（視窗標題）、"
420		- "*text*（訊息內容）、*bitmap*（圖示，預設為 :data:`DIALOG_ICON`）、*default*"
421		- "（預設按鈕的索引）和 *strings*（按鈕標籤的序列）。建構完成後，:attr:`!num` 屬"
422		- "性會保存使用者按下之按鈕的索引。"
	419	+ "其中一個按鈕。透過 *cnf* 或關鍵字引數提供的選項包括：*title* （視窗標題）、"
	420	+ "*text* （訊息內容）、*bitmap* （圖示，預設為 :data:`DIALOG_ICON`）、"
	421	+ "*default* （預設按鈕的索引）和 *strings* （按鈕標籤的序列）。建構完成後，:"
	422	+ "attr:`!num` 屬性會保存使用者按下之按鈕的索引。"
423	423
424	424	#: ../../library/dialog.rst:327
425	425	msgid ""

Collapse file

‎library/http.cookiejar.po‎

Copy file name to clipboardExpand all lines: library/http.cookiejar.po

+3-3Lines changed: 3 additions & 3 deletions

Original file line number	Diff line number	Diff line change
@@ -463,9 +463,9 @@ msgid ""
463	463	"filename <FileCookieJar.filename>` is ``None``, :exc:`ValueError` is raised."
464	464	msgstr ""
465	465	"*filename* 是用來儲存 cookies 的檔案名稱。如果未指定 *filename*，則會使用 :"
466		- "attr:`self.filename <FileCookieJar.filename>`（其預設值為傳給建構函式的值，如"
467		- "果有的話）；如果 :attr:`self.filename <FileCookieJar.filename>` 為 ``None``，"
468		- "則會引發 :exc:`ValueError`。"
	466	+ "attr:`self.filename <FileCookieJar.filename>`\\ （其預設值為傳給建構函式的"
	467	+ "值，如果有的話）；如果 :attr:`self.filename <FileCookieJar.filename>` 為 "
	468	+ "``None``，則會引發 :exc:`ValueError`。"
469	469
470	470	#: ../../library/http.cookiejar.rst:277
471	471	msgid ""

0 commit comments

Comments

0 (0)