@intlayer/docs 9.4.0 → 9.4.2

package/docs/ja/how_works_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-12
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Intlayerの仕組み
 description: Intlayerが内部でどのように機能するかを学びます。Intlayerを強力にするアーキテクチャとコンポーネントを理解しましょう。
 keywords:
@@ -260,3 +260,95 @@ Expressに基づいたサーバーは、ビジュアルエディターのリク
 ## スマートドキュメントとチャットする
 
 - [スマートドキュメントに質問する](https://intlayer.org/doc/chat)
+
+## よくある質問
+
+<FAQ>
+
+<Question title="辞書はビルド時とランタイム時のどちらで構築されますか？">
+
+ビルド時です。bundler plugin、または `npx intlayer build` は、`.content.ts` ファイルをスキャンし、それらを `.intlayer` フォルダー内の辞書に解決し、対応するTypeScript型を生成します。ランタイム時には、コンポーネントは結果を読み取るだけなので、リクエストパス上でパースやファイルの読み込みは発生しません。
+
+</Question>
+
+<Question title="i18nは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="コンポーネントを書き直さずに、`i18next`、`next-intl`、`react-i18next` から移行できますか？">
+
+はい、2つの方法があります。[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)または[next-intl移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_next-intl_to_intlayer.md)を使用して、コンテンツを段階的に移行できます。または、現在のAPIを完全に維持することもできます。[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は、`i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n`、`Lingui` とまったく同じAPIを公開しますが、Intlayer辞書によって提供されるため、importは変更されますが、コンポーネントコードは変更されません。
+
+</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つずつコピーする代わりに、差分を確認できます。[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のソースに対してビルド時に同じ処理を行い、変更があるたびに辞書を生成するため、手動でキーを管理する必要がありません。これは静的解析によって機能するため、ランタイム時にのみ存在する文字列は対象外となり、ユーザー向けのテキストとアプリケーションロジックを区別するためにいくつかのannotationが必要です。
+
+</Question>
+
+<Question title="利用可能なエディターおよびAIエージェントツールは何ですか？">
+
+5つのツールがあり、すべてオプションです。
+
+- **[VS Code extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer` キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用のIntlayerタブからbuild、fill、test、push、pullを実行したりできます。
+- **[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フォルダーとは何ですか？コミットすべきですか？">
+
+これは生成された出力であり、コンパイルされた辞書と生成された型が含まれます。コンテンツファイルから派生するため、`.gitignore` にリストし、`dist` フォルダーとまったく同じようにビルドステップで再構築されるべきです。
+
+</Question>
+
+<Question title="アクティブなロケールはどのように決定されますか？">
+
+`routing.storage` にリストされているソースから、次の順序で決定されます: `routing.mode` がURL prefixを使用する場合のそれ、次にcookie、次に`Accept-Language` header、そしてデフォルトのロケールです。ユーザーが明示的に選択したロケールは永続化され、次回の訪問時にも維持されます。[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
+
+</Question>
+
+<Question title="ローカル辞書とリモート辞書の違いは何ですか？">
+
+ローカル辞書はコードベースで宣言され、アプリケーションとともにコンパイルされます。リモート辞書は[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)で管理され、ランタイム時に解決されるため、デプロイなしで変更できます。どちらも同じhooksを通じて読み取られ、リモートコンテンツが利用できない場合はローカル宣言にフォールバックします。
+
+</Question>
+
+<Question title="IntlayerはTypeScriptなしで動作しますか？">
+
+はい。コンテンツファイルはTypeScript、JavaScript、ESM、CommonJS、またはJSONで記述できます。TypeScriptは生成された型とオートコンプリートを可能にするため、推奨されるセットアップですが、必須ではありません。
+
+</Question>
+
+<Question title="サーバーレンダリングとクライアントレンダリングはどのように同じコンテンツを共有しますか？">
+
+サーバーはサーバーレンダリングされたコンポーネントのコンテンツを直接解決するため、そのマークアップに対して辞書がクライアントに送信されることはありません。クライアントコンポーネントは、サーバーで解決されたロケールを受け取るproviderを通じて同じ辞書を読み取ります。これにより、最初のクライアントレンダリングはサーバーHTMLと一致し、異なる言語がちらつくことはありません。
+
+</Question>
+
+<Question title="Intlayerはロケールでのhydrationミスマッチをどのように回避しますか？">
+
+ロケールはサーバーで一度解決され、providerに渡されます。ブラウザで再度検出されることはありません。クライアントはサーバーがレンダリングしたのと同じロケールから開始するため、マークアップが一致します。これは通常、クライアント側のロケール検出で問題となる点です。
+
+</Question>
+
+<Question title="翻訳を追加するたびに再ビルドする必要がありますか？">
+
+開発環境では、いいえ。pluginはコンテンツファイルを監視し、保存時に影響を受ける辞書を再ビルドします。本番環境では、コンテンツがリモートでない限り、辞書はビルドの一部です。リモートコンテンツの場合は、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)と[live sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/live.md)がデプロイなしで変更を適用します。
+
+</Question>
+
+</FAQ>

package/docs/ja/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: Intlayerの重要性
 description: プロジェクトでIntlayerを使用するメリットと利点をご紹介します。他のフレームワークの中でIntlayerが選ばれる理由を理解しましょう。
 keywords:
@@ -39,18 +39,17 @@ author: aymericzip
 `next-intl`や`i18next`などの主要なソリューションと比較して、Intlayerは以下のような統合された最適化を備えたソリューションです：
 
 <AccordionGroup>
-
-**バンドルサイズ**
+<Accordion header="バンドルサイズ">
 
 ページに巨大なJSONファイルを読み込む代わりに、必要なコンテンツのみを読み込みます。Intlayerは**バンドルサイズとページサイズを最大50%削減**するのに役立ちます。
 
-**メンテナンス性**
+</Accordion>
 
 <Accordion header="保守性">
 
 アプリケーションのコンテンツのスコープを限定することで、大規模アプリケーションの**メンテナンスが容易**になります。全体のコンテンツコードベースを見直す精神的負担なしに、単一の機能フォルダを複製または削除できます。さらに、Intlayerは**完全に型定義**されているため、コンテンツの正確性が保証されます。
 
-**AIエージェント**
+</Accordion>
 
 <Accordion header="AI Agent">
 
@@ -58,29 +57,29 @@ author: aymericzip
 
 </Accordion>
 
-**機能性**
+<Accordion header="機能性">
 
 Intlayerは、他のi18nソリューションにはない、[Markdownサポート](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/markdown.md)、[外部コンテンツの取得](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/function_fetching.md)、[ファイルコンテンツの読み込み](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/file.md)、[ライブコンテンツ更新](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/live.md)、[ビジュアルエディタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)など、多くの追加機能を提供します。
 
 </Accordion>
 
-**自動化**
+<Accordion header="自動化">
 
 CI/CDパイプラインでお好みのLLMを使用し、AIプロバイダーの実費で自動翻訳を行います。Intlayerはコンテンツ抽出を自動化する**コンパイラ**や、**バックグラウンドで翻訳**をサポートする[ウェブプラットフォーム](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)も提供しています。
 
-**パフォーマンス**
+</Accordion>
 
 <Accordion header="パフォーマンス">
 
 巨大なJSONファイルをコンポーネントに接続すると、パフォーマンスやリアクティビティの問題が発生する可能性があります。Intlayerはビルド時にコンテンツの読み込みを最適化します。
 
-**非開発者とのスケーリング**
+</Accordion>
 
 <Accordion header="非開発環境でのスケーリング">
 
 単なるi18nソリューションにとどまらず、Intlayerはセルフホスト可能な**[ビジュアルエディタ](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)**を提供し、多言語コンテンツを**リアルタイム**で管理できるようにします。これにより、翻訳者、コピーライター、その他のチームメンバーとのコラボレーションがシームレスになります。コンテンツはローカルおよび/またはリモートに保存できます。
 
-**クロスフレームワーク設計**
+</Accordion>
 
 <Accordion header="クロスフレームワークデザイン">
 
@@ -88,6 +87,8 @@ CI/CDパイプラインでお好みのLLMを使用し、AIプロバイダーの
 
 アプリケーションの異なる部分で異なるフレームワークを使用している場合（例：React、React-Native、Vue、Angular、Svelteなど）、Intlayerは**すべての主要なフロントエンドフレームワークで共通の構文と実装を使用する方法**を提供します。また、デザインシステム、アプリ、バックエンドなどでコンテンツ宣言を共有することもできます。
 
+</Accordion>
+</AccordionGroup>
 ## なぜIntlayerが作られたのか？
 
 Intlayerは、`next-intl`、`react-i18next`、`react-intl`、`next-i18next`、`vue-i18n`など、すべての一般的なi18nライブラリに影響を与える共通の課題を解決するために作成されました。
@@ -291,3 +292,99 @@ GitHubスター数は、プロジェクトの知名度、コミュニティか
 `intlayer`を使用すると、お気に入りのi18nライブラリの形式でコンテンツを宣言でき、intlayerは任意の場所に名前空間を生成します（例：`/messages/{{locale}}/{{namespace}}.json`）。
 
 現在の i18n ライブラリの API を使い続けたい場合、`intlayer` は **互換アダプター（compat adapters）** も提供しています。これは `react-i18next`、`next-intl`、`react-intl`、`vue-i18n` などとまったく同じ API を公開しつつ、内容は Intlayer の辞書から提供されるパッケージです。これにより、コードを書き直すことなく段階的に移行できます。[互換アダプターのドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md)をご覧ください。
+
+## よくある質問
+
+<FAQ>
+
+<Question title="JavaScriptアプリを国際化するための異なるソリューションにはどのようなものがありますか？">
+
+3つの世代が共存しています。
+
+- **ランタイムカタログライブラリ**: `i18next`、`react-i18next`、`next-i18next`、`vue-i18n`、`ngx-translate`、`svelte-i18n`。ランタイムにJSON名前空間をロードします。成熟しており、フレームワークに依存せず、型付けされておらず、ページ全体に提供されます。
+- **コンパイル時メッセージライブラリ**: `Lingui`、`Paraglide`、および抽出ステップを伴う`next-intl`または`react-intl`。より良いbundle動作と部分的な型付けを提供しますが、依然として集中型カタログです。
+- **コンテンツレイヤーライブラリ**: `Intlayer`。コンテンツはコンポーネントごとに宣言およびコンパイルされるため、型付け、tree shaking、編集ツール、AI翻訳はすべて同じ宣言から得られます。
+
+</Question>
+
+<Question title="i18nは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="`i18next`、`next-intl`、または`react-i18next`からコンポーネントを書き直さずに移行できますか？">
+
+はい、2つの方法があります。[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)または[next-intl移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_next-intl_to_intlayer.md)を使用して、コンテンツを段階的に移行できます。または、現在のAPIを完全に維持することもできます。[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は、`i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n`、および`Lingui`とまったく同じ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つずつコピーする代わりに、差分を確認できます。[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のソースに対してビルド時に同じ処理を行い、変更があるたびに辞書を生成するため、手動でキーを管理する必要がありません。これは静的解析によって機能するため、ランタイムにのみ存在する文字列は対象外となり、ユーザー向けのテキストとアプリケーションロジックを区別するためにいくつかの注釈が必要です。
+
+</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はnext-intlとどう違いますか？">
+
+`next-intl`はNext.js用のメッセージレイヤーです。ロケールごとにJSONメッセージファイルを保持し、`useTranslations`を通じてそれらを読み取ります。Intlayerはコンテンツレイヤーです。宣言はコンポーネントの隣に配置され、宣言自体から型付けされ、コンポーネントごとにコンパイルされるため、ページはレンダリングするものだけを提供します。Intlayerは、`next-intl`がユーザーに任せるAI翻訳、ビジュアルエディター、CMS、CIでの翻訳漏れチェックもカバーします。`next-intl` APIを維持したい場合は、[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)がIntlayer辞書からそれを提供します。
+
+</Question>
+
+<Question title="Intlayerはi18nextおよびreact-i18nextとどう違いますか？">
+
+`i18next`はランタイムに名前空間に対して文字列キーを解決します。これは、キーの名前変更やスペルミスがサイレントに失敗し、ページが触れるすべての名前空間が完全にダウンロードされることを意味します。Intlayerはビルド時に生成された型に対してコンテンツを解決するため、不正なキーはコンパイルエラーとなり、コンポーネントがレンダリングするエントリのみがbundleに含まれます。`i18next`はより大きなプラグインエコシステムと長い実績を持っています。Intlayerは型付け、bundleサイズ、および編集・自動化ツールを提供します。[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)または[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)を参照してください。
+
+</Question>
+
+<Question title="Intlayerは他の代替手段よりも高速または軽量ですか？">
+
+bundleサイズとページサイズに関しては、はい。ページがレンダリングしないカタログをロードしないことで、名前空間ベースのセットアップと比較してbundleサイズとページサイズを最大50%削減します。[ベンチマーク](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/index.md)では、[Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/nextjs.md)、[TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/tanstack.md)、[Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/vue.md)、[Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/svelte.md)を含むフレームワークごとの方法と数値が公開されているため、主張を鵜呑みにするのではなく、ご自身で再現できます。
+
+</Question>
+
+<Question title="既存のアプリを移行する価値はありますか？">
+
+それは現在の課題によります。もしbundleサイズ、サイレントな翻訳漏れ、または開発者なしでは作業できない翻訳者が課題であれば、移行する価値は十分にあります。カタログが小さく安定している場合は、得られるメリットは小さくなります。いずれにしても、移行は書き直しである必要はありません。[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は現在のAPIを維持し、[sync JSON plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-json.md)は両方のレイヤーが共存する間、既存のJSONファイルを信頼できる情報源として保持します。
+
+</Question>
+
+<Question title="Intlayerが他のi18nライブラリにはない機能は何ですか？">
+
+[Markdown content](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/markdown.md)、[外部ソースからフェッチされたコンテンツ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)、ファイルコンテンツのロード、[ライブコンテンツ更新](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/live.md)、[ビジュアルエディター](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)、既存のコンポーネントからコンテンツを抽出する[コンパイラ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md)、A/Bテスト用の[コンテンツバリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md)、コンテンツ露出に関する[アナリティクス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/analytics.md)、[MCP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)、[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)および[エージェントスキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)。
+
+</Question>
+
+<Question title="Intlayerを翻訳マネージャーとしてのみ使用し、現在のライブラリを保持できますか？">
+
+はい。Intlayerは、現在のライブラリが期待する形式と場所（例：`/messages/{locale}/{namespace}.json`）で名前空間を生成できます。これにより、アプリケーションコードが既存のi18nライブラリを使い続ける間も、AI翻訳、エディター、CIチェックを利用できます。
+
+</Question>
+
+<Question title="Intlayerは無料でオープンソースですか？">
+
+はい、Apache 2.0 licenseの下で、商用利用も含まれます。ホスト型CMSはオプションの有料サービスですが、[セルフホスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)することも可能です。
+
+</Question>
+
+</FAQ>

package/docs/ja/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-07-08
+updatedAt: 2026-08-30
 title: Intlayer CMS | コンテンツをIntlayer CMSに外部化する
 description: コンテンツ管理をチームに委任するために、コンテンツをIntlayer CMSに外部化します。
 keywords:
@@ -434,3 +434,95 @@ CMSで問題が発生した場合は、以下を確認してください：
 - プロジェクトの設定がIntlayer CMSにプッシュされていることを確認してください。
 
 - ビジュアルエディターはiframeを使用してウェブサイトを表示します。ウェブサイトのコンテンツセキュリティポリシー（CSP）がCMSのURLを `frame-ancestors`（デフォルトは 'https://app.intlayer.org'）として許可していることを確認してください。エディターのコンソールでエラーがないか確認してください。
+
+## よくある質問
+
+<FAQ>
+
+<Question title="Intlayer CMS とビジュアルエディターの違いは何ですか？">
+
+[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md) はローカル辞書を編集し、その変更をコードベースに書き戻します。これにより、アプリが再ビルドされ、通常のレビューとデプロイのプロセスを経て変更が適用されます。CMS はリモート辞書を編集します。変更はコードベースに触れず、実行中のサイトはデプロイなしで変更を反映します。チームはしばしば両方を使用します。開発者が所有するコンテンツにはエディターを、マーケティングが毎週変更するコンテンツには CMS を使用します。
+
+</Question>
+
+<Question title="i18n は 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="コンポーネントを書き直すことなく、`i18next`、`next-intl`、`react-i18next` から移行できますか？">
+
+はい、2つの方法があります。[i18next 移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md) または [next-intl 移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_next-intl_to_intlayer.md) を使用して、コンテンツを段階的に移行できます。または、現在の API を完全に維持することもできます。[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md) は、`i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n`、および `Lingui` とまったく同じ API を公開しますが、Intlayer 辞書によって提供されるため、import は変更されますが、コンポーネントコードは変更されません。
+
+</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つずつコピーする代わりに、差分を確認できます。[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 のソースに対してビルド時に同じ処理を行い、変更があるたびに辞書を生成するため、手動でキーを管理する必要がありません。これは静的解析によって機能するため、実行時にのみ存在する文字列は対象外となり、ユーザー向けのテキストとアプリケーションロジックを区別するためにいくつかの注釈が必要です。
+
+</Question>
+
+<Question title="利用可能なエディターおよび AI エージェントツールは何ですか？">
+
+5つのツールがあり、すべてオプションです。
+
+- **[VS Code extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer` キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用の Intlayer タブから build、fill、test、push、pull を実行したりできます。
+- **[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="どのコンテンツを CMS に移動すべきですか？">
+
+頻繁に変更され、リリースに属さないコンテンツ、例えばランディングページのコピー、価格設定の文言、お知らせ、マーケティングチームが所有するあらゆるものなどです。ボタンのラベルやフォームのエラーなど、インターフェースの一部であるコンテンツは、それを使用するコードと一緒にレビューされるローカル辞書として残しておく方が良いでしょう。
+
+</Question>
+
+<Question title="CMS にアクセスできない場合、どうなりますか？">
+
+アプリケーションは辞書のローカル宣言にフォールバックするため、ネットワーク障害や停止が発生しても、空のページではなく、ビルドに含まれるコンテンツに切り替わります。これが、すべてのリモート辞書に対してローカル宣言を保持することが重要である理由です。
+
+</Question>
+
+<Question title="CMS をセルフホストできますか？">
+
+はい。CMS は独自のインフラストラクチャで実行できます。これは、コンテンツがネットワーク外に出るべきではない場合の一般的な解決策です。[Intlayer のセルフホスティング](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md) を参照してください。
+
+</Question>
+
+<Question title="コンテンツ編集者は変更を公開するために開発者を必要としますか？">
+
+いいえ。それがリモート辞書の利点です。編集者が CMS でテキストを変更すると、サイトにそれが反映され、[ライブ同期](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/live.md) によってビルドを待つことなく実行時に更新が適用されます。
+
+</Question>
+
+<Question title="インターフェースを使用する代わりに CMS を自動化できますか？">
+
+はい。`@intlayer/api` SDK はインターフェースと同じエンドポイントを公開しているため、スクリプトやパイプラインからプロジェクトの取得、辞書の読み取り、更新のプッシュが可能です。上記のセクションでは、認証機能とエンドポイントについて説明しています。
+
+</Question>
+
+<Question title="CMS は A/B テスト翻訳をサポートしていますか？">
+
+はい。リモート辞書は [コンテンツバリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md) をサポートしており、[アナリティクス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/analytics.md) は各バリアントがどのように公開されているかを報告するため、文言の変更について議論するのではなく、測定することができます。
+
+</Question>
+
+<Question title="CMS は無料ですか？">
+
+Intlayer ライブラリ、CLI、コンパイラ、およびビジュアルエディターは、Apache 2.0 license の下で無料かつオープンソースです。ホスト型 CMS はオプションの有料サービスであり、代わりに [セルフホスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md) することも可能です。
+
+</Question>
+
+</FAQ>

package/docs/ja/intlayer_visual_editor.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Intlayerビジュアルエディター | ビジュアルエディターを使用してコンテンツを編集します
 description: Intlayerエディターを使用して多言語ウェブサイトを管理する方法を発見してください。このオンラインドキュメントの手順に従って、数分でプロジェクトを設定することができます。
 keywords:
@@ -210,4 +210,90 @@ pnpm intlayer-editor start -e development
   - 必須フィールド:
     - アプリケーション URL はエディタ設定 (`applicationURL`) に設定したものと一致する必要があります。
 
-- ビジュアルエディターは iframe を使用してウェブサイトを表示します。ウェブサイトのコンテンツセキュリティポリシー（CSP）が CMS の URL を `frame-ancestors` として許可していることを確認してください（デフォルトは 'http://localhost:8000'）。エディターのコンソールでエラーがないか確認してください。
+- ビジュアルエディターは iframe を使用してウェブサイトを表示します。ウェブサイトのコンテンツセキュリティポリシー（CSP）が CMS の URL を `frame-ancestors` として許可していることを確認してください（デフォルトは `http://localhost:8000`）。エディターのコンソールでエラーがないか確認してください。
+
+## よくある質問
+
+<FAQ>
+
+<Question title="ビジュアルエディターとCMSの違いは何ですか？">
+
+ビジュアルエディターはローカル辞書を編集し、その変更をコードベースに書き戻すため、通常のレビューとデプロイメントのプロセスを経ます。[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md) はリモート辞書を編集し、デプロイメントなしで実行中のサイトに変更を反映させます。エディターは開発者が所有するコンテンツに適しており、CMSはマーケティングチームが所有するコンテンツに適しています。
+
+</Question>
+
+<Question title="i18nはバンドルサイズにどのくらい影響しますか？">
+
+名前空間ベースのセットアップよりもはるかに少なく、ページはレンダリングしないカタログをダウンロードすることはありません。サーバーでレンダリングされたマークアップはサーバー上でコンテンツを解決し、ビルド時コンパイラは `useIntlayer` の呼び出しをコンポーネントが使用する正確な辞書エントリに置き換えるため、未使用のキーや未使用の言語は削除されます。[動的辞書](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md) は残りをロケールごとに分割します。一般的な代替手段と比較して、Intlayerはbundleサイズとページサイズを最大50%削減します。[バンドル最適化](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="`i18next`、`next-intl`、`react-i18next` からコンポーネントを書き換えずに移行できますか？">
+
+はい、2つの方法があります。[i18next移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md) または [next-intl移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_next-intl_to_intlayer.md) を使用して、コンテンツを段階的に移行できます。または、現在のAPIを完全に維持することもできます。[互換アダプター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md) は、`i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n`、`Lingui` とまったく同じ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つずつコピーする代わりに、差分をレビューできます。[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のソースに対してビルド時に同じ処理を行い、変更があるたびに辞書を生成するため、手動でキーを管理する必要はありません。これは静的解析によって機能するため、実行時にのみ存在する文字列は対象外となり、ユーザー向けのテキストとアプリケーションロジックを区別するためにいくつかの注釈が必要です。
+
+</Question>
+
+<Question title="利用可能なエディターとAIエージェントのツールは何ですか？">
+
+5つのツールがあり、すべてオプションです。
+
+- **[VS Code拡張機能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer` キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用のIntlayerタブからビルド、フィル、テスト、プッシュ、プルを実行したりできます。
+- **[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` などの特化されたスキルに加え、フレームワークごとのスキルがあり、エージェントにルーティング設定とコンテンツノードタイプを教えます。
+- **[ESLintプラグイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/eslint.md)**: `no-raw-text` はハードコードされた文字列を検出し、静的辞書キーと未使用のコンテンツに関する追加のルールを提供します。
+
+</Question>
+
+<Question title="ビジュアルエディターはどこで実行されますか？">
+
+お客様自身のインフラストラクチャ上で実行されます。アプリケーションをiframe内にロードし、ローカルのエディターサーバーと通信するため、コンテンツがお客様の環境を離れることはありません。これにより、ホスト型サービスにコピーを送信できないプロジェクトでも利用できます。
+
+</Question>
+
+<Question title="エディターはコードの知識が必要ですか？">
+
+いいえ。彼らはサイトを開き、テキストの一部をクリックしてその場で編集します。エディターは、そのテキストを裏付ける辞書エントリを解決し、適切なコンテンツファイルに変更を書き込むため、翻訳者はファイルを見つけたりキーを知る必要はありません。
+
+</Question>
+
+<Question title="ビジュアルエディターでの編集はソースファイルを変更しますか？">
+
+はい、それが意図するところです。変更はコードベース内のコンテンツ宣言ファイルに反映されるため、通常の差分としてレビューおよびコミットでき、アプリケーションはそれを表示するために再ビルドされます。
+
+</Question>
+
+<Question title="エディターが空白ページを表示したり、サイトの読み込みを拒否したりします。何を確認すべきですか？">
+
+エディターはアプリケーションをiframe内に表示するため、Content Security Policyでエディターのオリジンを `frame-ancestors` として許可する必要があります。デフォルトでは `http://localhost:8000` です。また、エディター設定の `applicationURL` が、実際にアプリが提供されているURLと一致していることを確認してください。エディターのコンソールは両方の失敗を報告します。
+
+</Question>
+
+<Question title="ビジュアルエディターを本番環境で使用できますか？">
+
+これは開発環境およびステージング環境向けに設計されており、編集後の再ビルドが許容される場合に適しています。デプロイメントなしでライブサイトのコンテンツを編集するには、代わりに[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md) とそのリモート辞書を使用してください。
+
+</Question>
+
+<Question title="ビジュアルエディターは無料ですか？">
+
+はい。ビジュアルエディターはオープンソースプロジェクトの一部であり、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>