HitKeep i18n
當修改使用者可見的儀表板文字或 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ò和è。 - 荷蘭語:保持儀表板術語自然且簡潔。對 site、team、goal、funnel、share link 和 API client 重複使用現有術語。
- 葡萄牙語:除非產品明確更改區域目標,否則使用現有的巴西葡萄牙語格式化上下文(
pt-BR)。使用帶有正確重音符號的自然葡萄牙語。
在所有語言中保持分析術語的一致性。如果倉庫已對「site」、「team」、「event」、「goal」、「funnel」、「share link」、「API client」、「QR campaign」或「Opportunity」使用了某個術語,請重複使用它。
檢查
在翻譯變更後執行區域檢查:
cd frontend/dashboard && npm run i18n:check
如果懷疑鍵結構偏移,請執行同步指令碼並在保留結果前檢視產生的變更:
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
對儀表板檔案執行格式化檢查:
cd frontend/dashboard && npm run fmt:check
對於依賴語言切換的 UI 行為,請在擁有該行為的元件或服務附近新增或更新聚焦測試。
審查輸出
報告 i18n 變更時,請包括:
變更的鍵:
- <鍵路徑>
更新的區域:
- en, de, es, fr, it, nl, pt
檢查:
- <指令與結果>
注意事項:
- <佈局、措辭或審查意見>
除非確實經過母語人士審查,否則不要聲稱翻譯已由母語人士審查過。