Skip to content

docs(zh-CN): add missing book chapters (tui, mcp, debugging, coming_from_powershell) - #2274

Merged
fdncred merged 1 commit into
nushell:mainfrom
passionworkeer:docs-zh-cn-mcp
Oct 29, 2026
Merged

fdncred merged 1 commit into
nushell:mainfrom
passionworkeer:docs-zh-cn-mcp

Conversation

@passionworkeer

@passionworkeer passionworkeer commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Motivation

I've been using Nushell heavily over the past few weeks and recently started contributing to the project itself (nushell/nushell#19309, nushell/nushell#19348, both dc-glob fixes). While reading through the book I found that the zh-CN translation was missing its newest chapters — tui, mcp, debugging, and coming_from_powershell — so I translated them to bring the Chinese book back to parity with the English one. With this PR every page in the English book has a zh-CN counterpart (66/66).

What this PR changes

  • New translations:
    • zh-CN/book/tui.md (from ff1c478)
    • zh-CN/book/mcp.md (from ff1c478)
    • zh-CN/book/debugging.md (from ff1c478)
    • zh-CN/book/coming_from_powershell.md (from e9317a8)
  • Registers the four files in tools/i18n-meta.json with their base commits
  • Adds the four sidebar entries at the same positions as the English sidebar
  • Adds the cross-references the English book has: tui/mcp links in advanced.md, and $nu.is-mcp/$nu.is-dap links in special_variables.md

Translation notes

  • Terminology follows the existing 60+ zh-CN pages (管道, 闭包, 记录, 表格, 数据流, …), and widget is rendered as 部件.
  • hook is kept in English on the TUI pages: there it is a TUI-specific concept (a closure that reacts to the user), distinct from the config hooks translated as 钩子 in hooks.md. Happy to switch if reviewers prefer 钩子 here as well.
  • The coming_from_powershell page uses the same title pattern (从 PowerShell 到 Nu) and table header (任务) as the existing coming_from_bash/coming_from_cmd pages.

Verification

  • npm run build passes with no new broken-link warnings (the 8 existing warnings are in other files and unchanged)
  • Every code block is identical to the English source apart from translated comments
  • Intra-page anchors were checked against the generated heading ids (one anchor mismatch found during self-review was fixed before submitting)

Translation status tracking: #261

Copilot AI balanced review requested due to automatic review settings October 29, 2026 14:53

Copilot AI left a comment

Copy link
Copy Markdown

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 insufficient remaining quota.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

…rom_powershell)

Translate the four book chapters that had no zh-CN version, bringing the
zh-CN book to page parity with the English one (66/66):

- zh-CN/book/tui.md, translated from ff1c478
- zh-CN/book/mcp.md, translated from ff1c478
- zh-CN/book/debugging.md, translated from ff1c478
- zh-CN/book/coming_from_powershell.md, translated from e9317a8

Also registers the four files in tools/i18n-meta.json, adds the sidebar
entries at the same positions as the English sidebar, and adds the
cross-references the English book has (tui/mcp links in advanced.md,
$nu.is-mcp/$nu.is-dap links in special_variables.md).

The pages were self-reviewed against the English source before submission:
all code blocks are identical apart from translated comments, terminology
follows the existing zh-CN pages, and every intra-page anchor was checked
against the generated heading ids.
@fdncred
fdncred merged commit 6fe9e3e into nushell:main Oct 29, 2026
@fdncred

fdncred commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

Thanks

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