チーム向けi18nキー管理ベストプラクティス
チーム間でのi18n翻訳キー管理のベストプラクティス。キーレビュープロセス、未使用キー検出、キーリンティング、翻訳管理システム、継続的ローカリゼーションワークフローをカバーします。
Best Practices
詳細な説明
i18nキー管理ベストプラクティス
大規模な翻訳キー管理には、命名規則だけでなくプロセスとツールが必要です。これらのベストプラクティスは、クリーンで一貫性があり完全な翻訳ファイルの維持を支援します。
1. キースタイルガイドの策定
規約を共有スタイルガイドに文書化します。
2. 翻訳管理システム（TMS）の使用
開発者チーム向けの人気TMSプラットフォーム：Crowdin、Lokalise、Phrase、Weblate、POEditorなど。
3. 未使用キーの検出
コードで参照されなくなったキーを見つけるツールを使用します。
4. 翻訳キーのリント
CIパイプラインにキーリンティングを追加：不足キーのチェック、余分なキーのチェック、補間変数の一致検証、命名規則の強制、重複キーの検出。
5. 継続的ローカリゼーションワークフロー
開発者が英語文字列を追加 -> gitにプッシュ -> TMSが新しいキーを検出 -> 翻訳者に通知 -> 翻訳のレビューと承認 -> TMSがgitに翻訳をプッシュバック -> CIが完全性を検証 -> デプロイ
6. 翻訳者へのコンテキスト提供
キーだけでは不十分です。スクリーンショット、説明、文字数制限、プレースホルダーの文書化でコンテキストを提供します。
ユースケース
キー管理プラクティスは、プロジェクトの貢献者が3人以上、または翻訳キーが500以上になると不可欠になります。プロセスがなければ、本番環境での翻訳の欠落、翻訳ファイルを肥大化させる未使用キー、翻訳者を混乱させる一貫性のない命名が発生します。