Communitygithub.com

HitKeep i18n

HitKeep のダッシュボードにおける多言語化(i18n)とロケール対応を管理するスキル。プライバシー重視のアナリティクスツール向けに、UI テキストの翻訳やフォーマットのローカライズを行います。

HitKeep i18n とは?

このスキルは、HitKeep ダッシュボードのユーザー向けテキストやロケールに応じたフォーマットを変更する際に使用します。HitKeep のダッシュボードは、UI コピーに Transloco JSON ファイルを、ロケール対応のフォーマットに `@jsverse/transloco-locale` とブラウザの `Intl` API を利用しています。また、PrimeNG のラベルはアクティブな Transloco 言語と同期されます。サポート対象言語は英語、ドイツ語、スペイン語、フランス語、イタリア語、オランダ語、ポルトガル語の7つで、各言語に固有のロケールマッピングが設定されています。本スキルは、既存のキーを検索してから新しいキーを作成する、すべてのロケール JSON ファイルに同じキーパスを追加する、翻訳変数をそのまま保持する、数値や日付のフォーマットには手動ではなくロケールサービスを優先する、といった一連のワークフローを提供します。さらに、翻訳品質の基準(ドイツ語の `ß` やフランス語のアクセントなど)や、一貫性を保つためのアナリティクス用語の再利用ルールも定義しています。変更後は `npm run i18n:check` でチェックを実行し、必要に応じて同期スクリプトを実行することが求められます。

対応~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HitKeep i18n は何をしますか?

このスキルは、HitKeep においてユーザーが見るダッシュボードのテキストやロケールに応じたフォーマットを変更する際に使用します。

HitKeep のダッシュボードは、UI コピーに Transloco JSON ファイルを使用し、@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. 同じキーパスを7つすべてのロケール 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?。
  • イタリア語:必要な場合にアクセント記号を使用してください。特に 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:
- <レイアウト、表現、またはレビューに関する注意>

翻訳が実際にネイティブスピーカーによってレビューされていない限り、そのように主張しないでください。

関連スキル