i18n & Localization(国際化とローカライゼーション)
国際化(i18n)とローカライゼーション(L10n)のベストプラクティス
1. コア概念
| 用語 | 意味 |
|---|
| i18n | 国際化 - アプリを翻訳可能にする |
| L10n | ローカライゼーション - 実際の翻訳 |
| Locale | 言語 + 地域(en-US, tr-TR) |
| RTL | 右から左へ書く言語(アラビア語、ヘブライ語) |
2. i18nを導入すべきタイミング
| プロジェクトの種類 | i18nは必要か? |
|---|
| 公開Webアプリ | ✅ 必要 |
| SaaS製品 | ✅ 必要 |
| 社内ツール | ⚠️ 場合による |
| 単一地域向けアプリ | ⚠️ 将来性を考慮 |
| 個人プロジェクト | ❌ 任意 |
3. 実装パターン
React(react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js(next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python(gettext)
from gettext import gettext as _
print(_("私たちのアプリへようこそ"))
4. ファイル構造
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
5. ベストプラクティス
推奨事項 ✅
- 翻訳キーを使用し、生のテキストを使わない
- 翻訳を機能ごとに名前空間で分ける
- 複数形に対応する
- 日付・数値フォーマットをロケールごとに処理する
- 最初からRTLを考慮して設計する
- 複雑な文字列にはICUメッセージ形式を使用する
避けるべきこと ❌
- コンポーネント内に文字列をハードコードする
- 翻訳済み文字列を連結する
- テキストの長さを過小評価する(ドイツ語は英語より約30%長い)
- RTLレイアウトを忘れる
- 同じファイル内で言語を混在させる
6. よくある問題
| 問題 | 解決策 |
|---|
| 翻訳が見つからない | デフォルト言語にフォールバック |
| ハードコードされた文字列 | リンター・チェッカースクリプトを使用 |
| 日付形式 | Intl.DateTimeFormatを使用 |
| 数値形式 | Intl.NumberFormatを使用 |
| 複数形処理 | ICUメッセージ形式を使用 |
7. RTL対応
.container {
margin-inline-start: 1rem;
padding-inline-end: 1rem;
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
8. チェックリスト
リリース前に確認する項目:
スクリプト
| スクリプト | 目的 | コマンド |
|---|
scripts/i18n_checker.py | ハードコードされた文字列と欠落している翻訳を検出 | python scripts/i18n_checker.py <project_path> |
使用タイミング
このスキルは、概要に記載されたワークフローやアクションを実行する場合に適用されます。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、停止して明確化を求めてください。