UIテキストからi18nキーを自動生成
英語のUIテキストから意味のあるi18n翻訳キーを自動生成する方法。テキストの分類、スマートキー提案アルゴリズム、ページ全体のバッチキー生成をカバーします。
Workflow
詳細な説明
UIテキストからのi18nキー生成
アプリケーション内のすべての文字列に対して手動で翻訳キーを考案するのは、面倒で一貫性に欠けます。ソーステキストからの自動キー生成は、プロジェクトの規約に従った一貫性のある説明的なキーを生成します。
キー生成の仕組み
キージェネレーターは入力テキストを分析し、いくつかのステップで構造化されたキーを生成します:
- 正規化 -- 句読点を除去、小文字に変換、単語に分割
- カテゴリ分類 -- テキストがボタンラベル、エラーメッセージ、ナビゲーション項目、ステータスインジケーター、汎用コンテンツのいずれかを検出
- プレフィックス割り当て -- 適切なカテゴリ(
buttons、errors、navなど)を先頭に付加 - 規約フォーマット -- ドット記法、snake_case、またはcamelCaseルールを適用
カスタマイズ
自動生成されたキーは提案です。常にレビューと調整を行ってください:
- 過度に長いキーを短縮
- 同じキーを生成する2つの入力の重複をマージ
- ヒューリスティックがテキストを誤分類した場合にカテゴリを調整
ユースケース
UIテキストからのキー生成は、既存アプリケーションの初期i18n設定時に最も価値があります。コンポーネントから何百ものハードコードされた文字列を抽出する際、各キーを手動で命名するのに何時間もかかります。i18nキージェネレーターはこのプロセスを自動化し、コミット前にレビューと改善が可能な翻訳ファイルの最初のドラフトを生成します。