国際化ヘルパー
多言語アプリケーションにおける国際化(i18n)とローカリゼーション(l10n)の管理を支援します。
使用するタイミング
- ユーザーがi18nサポートをリクエストした場合
- 新しい言語を追加する場合
- 未翻訳の文字列を検出する場合
- 翻訳ファイルを管理する場合
- ユーザーが「翻訳」「i18n」「l10n」「ロケール」に言及した場合
手順
1. i18nフレームワークの検出
JavaScript/React:
- react-i18next
- react-intl (FormatJS)
- i18next
- LinguiJS
Vue:
- vue-i18n
Python:
- gettext
- Django i18n
- Flask-Babel
Ruby/Rails:
- I18n gem (組み込み)
インポート、設定ファイル、または翻訳ディレクトリを探します。
2. ハードコードされた文字列の検出
未翻訳のテキストを検索します:
// 悪い例: ハードコード
<button>送信</button>
<p>ようこそ、{user.name}さん!</p>
// 良い例: 翻訳済み
<button>{t('common.submit')}</button>
<p>{t('welcome.message', { name: user.name })}</p>
検索パターン:
- JSX/テンプレートタグ内の文字列
- アラート/エラーメッセージ
- フォームラベルとプレースホルダー
- ボタンテキスト
- バリデーションメッセージ
除外: コードコメント、console.log、テスト用文字列
3. 翻訳ファイルへの抽出
React-i18next形式 (JSON):
{
"common": {
"submit": "送信",
"cancel": "キャンセル"
},
"welcome": {
"message": "ようこそ、{{name}}さん!"
}
}
Gettext形式 (.po):
msgid "submit_button"
msgstr "送信"
msgid "welcome_message"
msgstr "ようこそ、%(name)sさん!"
4. 翻訳キーの整理
ベストプラクティス:
- 機能ごとに名前空間:
users.profile.title - 共通文字列をグループ化:
common.buttons.save - コンテキストを記述、内容ではなく:
errors.login.invalid(errors.wrong_passwordではない) - 一貫した命名規則
5. 翻訳カバレッジの確認
ロケールファイルを比較して不足している翻訳を検出:
en.json: 150 キー
es.json: 142 キー (8 不足)
fr.json: 150 キー ✓
es.jsonで不足:
- users.profile.bio
- settings.privacy.title
[...]
6. 複数形の処理
言語によって複数形のルールが異なります:
// react-i18next
t('items', { count: 0 }) // "0 アイテム"
t('items', { count: 1 }) // "1 アイテム"
t('items', { count: 5 }) // "5 アイテム"
// 翻訳ファイル
{
"items_zero": "{{count}} アイテム",
"items_one": "{{count}} アイテム",
"items_other": "{{count}} アイテム"
}
7. 日付、時刻、数値の書式設定
ロケール対応の書式設定を使用:
// 数値
const price = new Intl.NumberFormat('en-US', {
style: 'currency',
currency: 'USD'
}).format(29.99);
// 日付
const date = new Intl.DateTimeFormat('fr-FR').format(new Date());
8. RTL(右から左)対応
アラビア語、ヘブライ語の場合:
- CSS:
direction: rtl; - HTML:
<html dir="rtl"> - 論理プロパティ:
margin-leftの代わりにmargin-inline-start
9. 翻訳テンプレートの生成
新しいロケール用のテンプレートを作成:
# ベース言語からキーをコピー、値は空に
cp locales/en.json locales/de.json
# 翻訳用にマーク
10. ベストプラクティス
- 翻訳は別ファイルに保管
- キーを使用し、ソーステキストをキーにしない
- 翻訳者にコンテキストを提供
- 長い文字列でテスト(ドイツ語は長くなりがち)
- 複雑な文字列にはICU MessageFormatを使用
- 翻訳済み文字列の連結は避ける
- ユーザー向けテキストはすべて抽出
サポートファイル
templates/i18n-config.js: 設定例templates/locale-file.json: 翻訳ファイルテンプレート