mirror of
https://github.com/storytold/craft-anything.git
synced 2026-11-05 20:47:45 +01:00
才倾梦华V
d55523e6cd
Adds Simplified and Traditional Chinese UI catalogs, picks the UI language from the system when Language is System, makes prices and a few labels translatable, recognises Chinese words for games and websites in requests, and adds cargo xtask i18n-coverage and docs/localization.md.
65 lines
3.1 KiB
Markdown
65 lines
3.1 KiB
Markdown
# Chinese UI localisation
|
|
|
|
The desktop app offers **简体中文** (`zh-hans`) and **繁體中文** (`zh-hant`),
|
|
alongside English, French and Japanese, in **Settings → General → Language**. The choice is saved in the
|
|
existing `language` setting. **System** uses the operating system's preferred
|
|
supported language; if none matches, it uses English. An explicit choice takes
|
|
precedence over the system language.
|
|
|
|
Chinese locales without a script, including `zh`, `zh-CN` and `zh-SG`, select
|
|
Simplified Chinese. `zh-TW`, `zh-HK` and `zh-MO` select Traditional Chinese.
|
|
An explicit `Hans` or `Hant` script takes precedence over the region. Locale
|
|
matching accepts underscores, case differences and Unix encoding suffixes.
|
|
|
|
## Scope and format
|
|
|
|
`crates/ui-egui/src/i18n/zh-hans.tsv` and `zh-hant.tsv` contain original
|
|
translations under the repository's MIT OR Apache-2.0 licence. Each UTF-8 line
|
|
has two columns: `English source<TAB>translation`. Comments begin with `#`;
|
|
`\n` represents a newline. The language registry in `i18n.rs` embeds the catalogs.
|
|
|
|
The catalogs cover first run, new projects, project controls, Settings, the
|
|
workbench, tool titles, tool groups, target descriptions, tooltips and
|
|
accessibility labels. The command palette searches translated tool titles as
|
|
well as English titles and stable tool IDs. Missing translations fall back to
|
|
the original English text. Product and technology names retain their spelling.
|
|
|
|
User text, AI responses, evidence and raw tool results, tool summaries and schema
|
|
descriptions, logs and exported reports retain their original text. The CLI,
|
|
MCP, tool IDs, stored project data and the separate browser viewer are unchanged.
|
|
|
|
Keep placeholders such as `{name}` and `{n}` intact, along with command IDs,
|
|
shortcuts, escapes and trailing `…`. Update both Chinese catalogs when English
|
|
source keys change. Common terms include 净室 / 淨室 (Clean room), 深度 (Deep),
|
|
构建 / 建置 (Build), 证据 / 證據 (Evidence), and 项目 / 專案 (Project).
|
|
|
|
## Validation
|
|
|
|
Run:
|
|
|
|
```sh
|
|
cargo test -p craft-anything-ui-egui
|
|
cargo test -p xtask
|
|
cargo clippy -p craft-anything-ui-egui -p xtask --all-targets -- -D warnings
|
|
cargo xtask i18n-coverage
|
|
```
|
|
|
|
Catalog tests check duplicate and empty entries, matching key sets, placeholders
|
|
and ellipses. The coverage command checks literal translation calls, common
|
|
widget labels and registered engine tool titles and groups; it also runs in
|
|
`cargo xtask ci`. It does not prove coverage of arbitrary runtime text or labels
|
|
held in tables, so review those when adding or changing UI code.
|
|
|
|
The existing snapshot example accepts `--lang zh-hans` or
|
|
`--lang zh-hant`, for example:
|
|
|
|
```sh
|
|
cargo run -p craft-anything-ui-egui --example snapshot -- --lang zh-hant --only settings --out-dir target/snapshots/zh-hant
|
|
```
|
|
|
|
Chinese glyphs use the existing craft-fonts fallback, which release and CI builds
|
|
already include. Local builds must set `CRAFT_FONTS_DIR` to a craft-fonts checkout
|
|
before compiling to get the same glyph coverage. The catalogs add no font assets.
|
|
Check both scripts, clipping, narrow windows and native file dialogs visually
|
|
on each platform; catalog coverage alone does not verify layout or fonts.
|