nuxt-i18n について
Nuxt プロジェクトのローカライズ設定を支援する Nuxt I18n スキルです。言語メッセージ、ローカライズされたルート、言語検出、メタデータを扱い、モジュール、Vue I18n、Nuxt の役割を分けて説明します。
主な機能
- 01ロケール設定の確認
- 02翻訳メッセージの管理
- 03ローカライズルートの設定
- 04ローカライズリンクとコンポーザブルの利用
- 05表示と SEO メタデータの確認
活用シーン
- 01Nuxt プロジェクトへのロケール追加
- 02翻訳と補間の更新
- 03ロケール切り替えの実装
- 04ローカライズルートとメタデータの検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ onmax/ nuxt-skills --skill nuxt-i18nインストール後、Claude Code で/nuxt-i18nを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/configuration.mdmessages.mdrouting.md詳細
Nuxt I18n
Nuxt I18n はロケールメッセージ、ローカライズされたルート、言語検出、ロケールのメタデータを管理します。ページ、レンダリング、サーバーのライフサイクルは Nuxt が管理します。
ワークフロー
- インストールされている
@nuxtjs/i18nのバージョン、nuxt.config.*、i18n/i18n.config.*、ロケールファイル、影響を受けるページを確認します。ロケールコード、ファイル、defaultLocale、ルーティング戦略が一致していれば、設定を把握できています。 - 以下から最も適したガイドを開きます。モジュールのオプションは
nuxt.configに、Vue I18n のオプションはi18n.configに、翻訳メッセージはロケールファイルに記述します。 - ローカライズされたリンクとモジュールのコンポーザブルを使って実装し、ルーティング、メッセージの読み込み、SEO が同じロケール状態を共有するようにします。
nuxi prepareとプロジェクトの型チェックを実行し、デフォルトロケールと別のロケールで対象ルートにアクセスします。どちらのロケールでも期待されるメッセージ、URL、言語メタデータ、フォールバック動作が表示されれば、変更は完了です。
ルーティング
| タスク | 開く |
|---|---|
| インストール、ロケールオブジェクト、ファイル構成、ブラウザー検出、Vue I18n の設定 | 設定 |
| 翻訳キー、補間、複数形、日付、数値、実行時のメッセージ読み込み | メッセージ |
| ルート戦略、ローカライズされたリンク、切り替え、カスタムパス、動的スラッグ、SEO | ルーティングと SEO |
| Nuxt のページ、ミドルウェア、データ取得、SSR の状態、サーバールート | nuxt スキル |
基本設定
npx nuxi@latest module add @nuxtjs/i18n
export default defineNuxtConfig({
modules: ['@nuxtjs/i18n'],
i18n: {
defaultLocale: 'en',
locales: [
{ code: 'en', language: 'en-US', name: 'English', file: 'en.json' },
{ code: 'fr', language: 'fr-FR', name: 'Français', file: 'fr.json' },
],
},
})
{
"welcome": "Welcome"
}
デフォルトでは、ロケールファイルは i18n/locales/ から解決されます。設定、ルートヘルパー、ロケールファイル、フォールバックルールで同じロケールコードを使用してください。
コメント
Markdown 対応