HitKeep 国际化 是做什么的?
当修改用户可见的仪表盘文本或本地化格式时,使用此技能。
HitKeep 的仪表盘使用 Transloco JSON 文件管理 UI 文案,并利用 @jsverse/transloco-locale 和浏览器 Intl API 实现区域感知格式化。PrimeNG 组件标签会与当前 Transloco 语言同步更新。
公共界面
仪表盘翻译文件位于:
frontend/dashboard/public/i18n/en.jsonfrontend/dashboard/public/i18n/de.jsonfrontend/dashboard/public/i18n/es.jsonfrontend/dashboard/public/i18n/fr.jsonfrontend/dashboard/public/i18n/it.jsonfrontend/dashboard/public/i18n/nl.jsonfrontend/dashboard/public/i18n/pt.json
仪表盘目前暴露以下语言 ID:
en, de, es, fr, it, nl, pt
格式化区域映射在 frontend/dashboard/src/app/app.config.ts 中配置:
en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR
不要仅仅根据 Angular 区域助手推断新的支持语言。仅当 Transloco 配置、区域 JSON 文件、格式化映射和产品文档都一致时,才添加或更改支持的仪表盘语言。
工作流程
- 在创建新键之前,先搜索现有的功能键。
- 将用户可见的 Angular 模板文本放在 TranslocoPipe 后面。
- 在 TypeScript 中使用 TranslocoService 处理计算得到的标签。
- 将相同的键路径添加到所有七个区域 JSON 文件中。
- 保持键名语义化并按功能分组。
- 精确保留插值变量。不要翻译变量名或更改占位符语法。
- 对于计算得到的选项标签,依赖当前语言,以便在语言切换后重新计算标签。
- 对于日期、数字、百分比和时长,优先使用现有的区域服务或辅助函数,而不是手动格式化字符串。
- 让 PrimeNG 区域文本通过现有的同步服务来处理,而不是硬编码组件标签。
- 保持标签简短,以适应按钮、标签页、标签、表格列和移动端布局。
需要检查的有用位置:
frontend/dashboard/src/app/app.config.tsfrontend/dashboard/src/app/transloco-loader.tsfrontend/dashboard/src/app/core/i18n/frontend/dashboard/scripts/check-i18n-locales.mjsfrontend/dashboard/scripts/sync-i18n-locales.mjs
翻译质量标准
翻译产品 UI,而不是单个英语单词。
- 德语:使用自然的产品德语,并包含正确的字符,例如
Ä、Ö、Ü、ä、ö、ü和ß。 - 西班牙语:在需要时使用重音符号、
ñ和开头标点,例如¿Seguro?。 - 法语:自然地使用重音符号和撇号,例如
paramètres、sécurité和l'adresse e-mail。 - 意大利语:在需要时使用重音符号,尤其是末尾重音的词,如
attività、città、perché、può和è。 - 荷兰语:保持仪表盘术语自然简洁。重用现有的术语来表示站点、团队、目标、漏斗、分享链接和 API 客户端。
- 葡萄牙语:除非产品明确更改区域目标,否则使用现有的巴西葡萄牙语格式化上下文 (
pt-BR)。使用带有正确重音符号的自然葡萄牙语。
在所有语言中保持分析术语的一致性。如果代码库中已有表示“站点”、“团队”、“事件”、“目标”、“漏斗”、“分享链接”、“API 客户端”、“QR 活动”或“机会”的术语,请重用它。
检查
翻译更改后运行区域检查:
cd frontend/dashboard && npm run i18n:check
如果怀疑键结构出现偏差,请运行同步脚本并在保留更改前审查结果:
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
对仪表盘文件运行格式化检查:
cd frontend/dashboard && npm run fmt:check
对于依赖语言切换的 UI 行为,请在拥有该行为的组件或服务附近添加或更新针对性测试。
评审输出
在报告国际化更改时,请包含:
更改的键:
- <键路径>
更新的区域:
- en, de, es, fr, it, nl, pt
检查结果:
- <命令和结果>
注意事项:
- <布局、措辞或评审备注>
不要声称翻译已经过母语者审阅,除非实际发生了这种情况。