ウェブサイトの国際化
Next.jsウェブサイトに多言語サポートを追加し、SEOのベストプラクティスを実践するための完全なワークフローです。
このスキルを使用するタイミング
- 既存のウェブサイトに新しい言語版を追加する場合
- 新しいウェブサイトにi18n(国際化)を設定する場合
- 複数言語向けのSEOを構成する場合
- ユーザーが「言語を追加」、「翻訳」、「ローカリゼーション」、「hreflang」、「多言語」に言及した場合
対応言語
一般的なターゲット市場:
- 🇺🇸 英語(en) - グローバル市場
- 🇯🇵 日本語(ja) - アジア市場
- 🇨🇳 中国語(zh) - 中国市場
拡張サポート対象:
- 韓国語(ko)、ポルトガル語(pt)、スペイン語(es)、フランス語(fr)、ドイツ語(de)
- アラビア語(ar)、ベトナム語(vi)、ヒンディー語(hi)、インドネシア語(id)、タイ語(th)
- 繁体字中国語(zh-hk)、イタリア語(it)、ロシア語(ru)
国際化ワークフロー
このチェックリストをコピーして進捗を追跡してください:
i18n 進捗状況:
- [ ] ステップ 1: ベース言語ファイルの準備
- [ ] ステップ 2: 新しい言語ファイルの追加
- [ ] ステップ 3: 設定ファイルの更新
- [ ] ステップ 4: 翻訳の追加
- [ ] ステップ 5: SEO要素の設定
- [ ] ステップ 6: 検証とテスト
ステップ 1: ベース言語ファイルの準備
テンプレートとして英語(en.json)ファイルが存在することを確認します。
必要なディレクトリ:
i18n/messages/en.json- メイン翻訳i18n/pages/landing/en.json- ランディングページの翻訳
構造の確認:
# ベースファイルが存在するか確認
ls i18n/messages/en.json
ls i18n/pages/landing/en.json
存在しない場合は、ウェブサイト用の完全な翻訳キーを含むファイルを作成します。
ステップ 2: 新しい言語ファイルの追加
言語追加スクリプトを実行します:
node scripts/i18n-add-languages.mjs
このスクリプトの機能:
- すべてのターゲット言語ファイルに
en.jsonをコピー i18n/locale.tsを新しいロケールで更新i18n/request.tsを言語マッピングで更新public/sitemap.xmlを新しい言語URLで更新
スクリプト設定(i18n-add-languages.mjs 内):
languages配列 - 追加する言語のリストlanguageNamesオブジェクト - 言語の表示名targetDirs配列 - 翻訳ファイルを含むディレクトリ
詳細な手順については WORKFLOW.md を参照してください。
ステップ 3: 設定の更新を確認
i18n/locale.ts の確認:
export const locales = ["en", "ja", "zh", "ko", ...];
export const localeNames: any = {
en: "English",
ja: "日本語",
zh: "中文",
ko: "한국어",
...
};
i18n/request.ts の確認:
- 言語コードマッピングが設定されている
zh-CN→zh、zh-HK→zh-hkなどのマッピングが存在する
public/sitemap.xml の確認:
- すべての言語バージョンがリストされている
- 各URLに
hreflangタグが存在する
ステップ 4: 翻訳の追加
オプション A: AI翻訳を使用(高速だがレビューが必要):
# 構造化データと価格翻訳を追加
node scripts/i18n-add-schema.js
スクリプトの translations オブジェクトで翻訳を設定します。
オプション B: 手動翻訳(品質面で推奨):
各言語ファイルを編集して適切な翻訳を追加します:
# 言語ファイルを開く
code i18n/messages/ja.json
翻訳のベストプラクティス:
- 可能な場合はネイティブスピーカーを利用する
- ターゲット言語でSEOキーワードを維持する
- 単に翻訳するのではなく、コンテンツを地域の文化に適応させる
- 書式(プレースホルダー、変数)を一貫して保つ
言語コードのリファレンスについては reference/locale-codes.md を参照してください。
ステップ 5: SEO要素の設定
hreflangタグ - サイトマップ経由で自動生成されますが、確認は必要です:
完全なガイドについては reference/hreflang-guide.md を参照してください。
ローカライズされたメタタグ - 各言語ファイルで翻訳します:
{
"metadata": {
"title": "あなたのサイトタイトル",
"description": "あなたのSEOディスクリプション"
}
}
URL構造 - 正しい形式を確認します:
- 英語:
https://example.com/またはhttps://example.com/en/ - 日本語:
https://example.com/ja/ - 中国語:
https://example.com/zh/
ステップ 6: 検証とテスト
プロジェクトをビルド:
npm run build
重要: 先に進む前にエラーを修正してください。
手動テスト:
-
言語切り替え:
- 各言語バージョンにアクセス
- 言語切り替え機能がすべての言語を表示していることを確認
- 各言語リンクをクリックし、正しいページが読み込まれることを確認
-
コンテンツ表示:
- すべてのページが各言語で正しくレンダリングされていることを確認
- 未翻訳のテキストがないか確認(非英語ページで英語が表示されていないか)
- 特殊文字(日本語、中国語、アラビア語など)が正しく表示されるかテスト
-
SEO要素:
<html lang="...">属性がページの言語と一致しているか確認<link rel="alternate" hreflang="...">タグが存在するか確認- メタタグが正しい言語であるか確認
自動検証:
# サイトマップを確認
curl https://your-site.com/sitemap.xml | grep hreflang
# hreflangを検証(オンラインツールを使用)
# Google Search Console > 国際化 > hreflang
SEOチェックリスト - reference/seo-checklist.md を参照。
検証に失敗した場合:
- エラーメッセージを注意深く確認
- 設定ファイルのタイプミスをチェック
- 言語コードが正しいか確認
- ステップ3に戻って問題を修正
すべての検証が合格した場合のみ先に進んでください。
重要な注意事項
言語コードの標準
ISO 639-1(2文字コード)とオプションの地域バリアントを使用します:
en- 英語ja- 日本語zh- 簡体字中国語zh-hk- 繁体字中国語(香港)pt- ポルトガル語pt-br- ブラジルポルトガル語
完全なリストについては reference/locale-codes.md を参照。
SEOへの影響
正しいi18nがSEOを改善する理由:
- ユーザーを母国語でターゲット化
- 重複コンテンツペナルティの回避
- 検索エンジンが正しい言語バージョンを提供できるようにする
避けるべき一般的なSEOの間違い:
- ❌ IPベースの自動リダイレクト(検索エンジンがすべてのバージョンをクロールできなくなる)
- ❌ hreflangタグの欠落(重複コンテンツの問題を引き起こす)
- ❌ 言語間で一貫性のないURL構造
- ❌ 未翻訳のメタタグ
翻訳品質
AI翻訳 vs 人間による翻訳:
- ✅ AI: 高速、低コスト、初期ドラフトに適している
- ⚠️ AI: 文化的なニュアンスを見逃す可能性があり、レビューが必要
- ✅ 人間: 高品質、文化適応が可能
- ⚠️ 人間: 遅い、高コスト
推奨アプローチ:
- AIを使用して初期翻訳を生成
- ネイティブスピーカーがレビューして洗練
- ターゲット市場のユーザーでテスト
- フィードバックに基づいて反復改善
Next.js i18n ルーティング
このシステムはルーティングに next-intl を使用しています:
- URLからの自動ロケール検出
- 言語切り替えコンポーネント
- ローカライズされたナビゲーション
設定は i18n/locale.ts と i18n/request.ts で行います。
国際化後のタスク
言語を追加した後:
- 更新したサイトマップをGoogle Search Consoleに送信
- 言語/地域ごとに個別のSearch Consoleプロパティを作成
- アナリティクスで国際的なオーガニックトラフィックを監視
- 言語ごとにコンバージョン率が異なる場合はA/Bテストを実施
- 国際的なクロールエラーに関するアラートを設定
スクリプトの場所
すべてのi18nスクリプトは scripts/ ディレクトリにあります:
i18n-add-languages.mjs- 新しい言語ファイルの追加i18n-add-schema.js- 構造化データ翻訳の追加
参考資料
- WORKFLOW.md - 詳細なステップバイステップワークフロー
- reference/hreflang-guide.md - hreflang実装ガイド
- reference/locale-codes.md - 言語コードリファレンス
- reference/seo-checklist.md - 国際SEOチェックリスト
トラブルシューティングについては WORKFLOW.md のトラブルシューティングセクションを参照。