@intlayer/docs 9.4.1 → 9.4.2

package/docs/ja/intlayer_with_create_react_app.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: "Create React App i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Create React Appアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -46,7 +46,6 @@ author: aymericzip
 `react-i18next` や `i18next` のような主流なソリューションと比較して、Intlayer は以下のような統合された最適化を備えたソリューションです：
 
 <AccordionGroup>
-
 <Accordion header="Full React カバレッジ">
 
 Intlayerは、**コンポーネントレベルのコンテンツスコーピング**、**遅延読み込み翻訳**、および国際化（i18n）をスケーリングするために必要なすべての機能を提供することで、Reactで完璧に機能するように最適化されています。
@@ -71,6 +70,8 @@ Intlayerは、**コンポーネントレベルのコンテンツスコーピン
 
 </Accordion>
 
+<Accordion header="Automation">
+
 Intlayerを使用すると、以下が可能です：
 
 あなたが選んだLLMを使用して、AI プロバイダーのコストで CI/CD パイプラインで翻訳を自動化します。Intlayer は、コンテンツ抽出を自動化するための**コンパイラ**と、**バックグラウンドで翻訳**するのに役立つ[web プラットフォーム](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)も提供しています。
@@ -677,3 +678,107 @@ Intlayer を使った開発体験を向上させるために、公式の **Intla
 ### さらに進むには
 
 さらに進みたい場合は、[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を実装するか、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使ってコンテンツを外部化することができます。
+
+## よくある質問
+
+<FAQ>
+
+<Question title="Create React Appプロジェクトを国際化するために利用できる様々なソリューションは何ですか？">
+
+- **`react-i18next` / `i18next`**: 最も普及しており、実行時にJSONネームスペースがロードされます。
+- **`react-intl`** および **`Lingui`**: ICUメッセージ形式で、抽出ベースです。
+- **`Intlayer`**: 最も先進的なソリューションです。コンテンツはコードベースのどこにでも宣言でき（[各コンポーネントの隣または一元化](https://intlayer.org/blog/per-component-vs-centralized-i18n)）、`react-scripts-intlayer`を介してビルド時にコンパイルされ、完全に型付けされており、AI翻訳、ビジュアルエディター、CMSを備えています。
+
+Create React Appは独自のwebpack設定をラップしているため、統合は自分で登録するプラグインではなく、`react-scripts`のドロップイン代替である`react-scripts-intlayer`を介して行われます。[Intlayerの利点](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/interest_of_intlayer.md)と[ベンチマーク](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/index.md)をご覧ください。
+
+</Question>
+
+<Question title="i18nはReactのbundleサイズにどのくらい影響しますか？">
+
+ネームスペースベースのセットアップよりもはるかに少ないです。なぜなら、ページはレンダリングしないカタログをダウンロードしないからです。ビルド時コンパイラは`useIntlayer`の呼び出しをコンポーネントが使用する正確な辞書エントリに置き換えるため、未使用のキーや未使用の言語は削除され、[動的辞書](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)が残りをロケールごとに分割します。一般的な代替案と比較して、Intlayerはbundleサイズとページサイズを最大50%削減します。[bundle最適化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md)と[ベンチマーク](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/index.md)をご覧ください。
+
+</Question>
+
+<Question title="`react-i18next`または`react-intl`からコンポーネントを書き直さずに移行できますか？">
+
+はい、2つの方法があります。[react-i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_react-i18next_to_intlayer.md)または[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)に従って、コンテンツを段階的に移行できます。または、現在のAPIを完全に維持することも可能です。[互換性アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は、`react-i18next`、`react-intl`、`i18next`とまったく同じAPIを公開しますが、Intlayer辞書によって提供されるため、インポートは変更されますが、コンポーネントコードは変更されません。
+
+</Question>
+
+<Question title="既存のJSON翻訳ファイルを保持できますか？">
+
+はい。[sync JSON plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-json.md)は、`/messages/{locale}/{namespace}.json`ファイルを信頼できる情報源として保持し、それらからIntlayer辞書を双方向に生成します。[sync PO plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-po.md)はgettextカタログに対しても同様の処理を行い、[ロケールごとのファイル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)を使用すると、1つのファイルにロケールをグループ化する代わりに、言語ごとにコンテンツを分割できます。
+
+</Question>
+
+<Question title="コンテンツをキーごとに移動する必要がありますか？">
+
+いいえ。`npx intlayer extract`を実行すると、Intlayerがコンポーネントを読み取り、ユーザー向けの文字列を抽出し、それぞれの隣に`.content`ファイルを書き込みます。これにより、一度に1つずつ文字列をカタログにコピーする代わりに、差分を確認できます。
+
+完全に自動化されたパイプラインの場合、[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md)はビルド時に同じことを行います。変更があるたびにJSX、TSX、Vue、Svelteのソースをスキャンし、辞書を生成し、ホットモジュールリプレイスメントを通じて同期を保つため、手動でキーを管理する必要はまったくありません。
+
+コンパイラをオンにする前に知っておくべき2つの制限があります。静的解析によって機能するため、APIエラーコードやCMSフィールドなど、実行時にのみ存在する文字列は対象外です。また、`className="active"`やステータスコードのようなアプリケーションロジックと、ユーザー向けのテキストを区別する必要があり、大規模なコードベースではいくつかの注釈が必要です。[extractコマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md)は、ユーザーが関与することでこれら両方を回避します。
+
+</Question>
+
+<Question title="利用可能なエディターおよびAIエージェントツールは何ですか？">
+
+5つの要素があり、すべてオプションです。
+
+- **[VS Code extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer`キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用のIntlayerタブからビルド、フィル、テスト、プッシュ、プルを実行したりできます。
+- **[LSP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**: LSPをサポートする任意のエディターで同様の認識機能を提供します。定義へのジャンプ、すべての参照の検索、翻訳された値のホバープレビュー、キーとフィールドのオートコンプリート、キーがどこにも宣言されていない場合の警告など。また、`i18next`、`react-i18next`、`next-intl`、`use-intl`の呼び出しも解決するため、移行中に役立ちます。
+- **[MCP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**: IntlayerのドキュメントとCLIをCursor、VS Code、Claude Desktop、Claude Code、ChatGPTに公開します。これにより、アシスタントは推測ではなく現在のドキュメントから回答し、`intlayer fill`などのコマンド自体を実行できます。
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**: `intlayer-config`、`intlayer-cli`、`intlayer-content`などの特化したスキルに加え、フレームワークごとのスキルがあり、エージェントにルーティング設定とコンテンツノードタイプを教えます。
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/eslint.md)**: `no-raw-text`はハードコードされた文字列にフラグを立て、静的辞書キーや未使用のコンテンツに対する追加ルールも提供します。
+
+</Question>
+
+<Question title="Create React Appはもはやメンテナンスされていません。まずViteに移行すべきですか？">
+
+すでに移行を計画している場合は、まず移行を行い、代わりに[ViteとReactのガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_with_vite+react.md)に従ってください。Viteプラグインはよりサポートされているパスであり、より高速なリビルドを提供します。まだ準備ができていない場合でも、このガイドは引き続き機能し、コンテンツ宣言は両方のセットアップ間で変更されないため、後でビルドを移行してもi18nを書き直す必要はありません。
+
+</Question>
+
+<Question title="Create React Appプロジェクトでローカライズされたルーティングを設定するにはどうすればよいですか？">
+
+ステップ7と8では、ローカライズされたルートと、ロケールが変更されたときのURLの書き換えについて説明しています。パスにロケールを含めたくない場合は、`routing.mode`を`"no-prefix"`または`"search-params"`に設定すると、代わりにcookieまたはクエリパラメータから解決されます。[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)をご覧ください。
+
+</Question>
+
+<Question title="クライアントレンダリングされたReactアプリでSEOメタデータを処理するにはどうすればよいですか？">
+
+ステップ9に示すように、アクティブなロケールから`html`要素に`lang`と`dir`を設定し、`x-default`を含む宣言されたすべてのロケールに対して`getMultilingualUrls`で`hreflang`代替を出力します。Create React Appは単一のクライアントレンダリングシェルを出荷するため、確実にクロールされる必要があるページには、[TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_with_tanstack.md)や[React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_with_react_router_v7.md)のようなプリレンダリングまたはサーバーレンダリングのセットアップを推奨します。
+
+</Question>
+
+<Question title="アラビア語やヘブライ語のような右から左に書く言語をサポートするにはどうすればよいですか？">
+
+ステップ9で説明されています。`getHTMLTextDir`はロケールに対して`ltr`、`rtl`、または`auto`を返すため、ルート要素にアクティブなロケールから`lang`と`dir`をバインドし、残りはCSSの論理プロパティに任せます。
+
+</Question>
+
+<Question title="AIを使ってアプリを自動的に翻訳するにはどうすればよいですか？">
+
+`npx intlayer fill`を実行します。これにより、選択したLLMを使用し、独自のプロバイダーとAPIキーを使用して、不足している翻訳が埋められます。`--git-diff`を使用すると、実行をブランチで変更されたコンテンツに限定できます。[fillコマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/fill.md)と[CI/CD統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/CI_CD.md)をご覧ください。
+
+</Question>
+
+<Question title="Intlayerは複数形、性別、リッチテキストをサポートしていますか？">
+
+はい、[複数形](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/plurial.md)、[性別に基づくコンテンツ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/gender.md)、条件、[挿入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/insertion.md)、[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/markdown.md)、および数値、日付、通貨の[フォーマッター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/formatters.md)をサポートしています。
+
+</Question>
+
+<Question title="翻訳者はコードに触れることなくコンテンツを編集できますか？">
+
+[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を介して可能です。これは独自のインフラストラクチャで動作し、実行中のアプリで誰でもテキストをその場で編集できます。または、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使用すると、コンテンツを外部化してデプロイなしで変更できます。
+
+</Question>
+
+<Question title="Intlayerは無料でオープンソースですか？">
+
+はい、Apache 2.0ライセンスの下で、商用利用も含まれます。ホスト型CMSはオプションの有料サービスですが、[セルフホスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)することも可能です。
+
+</Question>
+
+</FAQ>

package/docs/ja/intlayer_with_elysia.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-23
-updatedAt: 2026-08-24
+updatedAt: 2026-08-30
 title: "Elysia i18n - アプリを翻訳するための完全ガイド"
 description: "もう i18next は不要です。多言語 (i18n) Elysia アプリを構築するための 2026 年のガイド。AI エージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -341,3 +341,123 @@ Intlayerが生成するファイルを無視することをお勧めします。
 # Intlayerが生成するファイルを無視
 .intlayer
 ```
+
+## よくある質問
+
+<FAQ>
+
+<Question title="Elysiaバックエンドを国際化するための利用可能なソリューションにはどのようなものがありますか？">
+
+Elysiaには独自のi18nレイヤーがないため、手動でhookに組み込む`i18next`のような汎用ライブラリを使用するか、`elysia-intlayer`を介して`Intlayer`を使用するかの選択肢があります。`elysia-intlayer`はプラグインを登録し、リクエストごとにロケールを解決し、フロントエンドと同じ型付きコンテンツを共有します。
+
+バックエンドを国際化する理由は、ユーザーが読むテキストの大部分がフロントエンドを通過しないためです。例えば、APIエラーメッセージ、トランザクションメール、プッシュ通知、SMS、PDFエクスポートなどです。これらはセッションごとではなく、リクエストごとに解決される受信者の言語を必要とします。
+
+[Intlayerを選ぶ理由](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/interest_of_intlayer.md)をご覧ください。
+
+</Question>
+
+<Question title="i18nはElysiaサーバーのbundleサイズにどのくらい影響しますか？">
+
+ごくわずかです。辞書は事前にコンパイルされ、宣言したロケールのみが含まれるため、起動時にカタログをロードしたり、リクエストパスでファイルを読み込んだりすることはありません。これは、bundleサイズがコールドスタート時間に影響するserverlessおよびedge deploymentsで最も重要です。[bundle最適化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md)をご覧ください。
+
+</Question>
+
+<Question title="`i18next`からハンドラーを書き換えずに移行できますか？">
+
+はい、2つの方法があります。[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)に従って、コンテンツを段階的に移行できます。または、現在のAPIを完全に維持することも可能です。[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は`i18next`とまったく同じAPIを公開しますが、Intlayer辞書によって提供されるため、インポートは変更されますが、handlerコードは変更されません。
+
+</Question>
+
+<Question title="既存のJSON翻訳ファイルを保持できますか？">
+
+はい、可能です。[sync JSON plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-json.md)は、`/messages/{locale}/{namespace}.json`ファイルを信頼できる情報源として保持し、それらからIntlayer辞書を双方向に生成します。[sync PO plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-po.md)はgettext catalogsに対しても同様の機能を提供し、[ロケールごとのファイル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)を使用すると、1つのファイルにロケールをグループ化する代わりに、言語ごとにコンテンツを分割できます。
+
+</Question>
+
+<Question title="コンテンツをキーごとに移動する必要がありますか？">
+
+いいえ、必要ありません。`npx intlayer extract`を実行すると、Intlayerがソースファイルを読み込み、ユーザー向けの文字列を抽出し、それぞれの隣に`.content`ファイルを書き込みます。これにより、文字列をカタログに1つずつコピーする代わりに、差分を確認するだけで済みます。[extractコマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md)をご覧ください。
+
+同じプロジェクトのフロントエンド側では、[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md)がさらに進んで、JSX、TSX、Vue、またはSvelteのソースからビルド時に辞書を生成するため、アプリの両方の部分が手動でキーを管理することなく、1つのコンテンツレイヤーを共有できます。
+
+</Question>
+
+<Question title="利用可能なエディターおよびAIエージェントツールにはどのようなものがありますか？">
+
+5つのツールがあり、すべてオプションです。
+
+- **[VS Code extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer`キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用のIntlayerタブからビルド、フィル、テスト、プッシュ、プルを実行したりできます。
+- **[LSP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**: LSPをサポートする任意のエディターで同様の認識機能を提供します。定義へのジャンプ、すべての参照の検索、翻訳された値のホバープレビュー、キーとフィールドのオートコンプリート、どこにも宣言されていないキーに対する警告などがあります。また、`i18next`、`react-i18next`、`next-intl`、`use-intl`の呼び出しも解決するため、移行中に役立ちます。
+- **[MCP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**: IntlayerのドキュメントとCLIをCursor、VS Code、Claude Desktop、Claude Code、ChatGPTに公開します。これにより、アシスタントは推測するのではなく、現在のドキュメントから回答し、`intlayer fill`などのコマンドを自分で実行できます。
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**: `intlayer-config`、`intlayer-cli`、`intlayer-content`などの特化したスキルに加え、フレームワークごとのスキルがあり、エージェントにルーティング設定とコンテンツノードタイプを教えます。
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/eslint.md)**: `no-raw-text`はハードコードされた文字列を検出し、静的辞書キーや未使用コンテンツに対する追加のルールも提供します。
+
+</Question>
+
+<Question title="Intlayerはどの言語で応答すべきかをどのように判断しますか？">
+
+デフォルトでは、`elysia-intlayer`は受信リクエストの`Accept-Language` headerを読み取り、最も近い宣言されたロケールを選択し、デフォルトのロケールにフォールバックします。`routing.storage`を使用してソースを変更できます。例えば、フロントエンドによって設定されたカスタムheaderやcookieを使用することで、APIはブラウザが宣伝する言語ではなく、ユーザーが実際に選択した言語で応答できます。[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)をご覧ください。
+
+</Question>
+
+<Question title="ロケールはリクエストごとに分離されますか？">
+
+はい。プラグインはアクティブなロケールをリクエストにスコープするため、異なる言語での2つの同時リクエストが互いのロケールを読み取ることはありません。これにより、すべての関数にロケール引数をスレッド化することなく、サービスから`t()`および`getIntlayer()`を安全に呼び出すことができます。
+
+</Question>
+
+<Question title="受信者の言語でトランザクションメールを送信するにはどうすればよいですか？">
+
+他のコンテンツと同様に、コンテンツファイルにメールコンテンツを宣言し、リクエストロケールではなく、受信者の保存されたロケールに対して`getIntlayer`で解決します。これは、言語がユーザーレコードに属し、headerを読み取るための受信リクエストがないjobsやqueuesにとって重要です。
+
+</Question>
+
+<Question title="APIエラーメッセージをローカライズするにはどうすればよいですか？">
+
+エラーが構築される時点でメッセージを`t()`でラップします。アクティブなリクエストロケールがそれを解決するため、クライアントは直接表示できるメッセージを受け取り、フロントエンドはエラーコードの並列カタログを必要としません。
+
+</Question>
+
+<Question title="Bunおよびedgeランタイムで動作しますか？">
+
+ElysiaはまずBunをターゲットとしており、Intlayerは実行時にディスクからカタログファイルを読み込むのではなく、ビルド時にコンパイルされた辞書からコンテンツを解決します。これは通常、edgeランタイムで問題となる点です。`dictionary.importMode`をデフォルトの`"static"`に保つことで、コンテンツがサーバーにbundleされます。
+
+</Question>
+
+<Question title="このプラグインはElysiaのエンドツーエンドの型推論を維持しますか？">
+
+はい。このプラグインは他のElysia pluginと同様に`.use()`で登録されるため、チェーンされた型は流れ続け、辞書キーは生成された`types/intlayer.d.ts`とは別に型付けされます。
+
+</Question>
+
+<Question title="AIを使用してバックエンドコンテンツを自動的に翻訳するにはどうすればよいですか？">
+
+`npx intlayer fill`を実行すると、選択したLLMと独自のプロバイダーおよびAPI keyを使用して、不足している翻訳が埋められます。`--git-diff`を追加すると、ブランチで変更されたコンテンツのみが翻訳されます。[fillコマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/fill.md)および[CI/CD統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/CI_CD.md)をご覧ください。
+
+</Question>
+
+<Question title="Intlayerはサーバー上で複数形、性別、および補間値をサポートしていますか？">
+
+はい、サポートしています。[複数形](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/plurial.md)、[性別に基づくコンテンツ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/gender.md)、条件、補間値のための[挿入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/insertion.md)、メール本文のための[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/markdown.md)、および数値、日付、通貨のための[フォーマッター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/formatters.md)をサポートしています。
+
+</Question>
+
+<Question title="サーバー上でTypeScriptのオートコンプリートは利用できますか？">
+
+はい。Intlayerは辞書の型を`./types/intlayer.d.ts`に生成するため、存在しないキーは実行時の空文字列ではなく、コンパイルエラーになります。宣言されたロケールにコンテンツが不足している場合にビルドを失敗させるには、CIで`npx intlayer test`を実行してください。
+
+</Question>
+
+<Question title="フロントエンドとバックエンドで同じコンテンツを共有できますか？">
+
+はい、それが通常のセットアップです。`elysia-intlayer`は、`react-intlayer`、`next-intlayer`、`vite-intlayer`と連携して同じ宣言されたコンテンツで動作するため、API responseとページの両方で使用されるラベルは一度だけ宣言されます。[Intlayerの仕組み](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/how_works_intlayer.md)をご覧ください。
+
+</Question>
+
+<Question title="Intlayerは無料でオープンソースですか？">
+
+はい、Apache 2.0ライセンスの下で、商用利用も含まれます。ホストされている[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)はオプションの有料サービスであり、[セルフホスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)することも可能です。
+
+</Question>
+
+</FAQ>

package/docs/ja/intlayer_with_express.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: "Express i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Expressアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -281,3 +281,123 @@ Intlayer によって生成されたファイルは無視することを推奨
 # Intlayer によって生成されたファイルを無視する
 .intlayer
 ```
+
+## よくある質問
+
+<FAQ>
+
+<Question title="Expressバックエンドを国際化するための異なるソリューションは何ですか？">
+
+従来の選択肢は、`i18next`と`i18next-http-middleware`を組み合わせる方法で、名前空間ごとにJSONカタログをロードし、リクエストにロケールを保存します。もう一つの選択肢は、`express-intlayer`を介した`Intlayer`です。これは、フロントエンドと共有される型付きファイルでコンテンツを宣言し、リクエストごとにロケールを解決し、AI翻訳とCMSを追加します。
+
+バックエンドを国際化する理由は、ユーザーが読むテキストの大部分がフロントエンドを通過しないためです。例えば、APIエラーメッセージ、トランザクションメール、プッシュ通知、SMS、PDFエクスポートなどです。これらはセッションごとではなく、リクエストごとに解決される受信者の言語を必要とします。
+
+[Intlayerを選ぶ理由](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/interest_of_intlayer.md)をご覧ください。
+
+</Question>
+
+<Question title="i18nはExpressサーバーのbundleサイズにどれくらい影響しますか？">
+
+ごくわずかです。辞書は事前にコンパイルされ、宣言したロケールのみが含まれるため、起動時のカタログロードやリクエストパスでのファイル読み込みは発生しません。これは、bundleサイズがコールドスタート時間に影響するサーバーレスおよびエッジデプロイメントで特に重要です。
+[bundle最適化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md)をご覧ください。
+
+</Question>
+
+<Question title="`i18next`からハンドラーを書き換えずに移行できますか？">
+
+はい、2つの方法があります。[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)に従って、コンテンツを段階的に移行できます。または、既存のAPIを完全に維持することも可能です。[compat adapters](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は`i18next`とまったく同じAPIを公開しますが、Intlayerの辞書によって提供されるため、インポートは変更されますが、ハンドラーコードは変更されません。
+
+</Question>
+
+<Question title="既存のJSON翻訳ファイルを保持できますか？">
+
+はい、可能です。[sync JSON plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-json.md)は、`/messages/{locale}/{namespace}.json`ファイルを信頼できる情報源として保持し、そこからIntlayer辞書を双方向に生成します。
+[sync PO plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-po.md)はgettextカタログに対しても同様の機能を提供し、[per locale files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)を使用すると、ロケールを1つのファイルにまとめるのではなく、言語ごとにコンテンツを分割できます。
+
+</Question>
+
+<Question title="コンテンツをキーごとに移動する必要がありますか？">
+
+いいえ、必要ありません。`npx intlayer extract`を実行すると、Intlayerがソースファイルを読み込み、ユーザー向けの文字列を抽出し、それぞれの隣に`.content`ファイルを書き込みます。これにより、文字列をカタログに1つずつコピーする代わりに、差分を確認するだけで済みます。
+[extractコマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md)をご覧ください。
+
+同じプロジェクトのフロントエンド側では、[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md)がさらに進んで、ビルド時にJSX、TSX、Vue、またはSvelteのソースから辞書を生成します。これにより、アプリの両半分が手動でキーを管理することなく、1つのコンテンツレイヤーを共有できます。
+
+</Question>
+
+<Question title="利用可能なエディターおよびAIエージェントツールは何ですか？">
+
+以下の5つのツールがあり、すべてオプションです。
+
+- **[VS Code extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer`キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用のIntlayerタブからビルド、フィル、テスト、プッシュ、プルを実行したりできます。
+- **[LSP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**: LSPをサポートする任意のエディターで、定義へのジャンプ、すべての参照の検索、翻訳された値のホバープレビュー、キーとフィールドのオートコンプリート、どこにも宣言されていないキーに対する警告など、同様の認識機能を提供します。また、`i18next`、`react-i18next`、`next-intl`、`use-intl`の呼び出しも解決するため、移行中に役立ちます。
+- **[MCP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**: IntlayerのドキュメントとCLIをCursor、VS Code、Claude Desktop、Claude Code、ChatGPTに公開します。これにより、アシスタントは推測ではなく現在のドキュメントから回答し、`intlayer fill`などのコマンドを自分で実行できます。
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**: `intlayer-config`、`intlayer-cli`、`intlayer-content`などの特化したスキルに加え、フレームワークごとのスキルがあり、エージェントにルーティング設定とコンテンツノードタイプを教えます。
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/eslint.md)**: `no-raw-text`はハードコードされた文字列を検出し、静的辞書キーや未使用コンテンツに対する追加のルールも提供します。
+
+</Question>
+
+<Question title="Intlayerはどの言語で応答するかをどのように判断しますか？">
+
+デフォルトでは、`express-intlayer`は受信リクエストの`Accept-Language` headerを読み取り、最も近い宣言されたロケールを選択し、見つからない場合はデフォルトのロケールにフォールバックします。`routing.storage`を使用してソースを変更できます。例えば、フロントエンドによって設定されたカスタムheaderやcookieを使用することで、APIはブラウザが通知する言語ではなく、ユーザーが実際に選択した言語で応答できます。
+[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)をご覧ください。
+
+</Question>
+
+<Question title="ロケールはリクエストごとに分離されますか？">
+
+はい。middlewareはアクティブなロケールをリクエストにスコープするため、異なる言語の2つの同時リクエストが互いのロケールを読み取ることはありません。これにより、サービスから`t()`や`getIntlayer()`を呼び出す際に、すべての関数にロケール引数を渡す必要がなく、安全に呼び出すことができます。
+
+</Question>
+
+<Question title="受信者の言語でトランザクションメールを送信するにはどうすればよいですか？">
+
+他のコンテンツと同様に、メールコンテンツをコンテンツファイルで宣言し、リクエストロケールではなく、受信者の保存されたロケールに対して`getIntlayer`で解決します。これは、言語がユーザーレコードに属し、headerを読み取るための受信リクエストがないジョブやキューにとって重要です。
+
+</Question>
+
+<Question title="APIエラーメッセージをローカライズするにはどうすればよいですか？">
+
+エラーが構築される時点でメッセージを`t()`でラップします。アクティブなリクエストロケールがそれを解決するため、クライアントは直接表示できるメッセージを受け取り、フロントエンドはエラーコードの並行カタログを必要としません。
+
+</Question>
+
+<Question title="既存のExpressアプリや他のmiddlewareと連携しますか？">
+
+はい。`express-intlayer`は標準的なExpress middlewareであるため、既存のスタックと連携します。コンテンツを読み取るルートの前に登録することで、ハンドラーが`t()`または`getIntlayer()`を呼び出すまでにロケールが解決されます。
+
+</Question>
+
+<Question title="AIを使ってバックエンドコンテンツを自動的に翻訳するにはどうすればよいですか？">
+
+`npx intlayer fill`を実行すると、選択したLLMと独自のプロバイダーおよびAPIキーを使用して、不足している翻訳が自動的に補完されます。`--git-diff`を追加すると、ブランチで変更されたコンテンツのみを翻訳できます。
+[fillコマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/fill.md)および[CI/CD統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/CI_CD.md)をご覧ください。
+
+</Question>
+
+<Question title="Intlayerはサーバー上で複数形、性別、補間値をサポートしていますか？">
+
+はい、サポートしています。[複数形](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/plurial.md)、[性別に基づくコンテンツ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/gender.md)、条件、補間値のための[挿入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/insertion.md)、メール本文のための[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/markdown.md)、そして数値、日付、通貨のための[フォーマッター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/formatters.md)に対応しています。
+
+</Question>
+
+<Question title="サーバー上でTypeScriptのオートコンプリートは利用できますか？">
+
+はい。Intlayerは辞書の型を`./types/intlayer.d.ts`に生成するため、存在しないキーは実行時に空の文字列になるのではなく、コンパイルエラーになります。CIで`npx intlayer test`を実行すると、宣言されたロケールにコンテンツが不足している場合にビルドを失敗させることができます。
+
+</Question>
+
+<Question title="フロントエンドとバックエンドで同じコンテンツを共有できますか？">
+
+はい、可能です。それが一般的な設定です。`express-intlayer`は、`react-intlayer`、`next-intlayer`、`vite-intlayer`と連携して同じ宣言されたコンテンツで動作するため、APIレスポンスとページの両方で使用されるラベルは一度だけ宣言されます。
+[Intlayerの仕組み](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/how_works_intlayer.md)をご覧ください。
+
+</Question>
+
+<Question title="Intlayerは無料でオープンソースですか？">
+
+はい、Apache 2.0ライセンスの下で、商用利用も含まれます。ホストされている[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)はオプションの有料サービスですが、[セルフホスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)することも可能です。
+
+</Question>
+
+</FAQ>

package/docs/ja/intlayer_with_fastify.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: "Fastify i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Fastifyアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -279,3 +279,117 @@ Intlayerによって生成されたファイルは無視することをお勧め
 .intlayer
 
 ```
+
+## よくある質問
+
+<FAQ>
+
+<Question title="Fastify バックエンドを国際化するために利用可能なソリューションにはどのようなものがありますか？">
+
+一般的なオプションは `i18next` と `fastify-i18next` またはカスタムで書かれた hook で、名前空間ごとに JSON カタログを読み込み、ロケールをリクエストに保存します。別のオプションは `fastify-intlayer` を通じた `Intlayer` で、プラグインを自動的に登録し、リクエストごとにロケールを解決し、フロントエンドと同じ型付きコンテンツを共有します。
+
+バックエンドを国際化する理由は、ユーザーが読むテキストの大部分がフロントエンドを通過しないためです。API エラーメッセージ、トランザクションメール、プッシュ通知、SMS、PDF エクスポートなどです。これらは受信者の言語が必要で、セッションごとではなくリクエストごとに解決される必要があります。
+
+[Intlayer を選ぶ理由](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/interest_of_intlayer.md)を参照してください。
+
+</Question>
+
+<Question title="i18n は Fastify サーバーのバンドルサイズにどの程度の影響を与えますか？">
+
+非常に少ないです。辞書はビルド時にコンパイルされ、宣言したロケールのみが含まれるため、ブート時のカタログ読み込みやリクエストパス上のファイル読み込みはありません。これは特にサーバーレスおよびエッジデプロイメントで重要です。バンドルサイズはコールドスタート時間に影響します。[バンドル最適化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md)を参照してください。
+
+</Question>
+
+<Question title="`i18next` からハンドラーを書き直さずに移行できますか？">
+
+はい、2 つのパスがあります。[i18next 移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)を使用してコンテンツを段階的に移行できます。または、現在の API を完全に保つことができます。[互換性アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は `i18next` と同じ API を公開しますが、Intlayer 辞書によって提供されるため、インポートは変わりますがハンドラーコードは変わりません。
+
+</Question>
+
+<Question title="既存の JSON 翻訳ファイルを保持できますか？">
+
+はい。[sync JSON プラグイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-json.md)は `/messages/{locale}/{namespace}.json` ファイルを信頼できるソースとして保持し、Intlayer 辞書を双方向で生成します。[sync PO プラグイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-po.md)は gettext カタログに対して同じことを行い、[ロケールごとのファイル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)ではロケールを 1 つのファイルにグループ化する代わりに言語で分割できます。
+
+</Question>
+
+<Question title="コンテンツをキーごとに移動する必要がありますか？">
+
+いいえ。`npx intlayer extract` を実行すると、Intlayer はソースファイルを読み込み、ユーザーが見える文字列を抽出し、各ファイルの隣に `.content` ファイルを書き込むため、文字列をカタログに 1 つずつコピーする代わりに diff をレビューできます。[extract コマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md)を参照してください。
+
+同じプロジェクトのフロントエンド側では、[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md)はさらに進んで、JSX、TSX、Vue または Svelte ソースからビルド時に辞書を生成するため、アプリの両側は手動で管理されたキーなしで 1 つのコンテンツレイヤーを共有します。
+
+</Question>
+
+<Question title="利用可能なエディターと AI エージェントツールは何ですか？">
+
+5 つのツールがあり、すべてオプションです。
+
+- **[VS Code 拡張機能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer` キーからそれを宣言するコンテンツファイルにジャンプし、コンポーネントからコンテンツを抽出し、コマンドパレットまたは専用 Intlayer タブからビルド、fill、test、push、pull を実行します。
+- **[LSP サーバー](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**: LSP に対応した任意のエディターで同じ認識を提供し、定義へのジャンプ、すべての参照を検索、翻訳値のホバープレビュー、キーとフィールドのオートコンプリート、キーが宣言されていない場合の警告があります。また、`i18next`、`react-i18next`、`next-intl`、`use-intl` の呼び出しも解決し、移行中に役立ちます。
+- **[MCP サーバー](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**: Intlayer ドキュメントと CLI を Cursor、VS Code、Claude Desktop、Claude Code、ChatGPT に公開するため、アシスタントは推測する代わりに現在のドキュメントから回答でき、`intlayer fill` などのコマンドを自分で実行できます。
+- **[エージェントスキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**: `intlayer-config`、`intlayer-cli`、`intlayer-content` などの焦点を絞ったスキル、およびフレームワークごとに 1 つのスキルがあり、エージェントにルーティング設定とコンテンツノードタイプを教えます。
+- **[ESLint プラグイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/eslint.md)**: `no-raw-text` はハードコードされた文字列にフラグを立て、静的辞書キーと未使用コンテンツの追加ルールがあります。
+
+</Question>
+
+<Question title="Intlayer はどの言語で応答するかをどのように知っていますか？">
+
+デフォルトでは `fastify-intlayer` は受信リクエストの `Accept-Language` ヘッダーを読み込み、最も近い宣言されたロケールを選択し、デフォルトロケールにフォールバックします。`routing.storage` でソースを変更できます。例えば、カスタムヘッダーまたはフロントエンドで設定された cookie を使用して、API がブラウザーが宣伝する言語ではなく、ユーザーが実際に選択した言語で応答するようにできます。[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
+
+</Question>
+
+<Question title="ロケールはリクエストごとに分離されていますか？">
+
+はい。プラグインはアクティブなロケールをリクエストにスコープするため、異なる言語の 2 つの同時リクエストが互いのロケールを読み込むことはありません。これにより、`t()` と `getIntlayer()` をサービスから呼び出すことが安全になり、すべての関数を通じてロケール引数をスレッド化する必要がなくなります。
+
+</Question>
+
+<Question title="受信者の言語でトランザクションメールを送信するにはどうすればよいですか？">
+
+他のコンテンツと同様にメールコンテンツをコンテンツファイルで宣言し、リクエストロケールではなく受信者の保存されたロケールに対して `getIntlayer` で解決します。これはジョブとキューで重要です。言語はユーザーレコードに属し、ヘッダーを読み込むための受信リクエストがないためです。
+
+</Question>
+
+<Question title="API エラーメッセージをローカライズするにはどうすればよいですか？">
+
+メッセージをエラーが構築される時点で `t()` でラップします。アクティブなリクエストロケールがそれを解決するため、クライアントは直接表示できるメッセージを受け取り、フロントエンドはエラーコードの並列カタログを必要としません。
+
+</Question>
+
+<Question title="Fastify プラグインのライフサイクルとカプセル化で機能しますか？">
+
+はい。`fastify-intlayer` は標準 Fastify プラグインとして登録されるため、通常のカプセル化ルールに従います。ルートで登録するか、それを必要とするスコープ内で、コンテンツを読み込むルートの前に登録します。
+
+</Question>
+
+<Question title="バックエンドコンテンツを AI で自動的に翻訳するにはどうすればよいですか？">
+
+`npx intlayer fill` を実行します。これにより、選択した LLM を使用して、独自のプロバイダーと API キーで不足している翻訳を入力します。`--git-diff` を追加して、ブランチで変更されたコンテンツのみを翻訳します。[fill コマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/fill.md)と [CI/CD 統合](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/CI_CD.md)を参照してください。
+
+</Question>
+
+<Question title="Intlayer はサーバー上で複数形、性別、補間値をサポートしていますか？">
+
+はい。[複数形](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/plurial.md)、[性別ベースのコンテンツ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/gender.md)、条件、補間値の[挿入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/insertion.md)、メール本文の [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/markdown.md)、および数値、日付、通貨の[フォーマッター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/formatters.md)があります。
+
+</Question>
+
+<Question title="サーバーで TypeScript オートコンプリートを取得できますか？">
+
+はい。Intlayer は辞書の型を `./types/intlayer.d.ts` に生成するため、存在しないキーはランタイムの空の文字列ではなくコンパイルエラーになります。CI で `npx intlayer test` を実行して、宣言されたロケールがコンテンツを欠いている場合にビルドを失敗させます。
+
+</Question>
+
+<Question title="フロントエンドとバックエンドが同じコンテンツを共有できますか？">
+
+はい、これが通常のセットアップです。`fastify-intlayer` は同じ宣言されたコンテンツで `react-intlayer`、`next-intlayer`、`vite-intlayer` と並行して機能するため、API レスポンスとページの両方で使用されるラベルは 1 回だけ宣言されます。[Intlayer の仕組み](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/how_works_intlayer.md)を参照してください。
+
+</Question>
+
+<Question title="Intlayer は無料でオープンソースですか？">
+
+はい、Apache 2.0 ライセンスの下で、商用利用を含みます。ホストされた [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md) はオプションの有料サービスで、[セルフホスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)することもできます。
+
+</Question>
+
+</FAQ>