よくある質問

    パスに [locale] を含めずに Next.js で Intlayer を使う

    ページパスに `[locale]` を含めずに Next.js で Intlayer を使用する方法を学びます。

    配列をコンテンツ宣言として使えますか?

    はい、Intlayer では配列をコンテンツ宣言にできます。宣言方法、各項目の翻訳、コンポーネントからの読み取り方を解説します。

    辞書のビルド方法

    Intlayer が辞書を自動でビルドするタイミング、CLI で手動ビルドする方法、生成ファイルの出力先を解説します。

    CI/CD での Intlayer ビルドエラーを直す

    CI/CD でだけ発生する Server Components のレンダリングエラーを、ビルド時に Intlayer の辞書が生成されるようにして解消します。

    bunを使用するとモジュールが見つからないエラーが発生する

    Bun で Intlayer を使うときの「Cannot find package」エラーを修正。Bun の require() のスコープが原因で、解決する設定を紹介します。

    翻訳時の Claude Code のトークン消費を抑える

    Claude Code での翻訳がトークンを大量に消費する理由、Intlayer の代わりのアプローチ、Claude のサブスクリプションを翻訳に再利用する方法。

    ロケールリストをカスタマイズする方法は?

    intlayer.config.ts で Intlayer が対応するロケールの一覧をカスタマイズ。地域バリアントやデフォルトロケールも設定できます。

    ドメインベースのルーティングを設定する方法

    Intlayer のドメインベースのルーティングで、ロケールごとに専用ドメインから配信。intlayer.config.ts で設定し、リダイレクトも自動で処理します。

    vite-env-only:Intlayer での node:fs 誤検知エラー

    Intlayer + React-Router + Vite 環境で vite-env-only が `node:fs` のインポートを拒否すると報告する理由と、その対処法。

    Intlayer の ESBuild エラーを直す

    Intlayer のビルド中に起きる ESBuild エラーを修正。多くの場合、フレームワーク用のバンドラープラグインが未設定か誤って設定されています。

    クッキー / ヘッダーからロケールを取得する方法

    Intlayer で Cookie やリクエストヘッダーから現在のロケールを読み取り、サーバーやミドルウェアで正しい言語を表示します。

    IntlayerNode 型。これは何ですか?

    IntlayerNode 型とは何ですか?なぜ私の文字列が IntlayerNode<string> に変換されるのですか?

    Intlayer コマンドが未定義

    「intlayer: command not found」エラーの修正:CLI をインストールし、パッケージマネージャー経由で実行し、PATH を確認します。

    URLから取得したロケールが誤っている

    Next.js で URL から「en」ではなく「about」のような誤ったロケールが読まれる問題を、Intlayer が想定する [locale] フォルダー構成で解消します。

    ノード型を組み合わせることはできますか?(例:1文の中に複数の複数形がある場合)

    Intlayerでinsert()またはネストしたplural()を使用して、ノード型を組み合わせ、1つの文の中で複数の独立した複数形変数を表現する方法。

    サブパッケージ @intlayer/* に関連するエラーが発生する

    @intlayer/* サブパッケージのバージョン不一致によるエラーを修正:すべての Intlayer パッケージを同じバージョンに揃え、キャッシュをクリアします。

    Next.jsにおけるi18nの静的レンダリングと動的レンダリングの比較

    next-intl のヘルパーが Next.js の i18n ルートを動的にしてしまう理由と、ローカライズされたページを静的レンダリングのまま保つ方法。

    URLパスを翻訳できますか?

    はい、Intlayer では /about を /ja/about-us のように URL パスを翻訳できます。ロケールごとに URL リライトを設定します。

    Intlayer の「unknown command」エラーを直す

    Intlayer CLI の「unknown command」エラーを修正:コマンド名、CLI のバージョン、バイナリの呼び出し方を確認します。

    グローバルな provider なしで Intlayer を使えますか?

    provider をマウントせずに Intlayer のコンテンツを読む方法、サーバーとブラウザでのロケールの解決方法、provider との性能の違い。