Skip to content

docs(zh): translate remaining English page titles - #1238

Merged
bengbengbalabalabeng merged 1 commit into
apache:mainfrom
GOODBOY008:docs-zh/page-titles
Oct 19, 2026
Merged

bengbengbalabalabeng merged 1 commit into
apache:mainfrom
GOODBOY008:docs-zh/page-titles

Conversation

@GOODBOY008

Copy link
Copy Markdown
Member

Problem

Three Chinese pages still carry an English title in their frontmatter, even though the body heading is already translated:

File title # heading
sheet/read/csv.md CSV # 读取 CSV 文件
sheet/write/csv.md CSV # 写入 CSV 文件
sheet/read/sheet.md Sheet # Sheet 页

The frontmatter title feeds both the page <title> and the sidebar label (the sidebar references these docs by id, without an explicit label), so the Chinese navigation currently shows CSV / CSV / Sheet next to fully translated pages.

Change

Align title with the existing heading:

  • read/csv.md: CSV → 读取 CSV 文件
  • write/csv.md: CSV → 写入 CSV 文件
  • read/sheet.md: Sheet → Sheet 页

Sheet is deliberately kept untranslated: it is the established term in the Chinese docs (412 occurrences, against 6 for 工作表), and the heading already reads Sheet 页. Translating it to 工作表 here would make the title inconsistent with the rest of the site. Only the missing Chinese is added.

Verification

No English-only titles left under website/i18n/zh-cn/.../current:

$ grep -rn "^title:" website/i18n/zh-cn/docusaurus-plugin-content-docs/current --include="*.md" \
    | grep -viE "[一-龥]"
(no output)

And title now equals the H1 for all three pages:

sheet/read/csv.md    title='读取 CSV 文件'  h1='读取 CSV 文件'  match=True
sheet/write/csv.md   title='写入 CSV 文件'  h1='写入 CSV 文件'  match=True
sheet/read/sheet.md  title='Sheet 页'       h1='Sheet 页'       match=True

Risk

None. Frontmatter only — no body content changes. The visible effect is that these three entries in the Chinese sidebar switch from English to Chinese.

Three Chinese pages still had an English title in their frontmatter
while the body heading was already translated:

  read/csv.md    CSV   -> 读取 CSV 文件
  write/csv.md   CSV   -> 写入 CSV 文件
  read/sheet.md  Sheet -> Sheet 页

The title feeds both the page <title> and the sidebar label, so the
Chinese site showed English entries in the navigation.

"Sheet" is kept as-is: it is the established term in the Chinese docs
(412 occurrences, versus 6 for 工作表), and the heading already reads
"Sheet 页". Only the missing translation is added.
Copilot AI balanced review requested due to automatic review settings October 19, 2026 05:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@bengbengbalabalabeng bengbengbalabalabeng left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM.

@bengbengbalabalabeng
bengbengbalabalabeng merged commit 567b67d into apache:main Oct 19, 2026
5 checks passed
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