mirror of
https://github.com/storytold/lightcraft.git
synced 2026-11-09 09:59:52 -06:00
Andrew FrahnandClaude Opus 5.5
6cbc0eb5a9
- brand.toml is the only place the product name lives; every crate and app
reads it through dac-brand (env vars with legacy fallback, settings folder
with copy-only migration, default library, preset extensions, i18n {app})
- cargo xtask brand check|test, run|install|package, docs, rename-crates,
deny and immich; packaging files are templates rendered from brand.toml
- icons regenerated from brand/icon.svg; upstream branding removed
- MIT licence (segment and fetch stay Apache-2.0); cargo deny licence policy
- clean-room rules in AGENTS.md/CLAUDE.md; docs/upstream-merge.md
- plan/ rebuilt and committed; parity tracker reopens Classic rows, adds
PLAN.md section 2 rows and the IMM Immich section; plan/immich.md and a
pinned Immich test server
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
3.1 KiB
3.1 KiB
简体中文界面
<PREFIX>,<cli>,<binary>:brand.toml.
本应用的界面支持英语、简体中文、繁体中文（台湾）和日语。语言设置保存在 ui.json 的 language 字段中。
- 通过「编辑 → 语言」或「设置 → 一般 → 语言」切换，选择会保留到下次启动。
- 已翻译的范围与
zh-hant.json键集完全一致（1246 条），两份目录的键与键序一一对应。 - 正文字重与半粗体都使用 SIL OFL 的 Noto Sans CJK SC（简体中文）与 BIZ UDPGothic（日语）。
这些字体不在本仓库，而在 storytold/craft-fonts；
使用可选的构建输入
CRAFT_FONTS_DIR=../craft-fonts时（所有正式发布版）会内嵌进来。 不指定该输入时程序照常构建运行，但中文与日文文字没有字形，会显示为方框 —— 语言菜单里四种语言仍然都在，选中「简体中文」也只会得到一屏方框。未内嵌字体时构建会打印一条cargo::warning提示这一点。 - 翻译只发生在显示层：命令 ID、照片文件名、用户输入的元数据都不做改动。
- 尚未翻译的技术性错误、补充说明和发行说明仍以英文显示。
- 网页版将 Noto Sans CJK SC 作为独立的
<binary>_zh_hans.otf文件随站点分发，页面启动时加载； 这样可显示简体中文，也避免把约 16 MB 字体放进受单文件大小限制的 WASM。部署时需上传整个target/web/目录。未指定CRAFT_FONTS_DIR的开发构建仍缺少中文字体。 - 日期分组标题与拍摄时间按中文格式显示（如
2026年9月20日 星期日）。
翻译的维护
静态界面文字在 crates/ui-egui/locales/zh-hans.json，含运行时数值的文字在
crates/ui-egui/locales/zh-hans-formats.json。两者都以英文原文为键。
含数值的文字遵循以下约定：
- 每个译文都是普通的 Rust 格式字符串，构建时由
format!对照调用点的参数检查（占位符写错会编译失败）。 - 按名字：
{n}、{label}、{total}等与英文原文中的名字一致。 - 按位置：
{0}、{1}… 对应调用点无名参数的先后顺序（从 0 开始），用于调整语序， 例如Added {n} photo{} to “{}”译为已将 {n} 张照片添加到“{1}”{0:.0}。 - 保留英文原文的格式说明（
{:.1}、{d:+}、{:.0}%）。 - 品牌占位符：产品名称不写进译文，使用
{app}（brand.toml中的显示名称）、{cli}（命令行程序名）和{env}（环境变量前缀），译文中原样保留，例如About {app}译为关于 {app}。 format!不允许未使用的参数：英文用来表示单复数的那个参数（"s"/""）在中文里写成{:.0}（精度为 0 的字符串不输出任何内容）。
<PREFIX>_LANGUAGE=zh-hans <cli> snapshot ... 可以渲染中文界面用于检查。
翻译是否完整、两种目录的键与占位符是否一致、字形是否齐全，都由
cargo test -p dac-ui-egui i18n::tests 验证（字形检查只在指定 CRAFT_FONTS_DIR 时实际执行）。