HitKeep i18n は何をしますか?
このスキルは、HitKeep においてユーザーが見るダッシュボードのテキストやロケールに応じたフォーマットを変更する際に使用します。
HitKeep のダッシュボードは、UI コピーに Transloco JSON ファイルを使用し、@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を使用してください。 - 同じキーパスを7つすべてのロケール 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?。 - イタリア語:必要な場合にアクセント記号を使用してください。特に
attività、città、perché、può、èなどの最終アクセント単語に注意してください。 - オランダ語:ダッシュボードの用語は自然で簡潔に保ち、サイト、チーム、ゴール、ファネル、共有リンク、API クライアントなどの既存用語を再利用してください。
- ポルトガル語:製品が明示的にロケールターゲットを変更しない限り、既存のブラジルポルトガル語(
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 変更を報告する際は、以下を含めてください。
Changed keys:
- <キーパス>
Locales updated:
- en, de, es, fr, it, nl, pt
Checks:
- <コマンドと結果>
Caveats:
- <レイアウト、表現、またはレビューに関する注意>
翻訳が実際にネイティブスピーカーによってレビューされていない限り、そのように主張しないでください。