本地化

​

两种目录

​

源文本

<Button>Retry Loading Conversation</Button>;
registerAction({ id: "project.trust", title: "Trust Project", category: "Project", run });
notifications().notify({ title: "Plugin update available", body: names });

tx`Cannot open ${path}`; // 查找 "Cannot open {path}"

"Cannot open {path}": "无法打开 {path}"

​

消息

t("app.unsaved.body", { count: 3, project: "openidea" });

• {name} 参数（数字按语言区域格式化）；
• {n, plural, =0 {none} one {# file} other {# files}}；
• {g, select, a {…} other {…}}；
• {n, number}。

​

规则

• 每条新字符串都要同时加到 en 和 zh。 源文本对应 text/en.json（英文映射到自身）和 text/zh.json；消息键对应 en.json 和 zh.json。
• 改写措辞会丢掉翻译。 源文本的键就是英文原文，所以在调用处改了措辞，也要同步更新目录条目。
• 删掉不再使用的条目。 如果某条目录条目的文本在 src/、Rust crate 或 languages/ 中都找不到了，测试会失败。
• 整句翻译。 不要把英文单词拼进译文（${kind.toLowerCase()}、${n === 1 ? "" : "s"}）；每种变体写一条文本，或者用复数消息。
• 精确查找时不要用未加标签的模板字符串：`Cannot open ${path}` 永远无法被翻译，请用 tx 标签。
• 后端文本（错误消息等）只要字面量出现在源码中就算被使用；和其他文本一样补上翻译。
• 中文术语：同一概念沿用 text/zh.json 和 zh.json 中已有的译法，不要让一个英文术语出现两种译名。

​

测试

pnpm vitest run src/platform/locales

​

插件