@intlayer/docs 8.11.1 → 8.11.3

package/docs/ja/intlayer_with_tanstack+solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-03-25
-updatedAt: 2026-05-06
-title: Tanstack Start i18n - 2026年にSolid.jsを使用してTanstack Startアプリを翻訳する方法
-description: IntlayerとSolid.jsを使用して、Tanstack Startアプリケーションに国際化（i18n）を追加する方法を学びます。この包括的なガイドに従って、ロケール対応ルーティングを備えた多言語アプリを作成してください。
+updatedAt: 2026-05-31
+title: Tanstack Start i18n - 完全な翻訳ガイド： TanStack Start
+description: バンドルサイズ、SEO、パフォーマンス、保守性のための最良のソリューション。2026年にTanStack Start and Solid アプリを多言語化しましょう。LLM翻訳、Agent Skills & MCP。
 keywords:
   - 国際化
   - ドキュメント
@@ -38,17 +38,37 @@ history:
 
 このガイドでは、Solid.jsを使用したTanstack Startプロジェクトにおいて、Intlayerを統合してシームレスな国際化、ロケール対応ルーティング、TypeScriptサポート、および現代的な開発手法を実現する方法を説明します。
 
-## Intlayerとは？
+## 代替手段ではなく Interlayer を使用する理由
 
-**Intlayer**は、現代的なウェブアプリケーションにおける多言語サポートを簡素化するために設計された、革新的でオープンソースの国際化（i18n）ライブラリです。
+「react-i18next」や「i18next」などの主要なソリューションと比較して、Intlayer は次のような統合された最適化を備えたソリューションです。
 
-Intlayerを使用すると、以下のことが可能になります：
+**TanStack Start を完全にカバー**
 
-- コンポーネントレベルで宣言的な辞書を使用して、**翻訳を簡単に管理**できます。
-- メタデータ、ルート、コンテンツを**動的にローカライズ**できます。
-- 自動生成された型により**TypeScriptサポートを確保**し、オートコンプリートとエラー検出を向上させます。
-- 動的なロケール検出や切り替えなどの**高度な機能の恩恵**を受けられます。
-- Tanstack Startのファイルベースルーティングシステムを使用して、**ロケール対応ルーティングを有効化**できます。
+Intlayer は、**多言語ルーティング**、**サイトマップ**、および国際化の拡張 (i18n) に必要なすべての機能を提供することにより、TanStack Start および Solid と完全に連携するように最適化されています。
+
+**バンドルサイズ**
+
+大量の JSON ファイルをページにロードするのではなく、必要なコンテンツのみをロードします。 Intlayer は、**バンドルとページのサイズを最大 50% 削減**するのに役立ちます。
+
+**保守性**
+
+アプリケーションのコンテンツのスコープを設定すると、大規模なアプリケーションの **メンテナンスが容易になります**。コンテンツ コードベース全体を確認するという精神的な負担を負うことなく、単一の機能フォルダーを複製または削除できます。さらに、Intlayer は**完全に型指定**されており、コンテンツの正確性を保証します。
+
+**AI エージェント**
+
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+
+**オートメーション**
+
+AI プロバイダーの費用で、選択した LLM を使用して CI/CD パイプラインで自動化を変換します。 Intlayer は、コンテンツ抽出を自動化する **コンパイラー** と、**バックグラウンドでの翻訳**を支援する [Web プラットフォーム](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) も提供します。
+
+**パフォーマンス**
+
+大量の JSON ファイルをコンポーネントに接続すると、パフォーマンスと反応性の問題が発生する可能性があります。 Intlayer は、ビルド時のコンテンツの読み込みを最適化します。
+
+**非開発によるスケーリング**
+
+Intlayer は単なる i18n ソリューションではなく、**自己ホスト型 [ビジュアル エディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** と **[完全な CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** を提供します。 **リアルタイム**で多言語コンテンツを管理できるようになり、翻訳者、コピーライター、その他のチーム メンバーとのコラボレーションがシームレスになります。コンテンツはローカルおよび/またはリモートに保存できます。
 
 ---
 
@@ -86,11 +106,15 @@ Intlayerを使用すると、以下のことが可能になります：
 
 GitHubで[アプリケーションテンプレート](https://github.com/aymericzip/intlayer-tanstack-start-solid-template)を確認してください。
 
-### ステップ 1: プロジェクト作成
+<Steps>
+
+<Step number={1} title="プロジェクト作成">
 
 まず、TanStack Startウェブサイトの[新しいプロジェクトを開始](https://tanstack.com/start/latest/docs/framework/solid/quick-start)ガイドに従って、新しいTanStack Startプロジェクトを作成します。
 
-### ステップ 2: Intlayerパッケージのインストール
+</Step>
+
+<Step number={2} title="Intlayerパッケージのインストール">
 
 お好みのパッケージマネージャーを使用して、必要なパッケージをインストールします：
 
@@ -128,7 +152,9 @@ bun x intlayer init
 - **vite-intlayer**
   Intlayerを[Viteバンドラー](https://vite.dev/guide/why.html#why-bundle-for-production)と統合するためのViteプラグイン、およびユーザーの優先ロケールの検出、Cookie管理、URLリダイレクトを処理するためのミドルウェアが含まれています。
 
-### ステップ 3: プロジェクトの構成
+</Step>
+
+<Step number={3} title="プロジェクトの構成">
 
 アプリケーションの言語を構成するための構成ファイルを作成します：
 
@@ -149,7 +175,9 @@ export default config;
 
 > この構成ファイルを通じて、ローカライズされたURL、ミドルウェアのリダイレクト、Cookie名、コンテンツ宣言の場所と拡張子、コンソールでのIntlayerログの無効化などを設定できます。利用可能なパラメータの完全なリストについては、[構成ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
 
-### ステップ 4: Vite構成にIntlayerを統合する
+</Step>
+
+<Step number={4} title="Vite構成にIntlayerを統合する">
 
 Vite構成にintlayerプラグインを追加します：
 
@@ -177,7 +205,9 @@ export default defineConfig({
 
 > `intlayer()` Viteプラグインは、IntlayerをViteと統合するために使用されます。コンテンツ宣言ファイルの構築を確実にし、開発モードでそれらを監視します。Viteアプリケーション内でIntlayer環境変数を定義します。さらに、パフォーマンスを最適化するためのエイリアスを提供します。
 
-### ステップ 5: ルートレイアウトの作成
+</Step>
+
+<Step number={5} title="ルートレイアウトの作成">
 
 現在選択されているロケールを検出するために `useParams` を使用し、`html` タグに `lang` および `dir` 属性を設定することで、国際化をサポートするようにルートレイアウトを構成します。
 
@@ -218,7 +248,9 @@ const RootComponent: ParentComponent = (props) => {
 };
 ```
 
-### ステップ 6: ロケールレイアウトの作成 (任意)
+</Step>
+
+<Step number={6} title="ロケールレイアウトの作成">
 
 ロケールプレフィックスを処理し、検証を実行するレイアウトを作成します。このレイアウトにより、有効なロケールのみが処理されるようになります。
 
@@ -253,7 +285,9 @@ export const Route = createFileRoute("/{-$locale}")({
 > `'prefix-all'` モードの場合、代わりにスロットを `$locale` に切り替えることをお勧めします。
 > `'no-prefix'` または `'search-params'` モードの場合、スロットを完全に削除できます。
 
-### ステップ 7: コンテンツの宣言
+</Step>
+
+<Step number={7} title="コンテンツの宣言">
 
 翻訳を保存するためのコンテンツ宣言を作成および管理します：
 
@@ -299,7 +333,9 @@ export default appContent;
 
 > 詳細については、[コンテンツ宣言のドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)を参照してください。
 
-### ステップ 8: ロケール対応のコンポーネントとフックを利用する
+</Step>
+
+<Step number={8} title="ロケール対応のコンポーネントとフックを利用する">
 
 ロケール対応のナビゲーションのために `LocalizedLink` コンポーネントを作成します：
 
@@ -378,7 +414,9 @@ export const useLocalizedNavigate = () => {
 };
 ```
 
-### ステップ 9: ページでIntlayerを活用する
+</Step>
+
+<Step number={9} title="ページでIntlayerを活用する">
 
 アプリケーション全体でコンテンツ辞書にアクセスします：
 
@@ -421,7 +459,9 @@ function RouteComponent() {
 >
 > `useIntlayer` フックの詳細については、[ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/solid-intlayer/useIntlayer.md)を参照してください。
 
-### ステップ 10: ロケール切り替えコンポーネントの作成
+</Step>
+
+<Step number={10} title="ロケール切り替えコンポーネントの作成">
 
 ユーザーが言語を変更できるようにするコンポーネントを作成します：
 
@@ -465,7 +505,9 @@ export default LocaleSwitcher;
 >
 > `useLocale` フックの詳細については、[ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/solid-intlayer/useLocale.md)を参照してください。
 
-### ステップ 11: HTML属性の管理
+</Step>
+
+<Step number={11} title="HTML属性の管理">
 
 ステップ 5 で見たように、ルートコンポーネントで `useParams` を使用して `html` タグの `lang` および `dir` 属性を管理できます。これにより、サーバーとクライアントで正しい属性が設定されるようになります。
 
@@ -484,7 +526,9 @@ const RootComponent: ParentComponent = (props) => {
 
 ---
 
-### ステップ 12: ミドルウェアの追加 (任意)
+</Step>
+
+<Step number={12} title="ミドルウェアの追加">
 
 `intlayerProxy` を使用して、アプリケーションにサーバーサイドのルーティングを追加することもできます。このプラグインはURLに基づいて現在のロケールを自動的に検出し、適切なロケールCookieを設定します。ロケールが指定されていない場合、プラグインはユーザーのブラウザ言語設定に基づいて最も適切なロケールを決定します。ロケールが検出されない場合は、デフォルトのロケールにリダイレクトします。
 
@@ -515,7 +559,9 @@ export default defineConfig({
 
 ---
 
-### ステップ 12: メタデータの国際化 (任意)
+</Step>
+
+<Step number={12} title="メタデータの国際化">
 
 ロケール対応のメタデータのために、`head` ローダー内で `getIntlayer` 関数を使用してコンテンツ辞書にアクセスすることもできます：
 
@@ -562,7 +608,9 @@ export const Route = createFileRoute("/{-$locale}/")({
 
 ---
 
-### ステップ 13: サーバーアクションでロケールを取得する (任意)
+</Step>
+
+<Step number={13} title="サーバーアクションでロケールを取得する">
 
 サーバーアクションやAPIエンドポイント内から現在のロケールにアクセスしたい場合があります。
 これを行うには、`intlayer` から `getLocale` ヘルパーを使用します。
@@ -599,7 +647,9 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### ステップ 14: 404ページを管理する (任意)
+</Step>
+
+<Step number={14} title="404ページを管理する">
 
 ユーザーが存在しないページにアクセスしたときに、カスタム 404 ページを表示できます。ロケールプレフィックスは、404 ページがトリガーされる方法に影響を与える可能性があります。
 
@@ -673,7 +723,9 @@ export const Route = createFileRoute("/{-$locale}/$")({
 });
 ```
 
-### (任意) ステップ 15: コンポーネントのコンテンツを抽出する
+</Step>
+
+<Step number={15} title="コンポーネントのコンテンツを抽出する" isOptional={true}>
 
 既存のコードベースがある場合、数千ものファイルを変換するのは時間がかかる可能性があります。
 
@@ -786,7 +838,9 @@ bun run build # または bun run dev
 
 ---
 
-### ステップ 16: サイトマップの生成 (オプション)
+</Step>
+
+<Step number={16} title="サイトマップの生成">
 
 Intlayer には、アプリケーションのサイトマップを簡単に作成できるサイトマップ ジェネレーターが組み込まれています。ローカライズされたルートを処理し、検索エンジンに必要なメタデータを追加します。
 
@@ -861,7 +915,9 @@ export const Route = createFileRoute("/sitemap.xml")({
 
 ---
 
-### ステップ 17: TypeScriptの構成 (任意)
+</Step>
+
+<Step number={17} title="TypeScriptの構成">
 
 Intlayerは、TypeScriptの利点を活用し、コードベースをより強固にするために、モジュール拡張（module augmentation）を使用します。
 
@@ -892,6 +948,10 @@ Intlayerによって生成されたファイルを無視することをお勧め
 
 ---
 
+</Step>
+
+</Steps>
+
 ## VS Code 拡張機能
 
 Intlayerでの開発体験を向上させるために、公式の **Intlayer VS Code 拡張機能** をインストールできます。

package/docs/ja/intlayer_with_tanstack.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-05-06
-title: Tanstack Start i18n - Tanstack Startアプリの翻訳方法 2026
-description: Intlayerを使用してTanStack Startアプリケーションに国際化（i18n）を追加する方法を学びます。ロケール対応のルーティングでアプリを多言語化するための包括的なガイドに従ってください。
+updatedAt: 2026-05-31
+title: Tanstack Start i18n - 完全な翻訳ガイド： TanStack Start
+description: バンドルサイズ、SEO、パフォーマンス、保守性のための最良のソリューション。2026年にTanStack Start アプリを多言語化しましょう。LLM翻訳、Agent Skills & MCP。
 keywords:
   - 国際化
   - ドキュメント
@@ -58,17 +58,37 @@ history:
 
 このガイドでは、ロケール対応のルーティング、TypeScriptサポート、および最新の開発手法を使用して、TanStack Startプロジェクトに**Intlayer**をシームレスに統合し、国際化を実現する方法を説明します。
 
-## Intlayerとは？
+## 代替手段ではなく Interlayer を使用する理由
 
-**Intlayer**は、最新のウェブアプリケーションでの多言語サポートを簡素化するために設計された、革新的なオープンソースの国際化（i18n）ライブラリです。
+「react-i18next」、「use-intl」、または「paraglide」などの主要なソリューションと比較して、Intlayer は次のような統合された最適化を備えたソリューションです。
 
-Intlayerを使用すると、以下のことが可能になります：
+**TanStack Start を完全にカバー**
 
-- **コンポーネントレベルでの宣言的な辞書**を使用して、翻訳を簡単に管理できます。
-- **メタデータ、ルート、およびコンテンツを動的にローカライズ**できます。
-- **自動生成された型**によるTypeScriptサポートを確保し、オートコンプリートとエラー検出を向上させます。
-- **動的なロケール検出および切り替え**などの高度な機能を利用できます。
-- **TanStack Startのファイルベースのルーティングシステム**を使用して、ロケール対応のルーティングを有効にできます。
+Intlayer は TanStack Start 用に完全に最適化されており、**多言語ルーティング**、**Cookie 管理**、**サイトマップ生成**、**動的コンテンツ読み込み**、および国際化 (i18n) の取り組みを拡張するために必要なすべての機能を提供します。
+
+**バンドルサイズ**
+
+大量の JSON ファイルをページにロードするのではなく、必要なコンテンツのみをロードします。 Intlayer は、**バンドルとページのサイズを最大 50% 削減**するのに役立ちます。
+
+**保守性**
+
+アプリケーションのコンテンツのスコープを設定すると、大規模なアプリケーションの **メンテナンスが容易になります**。コンテンツ コードベース全体を確認するという精神的な負担を負うことなく、単一の機能フォルダーを複製または削除できます。さらに、Intlayer は**完全に型指定**されており、コンテンツの正確性を保証します。
+
+**AI エージェント**
+
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+
+**オートメーション**
+
+AI プロバイダーの費用で、選択した LLM を使用して CI/CD パイプラインで自動化を変換します。 Intlayer は、コンテンツ抽出を自動化する **コンパイラー** と、**バックグラウンドでの翻訳**を支援する [Web プラットフォーム](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) も提供します。
+
+**パフォーマンス**
+
+大量の JSON ファイルをコンポーネントに接続すると、パフォーマンスと反応性の問題が発生する可能性があります。 Intlayer は、ビルド時のコンテンツの読み込みを最適化します。
+
+**非開発によるスケーリング**
+
+Intlayer は単なる i18n ソリューションではなく、**自己ホスト型 [ビジュアル エディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** と **[完全な CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** を提供します。 **リアルタイム**で多言語コンテンツを管理できるようになり、翻訳者、コピーライター、その他のチーム メンバーとのコラボレーションがシームレスになります。コンテンツはローカルおよび/またはリモートに保存できます。
 
 ---
 
@@ -106,11 +126,15 @@ Intlayerを使用すると、以下のことが可能になります：
 
 GitHubの[アプリケーションテンプレート](https://github.com/aymericzip/intlayer-tanstack-start-template)を参照してください。
 
-### ステップ 1: プロジェクトの作成
+<Steps>
+
+<Step number={1} title="プロジェクトの作成">
 
 まず、TanStack Startウェブサイトの[プロジェクトの開始](https://tanstack.com/start/latest/docs/framework/react/quick-start)ガイドに従って、新しいTanStack Startプロジェクトを作成します。
 
-### ステップ 2: Intlayerパッケージのインストール
+</Step>
+
+<Step number={2} title="Intlayerパッケージのインストール">
 
 好みのパッケージマネージャーを使用して、必要なパッケージをインストールします：
 
@@ -148,7 +172,9 @@ bun x intlayer init
 - **vite-intlayer**
   Intlayerを[Viteバンミラー](https://vite.dev/guide/why.html#why-bundle-for-production)と統合するためのViteプラグイン、およびユーザーの優先ロケールの検出、クッキーの管理、URLリダイレクトの処理のためのミドルウェアが含まれています。
 
-### ステップ 3: プロジェクトの構成
+</Step>
+
+<Step number={3} title="プロジェクトの構成">
 
 アプリケーションの言語を構成するための設定ファイルを作成します：
 
@@ -169,7 +195,9 @@ export default config;
 
 > この構成ファイルを通じて、ローカライズされたURL、ミドルウェアのリダイレクト、クッキー名、コンテンツ宣言の場所と拡張子、コンソールでのIntlayerログの無効化などを設定できます。利用可能なパラメータの完全なリストについては、[構成ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
 
-### ステップ 4: Vite構成へのIntlayerの統合
+</Step>
+
+<Step number={4} title="Vite構成へのIntlayerの統合">
 
 構成にintlayerプラグインを追加します：
 
@@ -199,7 +227,9 @@ export default config;
 
 > `intlayer()` Viteプラグインは、IntlayerをViteと統合するために使用されます。コンテンツ宣言ファイルの構築を確実にし、開発モードでそれらを監視します。Viteアプリケーション内でIntlayer環境変数を定義します。さらに、パフォーマンスを最適化するためのエイリアスを提供します。
 
-### ステップ 5: ルートレイアウトの作成
+</Step>
+
+<Step number={5} title="ルートレイアウトの作成">
 
 `useParams`を使用して現在のロケールを検出し、`html`タグに`lang`および`dir`属性を設定することで、国際化をサポートするようにルートレイアウトを構成します。
 
@@ -259,7 +289,9 @@ function RootDocument({ children }: { children: ReactNode }) {
 > <img src="{String(content.image.src)}" alt="{String(content.image)}" />
 > ```
 
-### ステップ 6: ロケールレイアウトの作成
+</Step>
+
+<Step number={6} title="ロケールレイアウトの作成">
 
 ロケール接頭辞を処理し、検証を実行するレイアウトを作成します。
 
@@ -291,7 +323,9 @@ export const Route = createFileRoute("/{-$locale}")({
 > `'prefix-all'`モードの場合、スロットを`$locale`に切り替えることをお勧めします。
 > `'no-prefix'`または`'search-params'`モードの場合、スロットを完全に削除できます。
 
-### ステップ 7: コンテンツの宣言
+</Step>
+
+<Step number={7} title="コンテンツの宣言">
 
 翻訳を保存するためのコンテンツ宣言を作成および管理します：
 
@@ -341,7 +375,9 @@ export default appContent;
 
 > 詳細については、[コンテンツ宣言ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)を参照してください。
 
-### ステップ 8: ロケール対応コンポーネントとフックの作成
+</Step>
+
+<Step number={8} title="ロケール対応コンポーネントとフックの作成">
 
 ロケール対応のナビゲーションのための `LocalizedLink` コンポーネントを作成します：
 
@@ -445,7 +481,9 @@ export const useLocalizedNavigate = () => {
 };
 ```
 
-### ステップ 9: ページでのIntlayerの利用
+</Step>
+
+<Step number={9} title="ページでのIntlayerの利用">
 
 アプリケーション全体でコンテンツ辞書にアクセスします：
 
@@ -530,7 +568,9 @@ function RouteComponent() {
 
 > `useIntlayer`フックの詳細については、[ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useIntlayer.md)を参照してください。
 
-### ステップ 10: ロケールスイッチャーコンポーネントの作成
+</Step>
+
+<Step number={10} title="ロケールスイッチャーコンポーネントの作成">
 
 ユーザーが言語を変更できるようにするコンポーネントを作成します：
 
@@ -591,7 +631,9 @@ export const LocaleSwitcher: FC = () => {
 
 > `useLocale`フックの詳細については、[ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/react-intlayer/useLocale.md)を参照してください。
 
-### ステップ 11: HTML属性の管理
+</Step>
+
+<Step number={11} title="HTML属性の管理">
 
 ステップ 5 で見たように、ルートコンポーネントで `useParams` を使用して `html` タグの `lang` および `dir` 属性を管理できます。これにより、サーバーとクライアントで正しい属性が設定されるようになります。
 
@@ -610,7 +652,9 @@ function RootDocument({ children }: { children: ReactNode }) {
 
 ---
 
-### ステップ 12: ミドルウェアの追加 (オプション)
+</Step>
+
+<Step number={12} title="ミドルウェアの追加">
 
 `intlayerProxy`を使用して、アプリケーションにサーバーサイドのルーティングを追加することもできます。このプラグインは、URLに基づいて現在のロケールを自動的に検出し、適切なロケールクッキーを設定します。ロケールが指定されていない場合、ユーザーのブラウザの言語設定に基づいて最も適切なロケールを決定します。ロケールが検出されない場合は、デフォルトのロケールにリダイレクトされます。
 
@@ -641,7 +685,9 @@ export default defineConfig({
 
 ---
 
-### ステップ 12: メタデータの国際化 (オプション)
+</Step>
+
+<Step number={12} title="メタデータの国際化">
 
 `getIntlayer`フックを使用して、アプリケーション全体でコンテンツ辞書にアクセスすることもできます：
 
@@ -688,7 +734,9 @@ export const Route = createFileRoute("/{-$locale}/")({
 
 ---
 
-### ステップ 13: サーバーアクションでのロケールの取得 (オプション)
+</Step>
+
+<Step number={13} title="サーバーアクションでのロケールの取得">
 
 サーバーアクションやAPIエンドポイント内から現在のロケールにアクセスしたい場合があります。
 Intlayerの `getLocale` ヘルパーを使用してこれを行うことができます。
@@ -725,7 +773,9 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### ステップ 14: 「見つかりませんでした」ページの管理 (オプション)
+</Step>
+
+<Step number={14} title="「見つかりませんでした」ページの管理">
 
 ユーザーが存在しないページにアクセスしたときにカスタムの404ページを表示できます。ロケール接頭辞は、404ページがトリガーされる方法に影響を与える可能性があります。
 
@@ -801,7 +851,9 @@ export const Route = createFileRoute("/{-$locale}/$")({
 
 ---
 
-### (オプション) ステップ 15: コンポーネントのコンテンツを抽出する
+</Step>
+
+<Step number={15} title="コンポーネントのコンテンツを抽出する" isOptional={true}>
 
 既存のコードベースがある場合、数千のファイルを変換するのは時間がかかることがあります。
 
@@ -896,7 +948,9 @@ export default defineConfig({
  </Tab>
 </Tabs>
 
-### ステップ 16: サイトマップの生成 (オプション)
+</Step>
+
+<Step number={16} title="サイトマップの生成">
 
 Intlayer には、アプリケーションのサイトマップを簡単に作成できるサイトマップ ジェネレーターが組み込まれています。ローカライズされたルートを処理し、検索エンジンに必要なメタデータを追加します。
 
@@ -971,7 +1025,9 @@ export const Route = createFileRoute("/sitemap.xml")({
 
 ---
 
-### ステップ 17: TypeScriptの構成 (オプション)
+</Step>
+
+<Step number={17} title="TypeScriptの構成">
 
 Intlayerはモジュール拡張機能を利用して、TypeScriptの利点を活用し、コードベースを強化します。
 
@@ -1002,6 +1058,10 @@ Intlayerによって生成されたファイルは無視することをお勧め
 
 ---
 
+</Step>
+
+</Steps>
+
 ## VS Code拡張機能
 
 Intlayerでの開発体験を向上させるために、公式の**Intlayer VS Code拡張機能**をインストールできます。