Communitygithub.com

HitKeep 国际化

HitKeep 是一款注重隐私的分析工具,适用于人类和 AI 代理,支持自托管或托管于欧盟/美国云区域。

HitKeep 国际化 是什么?

HitKeep i18n 技能用于在修改 HitKeep 仪表盘中用户可见的文本或本地化格式时提供指导。该技能详细描述了如何使用 Transloco JSON 文件管理 UI 文案,并通过 `@jsverse/transloco-locale` 和浏览器 `Intl` API 实现区域感知格式化。PrimeNG 组件的标签会与当前 Transloco 语言同步更新。技能涵盖了公共界面文件位置(包括七种语言的 JSON 文件)、语言 ID 及格式化区域映射的配置方法,并规定了完整的工作流程,包括在创建新键前搜索现有键、使用 TranslocoPipe 和 TranslocoService 处理文本、保持键名语义化等。此外,还提供了针对德语、西班牙语、法语、意大利语、荷兰语和葡萄牙语的翻译质量标准,强调使用自然的产品语言和正确的特殊字符。技能还包含了本地化检查命令(如 `npm run i18n:check`)和键同步脚本,以及开发评审时的输出格式要求。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HitKeep 国际化 是做什么的?

当修改用户可见的仪表盘文本或本地化格式时,使用此技能。

HitKeep 的仪表盘使用 Transloco JSON 文件管理 UI 文案,并利用 @jsverse/transloco-locale 和浏览器 Intl API 实现区域感知格式化。PrimeNG 组件标签会与当前 Transloco 语言同步更新。

公共界面

仪表盘翻译文件位于:

  • frontend/dashboard/public/i18n/en.json
  • frontend/dashboard/public/i18n/de.json
  • frontend/dashboard/public/i18n/es.json
  • frontend/dashboard/public/i18n/fr.json
  • frontend/dashboard/public/i18n/it.json
  • frontend/dashboard/public/i18n/nl.json
  • frontend/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 文件、格式化映射和产品文档都一致时,才添加或更改支持的仪表盘语言。

工作流程

  1. 在创建新键之前,先搜索现有的功能键。
  2. 将用户可见的 Angular 模板文本放在 TranslocoPipe 后面。
  3. 在 TypeScript 中使用 TranslocoService 处理计算得到的标签。
  4. 将相同的键路径添加到所有七个区域 JSON 文件中。
  5. 保持键名语义化并按功能分组。
  6. 精确保留插值变量。不要翻译变量名或更改占位符语法。
  7. 对于计算得到的选项标签,依赖当前语言,以便在语言切换后重新计算标签。
  8. 对于日期、数字、百分比和时长,优先使用现有的区域服务或辅助函数,而不是手动格式化字符串。
  9. 让 PrimeNG 区域文本通过现有的同步服务来处理,而不是硬编码组件标签。
  10. 保持标签简短,以适应按钮、标签页、标签、表格列和移动端布局。

需要检查的有用位置:

  • frontend/dashboard/src/app/app.config.ts
  • frontend/dashboard/src/app/transloco-loader.ts
  • frontend/dashboard/src/app/core/i18n/
  • frontend/dashboard/scripts/check-i18n-locales.mjs
  • frontend/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

检查结果:
- <命令和结果>

注意事项:
- <布局、措辞或评审备注>

不要声称翻译已经过母语者审阅,除非实际发生了这种情况。

相关技能