i18n(zh-tw): add Traditional Chinese translations 2026-05-11 by leaanthony · Pull Request #5390 · wailsapp/wails

leaanthony · 2026-05-10T16:07:41Z

Automated translation run via Wails Doc Translator agent — 2026-05-11.

QA Scores

Locale	Avg Score	Files	Low Quality
zh-tw	0.868	107	10 ⚠

Files Flagged for Human Review (score < 0.75)

All flagged files scored 0.650 due to code block count mismatches and import count mismatches:

features/bindings/methods.mdx — Code block count mismatch (src=29, tgt=23), Import count mismatch (src=9, tgt=7)
features/bindings/models.mdx — Code block count mismatch (src=34, tgt=25), Import count mismatch (src=14, tgt=10)
features/bindings/services.mdx — Code block count mismatch (src=23, tgt=22), Import count mismatch (src=2, tgt=1)
features/events/system.mdx — Code block count mismatch (src=30, tgt=23), Import count mismatch (src=8, tgt=6)
features/menus/systray.mdx — Code block count mismatch (src=21, tgt=13), Import count mismatch (src=4, tgt=3)
features/windows/multiple.mdx — Code block count mismatch (src=24, tgt=23), Import count mismatch (src=3, tgt=2)
guides/events-reference.mdx — Code block count mismatch (src=20, tgt=15), Import count mismatch (src=19, tgt=15)
reference/events.mdx — Code block count mismatch (src=35, tgt=33), Import count mismatch (src=22, tgt=21)
reference/window.mdx — Code block count mismatch (src=60, tgt=42), Import count mismatch (src=5, tgt=3)
tutorials/01-creating-a-service.mdx — Code block count mismatch (src=15, tgt=16), Import count mismatch (src=3, tgt=6)

Locales: zh-tw
Files: 102 new translations

CC @leaanthony

Summary by CodeRabbit

Documentation
- Added comprehensive Traditional Chinese (zh-tw) localization for Wails v3 documentation, including getting started guides, concepts, features, build instructions, and contribution guidelines
- New Chinese documentation covers bindings, browser integration, dialogs, menus, notifications, windows management, and more

Copilot

Copilot wasn't able to review this pull request because it exceeds the maximum number of lines (20,000). Try reducing the number of changed lines and requesting a review from Copilot again.

coderabbitai · 2026-05-10T16:09:59Z

Walkthrough

This PR adds comprehensive Traditional Chinese (繁體中文) localization for Wails v3 documentation, comprising approximately 130 new and updated markdown/MDX files and translation cache metadata. The changes span foundational architecture concepts, feature documentation, developer guides, and community resources, establishing complete zh-tw documentation parity with English content.

Changes

Wails v3 Traditional Chinese Documentation Localization

Layer / File(s)	Summary
Translation Registry `docs/.translation-cache/zh-tw.json`	Updates `translated_at` timestamps across all zh-tw entries while preserving content hashes; no structural schema changes.
Community Resources `docs/src/content/docs/zh-tw/community/links.md`, `community/templates.md`	New community links page (Discord, GitHub, Twitter, QQ group) and templates page listing Vue, React, Angular, Svelte, Solid, Elm, HTMX, and web component templates.
Core Concepts `docs/src/content/docs/zh-tw/concepts/*`	Architecture overview, Bridge mechanism with Bindings/Router/Encoder/Decoder, native WebView differences, Service system with TypeScript binding generation, Event pub/sub, Application lifecycle, Manager API, and Build system.
Data & Method Binding `docs/src/content/docs/zh-tw/features/bindings/*`	Method binding, data models, services (basic/stateful/dependent), enums, advanced directives (inject/include/ignore), and best practices (API design, batching, caching, streaming, security).
UI Features `docs/src/content/docs/zh-tw/features/{browser,clipboard,dialogs,drag-and-drop,environment,events,keyboard,menus,notifications}/*`	Browser integration, clipboard operations, dialog boxes (message/file/custom), drag-and-drop (files and HTML5), environment detection, event system, keyboard shortcuts, menus (application/context/tray), and notifications.
Window Management `docs/src/content/docs/zh-tw/features/windows/*`, `platform/dock.mdx`, `screens/info.mdx`	Window basics, events, frameless windows, multiple windows, options reference, platform-specific features (Dock, screen detection/positioning).
Contributing Setup `docs/src/content/docs/zh-tw/contributing.mdx`, `getting-started.mdx`, `setup.mdx`, `standards.mdx`	Contributing overview, prerequisites (Go/Node), bug fix/feature/docs workflows, environment setup, IDE configuration, coding standards (Go/TypeScript/Commits/PRs), code review process.
Technical Internals `docs/src/content/docs/zh-tw/contributing/{architecture,bindings,asset-server,binding-system,build-packaging,codebase-layout,extending-wails,runtime-internals,template-system,testing-ci}.mdx`	Codebase structure, runtime internals (windows, messaging, events, platform-specific), bindings generator (analysis/code-gen/execution), asset server (dev/production), build pipeline, template system, extension patterns, testing/CI strategy.
Support & Getting Started `docs/src/content/docs/zh-tw/{faq,credits,feedback,getting-started/your-first-app}.mdx`, `guides/*`	FAQ (basics, Electron comparison, development, building, features, performance, troubleshooting, migration), credits with contributors/sponsors, first app walkthrough, architecture patterns (service layer, repository, event-driven, DI, state management), build guides.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

wailsapp/wails#5350: Directly related—main PR updating same Traditional Chinese docs files and translation cache
wailsapp/wails#5347: Related—enables zh-TW locale in Astro/Starlight configuration for translation discovery
wailsapp/wails#5324: Related—concurrent zh-tw documentation updates with translation cache metadata

Suggested labels

Documentation, size:XL

Poem

🐰 A rabbit hops through chapters vast,
Translating knowledge, building fast—
From Bridge to Binding, Window's cheer,
Traditional Chinese, crystal clear!
Zh-tw docs now complete, we say:
Happy contributing, every day! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch i18n/zh-tw-2026-05-11

⚔️ Resolve merge conflicts

Resolve merge conflict in branch i18n/zh-tw-2026-05-11

coderabbitai

Actionable comments posted: 15

Note

Due to the large number of review comments, Critical severity comments were prioritized as inline comments.

🟠 Major comments (19)

docs/src/content/docs/zh-tw/contributing/template-system.mdx-158-159 (1)

158-159: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Replace the en dash with a real CLI flag (--help).

go run ./v3/cmd/wails3 –help uses – instead of --, so the command won’t parse correctly in shells.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/contributing/template-system.mdx` around lines
158 - 159, The CLI example string "go run ./v3/cmd/wails3 –help" uses an en dash
instead of the standard double hyphen flag; update the text so the command reads
"go run ./v3/cmd/wails3 --help" (replace the single en dash character with two
ASCII hyphens) so shells parse the --help flag correctly.

docs/src/content/docs/zh-tw/contributing/getting-started.mdx-68-73 (1)

68-73: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Revert translated content inside fenced code blocks to the English original.

This file localizes text inside multiple fenced code examples; in this repo’s i18n policy, code-fence contents should remain unchanged from source.

Based on learnings: Wails translation PRs must not translate any text inside fenced code blocks, shell commands, or embedded code content.

Also applies to: 77-83, 97-100, 105-113, 127-129, 160-165, 170-175, 223-231, 321-327
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/contributing/getting-started.mdx` around lines 68
- 73, Revert any translated text inside fenced code blocks back to the English
source; specifically replace the localized shell/code snippets (for example the
block containing "git clone https://github.com/YOUR_USERNAME/wails.git", "cd
wails", "git remote add upstream https://github.com/wailsapp/wails.git") with
the original English commands and do the same for the other fenced blocks
referenced (lines around 77-83, 97-100, 105-113, 127-129, 160-165, 170-175,
223-231, 321-327) so that all code fences, shell commands and embedded code
remain exactly as in the upstream English source.

docs/src/content/docs/zh-tw/feedback.mdx-19-19 (1)

19-19: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Use the v3 CLI command form: wails3 doctor.

wails doctor is incorrect for v3 docs and will mislead users running environment diagnostics.

Based on learnings: Wails v3 documentation should use the wails3 prefix (e.g., wails3 doctor), and occurrences of wails doctor should be treated as source-doc bugs.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/feedback.mdx` at line 19, Update the
documentation to use the v3 CLI command form by replacing all occurrences of
"wails doctor" with "wails3 doctor" in the feedback.mdx content; ensure any
inline code, command examples, and explanatory text (the string "wails doctor")
are updated to "wails3 doctor" so the doc reflects Wails v3 CLI usage
accurately.

docs/src/content/docs/zh-tw/contributing/index.mdx-80-80 (1)

80-80: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Use wails3 init in v3 docs.

The template command is shown as wails init -t <framework>; for v3 it should be wails3 init -t <framework>.

Based on learnings: In Wails v3 documentation, CLI commands should use the wails3 prefix.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/contributing/index.mdx` at line 80, Update the
template command text to use the v3 CLI prefix: replace the string "wails init
-t <framework>" with "wails3 init -t <framework>" in the docs content (the table
cell showing "**範本系統** | 驅動 `wails init -t <framework>` 的生成器架構。"); ensure the
displayed inline code uses `wails3 init -t <framework>` so v3 docs consistently
reference the new CLI.

docs/src/content/docs/zh-tw/contributing/template-system.mdx-22-33 (1)

22-33: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Keep fenced code blocks identical to the English source.

These code blocks include translated natural-language content (comments/labels). In this repo’s i18n workflow, code-block contents must remain unchanged from English to avoid drift and copy/paste breakage.

Based on learnings: For Wails documentation i18n/translation PRs, do not translate any text inside code blocks in MDX files; code block contents must remain exactly in their original English form.

Also applies to: 108-117, 133-145
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/contributing/template-system.mdx` around lines 22
- 33, The fenced code block showing the template tree was translated into
Chinese — restore the entire code-block contents to match the English original
exactly (keep entries like "v3/", "internal/templates/", "_common/", "base/",
"react/", "react-ts/", "svelte/", "vue/", and "templates.go" and revert the
translated comments back to their original English phrases such as the comment
for _common (Files copied into each project (main.go, .gitignore)), the comment
for base (pure Go backend templates) and any other English labels); do the same
for the other affected code fences mentioned (the blocks containing the same
template entries earlier) so no text inside fenced code blocks is translated.

docs/src/content/docs/zh-tw/contributing/getting-started.mdx-333-337 (1)

333-337: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Fix malformed code-fence termination around the PR section.

The closing is immediately followed by prose on the same line (`在您的拉取請求中：`), which can break MDX rendering for the rest of the block/section.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/contributing/getting-started.mdx` around lines
333 - 337, The MDX block has a malformed code-fence where the closing backticks
are followed immediately by prose (`在您的拉取請求中：`), breaking rendering; fix it by
placing the closing ``` on its own line and moving the subsequent prose
(`在您的拉取請求中：` and the bullet list) outside/after the fenced block so the code
fence properly terminates (look for the fenced block around the PR section in
getting-started.mdx and adjust the closing fence and the "在您的拉取請求中：" content
accordingly).

docs/src/content/docs/zh-tw/contributing/setup.mdx-15-25 (1)

15-25: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Do not localize fenced code block contents.

Several code fences contain translated in-block text/comments. For Wails locale docs, fenced code must stay byte-for-byte aligned with the English source.

Based on learnings: In Wails i18n MDX, text inside fenced code blocks must not be translated and should remain exactly as the English original.

Also applies to: 37-41, 84-94, 159-175, 212-223
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/src/content/docs/zh-tw/contributing/setup.mdx` around lines 15 - 25,
Restore the original English content inside the fenced code blocks (the
triple-backtick bash blocks containing "go version  # verify installation" and
the shell export lines "export GOPATH=$HOME/go" / "export
PATH=$PATH:$GOPATH/bin") so that the code fences remain byte-for-byte identical
to the English source; do the same for the other fenced blocks referenced (lines
37-41, 84-94, 159-175, 212-223) by reverting any translated in-block
text/comments back to the exact English strings used in the canonical docs,
preserving punctuation and spacing.

docs/src/content/docs/zh-tw/contributing/standards.mdx-439-443 (1)

439-443: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Correct the build-tag example; current snippet is invalid Go syntax.

//go:build darwin套件 application is malformed. It should show a valid build tag and package declaration on separate lines.

Proposed correction

 ```go
-//go:build darwin套件 application
+//go:build darwin
+package application
 
 // macOS-specific code

</details>

Based on learnings: In Wails i18n docs, code blocks should not be translated; this appears to be a translated/corrupted code sample.

<details>
<summary>🤖 Prompt for AI Agents</summary>