mirror of
https://github.com/storytold/photocraft.git
synced 2026-10-26 02:47:07 -06:00
b45dfde498
* i18n: complete Simplified Chinese UI catalog and brush labels * i18n(zh-hans): translate labels added on main since this PR (opening/cancel, layer navigation) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * i18n(zh-hans): keep main's Mixer Brush entries, translate the rendering-mode strings added since (#434) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Brandon Thomas <echelon@gmail.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
80 lines
4.0 KiB
Markdown
80 lines
4.0 KiB
Markdown
# Simplified Chinese catalog
|
|
|
|
The `zh-hans` catalog is registered as **简体中文** in the shared i18n foundation
|
|
introduced by [PhotoCraft PR #169](https://github.com/storytold/photocraft/pull/169).
|
|
Simplified Chinese support landed in
|
|
[PR #282](https://github.com/storytold/photocraft/pull/282), after the v0.2.0 release.
|
|
That release does not contain the language selector or this catalog; use a build
|
|
that includes the localisation changes.
|
|
|
|
The Chinese wording is original and uses ordinary image-editing terminology;
|
|
no proprietary translation resources were extracted or copied. Contributions
|
|
use the repository's MIT OR Apache-2.0 license.
|
|
|
|
## Selecting Simplified Chinese
|
|
|
|
Select **Preferences > Interface > Language > 简体中文**, or set
|
|
`interface.language` to `zh-hans` through the existing `prefs.set` command.
|
|
The native build's **Auto** setting reads `LANG`/`LC_*`, the macOS preferred
|
|
languages and the Windows user locale. `zh`, `zh-CN`, `zh-SG` and `zh-Hans`
|
|
variants resolve to this catalog. Traditional Chinese locales (`zh-TW`, `zh-HK`,
|
|
`zh-MO`, `zh-Hant`) resolve to the separate `zh-hant` catalog.
|
|
|
|
The web build does not detect the browser language automatically; choose the
|
|
language manually there.
|
|
|
|
## Files and integration
|
|
|
|
- `crates/ui-egui/src/i18n/zh-hans.tsv` contains the translations, independent of
|
|
the lookup implementation. Its UTF-8 columns are `context<TAB>source<TAB>translation`.
|
|
- `crates/ui-egui/src/i18n/mod.rs` registers `zh-hans` with one plural form and
|
|
`complete_menus: true`. Shared tests enforce coverage of every menu string,
|
|
`tl!` literal, blend mode, brush section and generated preference label.
|
|
- Shortcut templates retain `{key}` so the shell supplies the correct key for
|
|
the current platform. Layer-count messages use one Chinese plural form.
|
|
|
|
Keep English source keys, contexts, command IDs, placeholders and escapes intact.
|
|
Retain the trailing `…` on commands that open a dialog. Missing translations use
|
|
the framework's English fallback. User-supplied names and document data are not
|
|
translated. Product names and technology names such as PhotoCraft, ArtCraft,
|
|
OpenType, RGB, CMYK and Lab retain their spelling. Status messages, errors and
|
|
automation output remain English as described in [UI design](ui-design.md#localisation);
|
|
complete catalog coverage does not claim those strings are translated.
|
|
|
|
## Terminology
|
|
|
|
| English | Simplified Chinese |
|
|
| --- | --- |
|
|
| Layer / Layer Comp | 图层 / 图层复合 |
|
|
| Mask / Clipping Mask | 蒙版 / 剪贴蒙版 |
|
|
| Selection / Feather | 选区 / 羽化 |
|
|
| Blend Mode / Opacity | 混合模式 / 不透明度 |
|
|
| Adjustment Layer | 调整图层 |
|
|
| Smart Object / Smart Filter | 智能对象 / 智能滤镜 |
|
|
| Canvas / Artboard | 画布 / 画板 |
|
|
| Brush / Stroke | 画笔 / 描边 |
|
|
| Fill / Gradient | 填充 / 渐变 |
|
|
| Path / Rasterize | 路径 / 栅格化 |
|
|
| Preset / Swatch | 预设 / 色板 |
|
|
| Export / Preferences | 导出 / 首选项 |
|
|
|
|
## Validation and maintenance
|
|
|
|
Run `cargo test -p photocraft-ui-egui`, the touched-crate all-target clippy check,
|
|
`cargo xtask layers` and `cargo xtask wasm`. The shared catalog tests validate
|
|
duplicate keys, placeholders, ellipses, menu coverage, `tl!` literals, brush
|
|
sections and blend modes. Chinese-specific tests cover locale selection, fallback,
|
|
plural messages, formatted labels and the painted brush section rows and heading. Render and inspect the menus, Preferences and representative
|
|
dialogs with the existing offscreen `snapshot` example.
|
|
|
|
Font delivery is separate from the translation data. The catalog adds no font
|
|
assets; the shell's CJK fallback loads fonts separately. Verify missing glyphs,
|
|
label layout and platform-specific shortcuts visually on each target platform,
|
|
and verify web glyph coverage separately.
|
|
|
|
When English labels change, update their source keys and translations together,
|
|
preserving contexts and placeholders. The complete-catalog tests catch missing
|
|
keys, and the Simplified Chinese regression test checks dynamic shortcut labels,
|
|
layer counts and English fallback. Review changed source meanings against the
|
|
current English UI.
|