@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/ja/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: Intlayer v8 の新機能
 description: Intlayer v8 の新機能を紹介します。開発者体験、自動コンテンツ検出、スキーマ検証によるデータ整合性、辞書管理における主な改善点を解説します。
 keywords:
@@ -199,7 +199,7 @@ v7 では、プロバイダーが定義されていない場合、Markdown ノ
 
     **3. ユーティリティ関数の使用:**
 
-    ```tsx
+    ```typescript
     import { renderMarkdown } from "solid-intlayer/markdown";
 
     return <div>{renderMarkdown("# My Title")}</div>;
@@ -334,7 +334,7 @@ v7 では、プロバイダーが定義されていない場合、Markdown ノ
 
     **1. 直接の使用:**
 
-    Angular では、標準の `[innerHTML]` バインディングを使用できます。
+    Angular では、標準 of `[innerHTML]` バインディングを使用できます。
 
     ```html
     <div [innerHTML]="'<p>Hello World</p>'"></div>
@@ -409,6 +409,16 @@ v7 では、プロバイダーが定義されていない場合、Markdown ノ
 
 ---
 
+## YAML & Markdown コンテンツファイル (v8.10.0)
+
+`.content.md` および `.content.yaml` ファイル拡張子を使用して、コンテンツを直接宣言できるようになりました。これは、長文のコンテンツ、ブログ、ドキュメント、プライバシーポリシーに最適です。
+
+これらのファイルはビジュアルエディター（Visual Editor）から直接編集可能であり、非技術的なチームメンバーにとっても合理化されたワークフローを提供します。
+
+詳細については、[YAML コンテンツファイルのドキュメント](https://intlayer.org/ja/doc/concept/content#yaml-content-file) および [Markdown コンテンツファイルのドキュメント](https://intlayer.org/ja/doc/concept/content/markdown) を参照してください。
+
+---
+
 ## カスタム URL リライト
 
 Intlayer v8 は **カスタム URL リライト** を導入し、標準の `/locale/path` 構造と異なるロケール固有のパスを定義できるようになります。これはローカルSEOの改善や、英語以外のユーザーにとってより自然なユーザーエクスペリエンスを提供するための強力な機能です。
@@ -753,6 +763,61 @@ export default {
   </Tab>
 </Tabs>
 
+## Unicode CLDR 複数形ルール (v8.8.0)
+
+Unicode CLDR プロジェクトで定義された複数形ルールに基づく新しい `plural` ノードヘルパーが導入され、複雑な言語のサポートが向上しました。
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      ja: plural({
+        other: "{{count}} 個の空き",
+      }),
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+その後、フレームワークコンポーネント内で動的にカウントを渡すことができます：
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* 英語の場合:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+詳細については、[複数形化のドキュメント](https://intlayer.org/ja/doc/concept/content/plural) を参照してください。
+
+---
+
 ## コンテンツスキーマ検証
 
 Intlayer v8 では、辞書に対するスキーマ検証が導入されました。Zod を使って設定内に再利用可能なバリデーションスキーマを定義し、それをコンテンツファイルに適用できます。これにより、コンテンツが常に期待される構造に準拠していることが保証され、ビルド時にエラーを検出できます。
@@ -797,6 +862,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: IntlayerNode プリミティブアクセサー
+
+`IntlayerNode` 型が更新され、コンテンツノード上で直接 JavaScript のプリミティブメソッドを呼び出せるようになりました。これにより、ローカライズされたコンテンツを、標準の文字列、数値、真偽値、または配列のプリミティブであるかのように直接操作できます。
+
+React、Preact、Solid、Svelte、Vue、および Angular でサポートされています。
+
+### 文字列の例
+
+```typescript
+content.placeholder; // IntlayerNode<string> を返す
+content.placeholder.value; // string を返す
+content.placeholder.toString(); // string を返す
+content.placeholder.toLowerCase(); // string を返す
+String(content.placeholder); // string を返す
+content.placeholder.toUpperCase(); // 大文字に変換された string を返す
+content.placeholder.replace("a", "b"); // 変更された string を返す
+```
+
+### 配列の例
+
+```typescript
+content.myArrayOfString             // IntlayerNode<Array<string>> を返す
+content.myArrayOfString.find(...)   // 要素を返す
+content.myArrayOfString.join(', ')  // 結合された string を返す
+```
+
+---
+
 ### 強化された自動コンテンツ検出
 
 v8 では、Intlayer がコンテンツ文字列内の Markdown 構文、HTML タグ、および変数挿入を自動的に検出します。これにより、`md()`、`html()`、`insert()` といったヘルパー関数を省略できることが多くなります。
@@ -1002,6 +1095,17 @@ Intlayer の VSCode 拡張機能は v8 で大幅なアップデートを受け
 
 ---
 
+## ツール: C++ ウォッチャー & OXC ベースの LSP (v8.12.0)
+
+Intlayer v8.12.0 は、開発者体験に大きな改善をもたらします：
+
+- **Parcel Watcher**: コンテンツウォッチャーが `chokidar` から `@parcel/watcher` に移行されました。ネイティブの C++ ファイル監視を活用することで、より高速なアップデートと大幅なメモリ消費の削減を実現します。
+- **新しい Language Server Protocol (LSP)**: まったく新しい LSP が利用可能になりました。OXC ベースのパースで構築されており、IDE や AI エージェントが `useIntlayer('my-key')` の呼び出しと対応する `.content` ファイルをシームレスにリンク（およびその逆）できるように支援します。
+
+詳細については、[LSP のドキュメント](https://intlayer.org/ja/doc/lsp) を参照してください。
+
+---
+
 ## コンパイラの最適化
 
 Intlayer v8 には Markdown と HTML コンパイラ向けの新しいキャッシング層が導入されました。これにより、同じ設定で同一のコンテンツ文字列は一度だけ解析されるため、再レンダリング時や複数箇所で同じコンテンツを使用する場合のオーバーヘッドが大幅に削減されます。
@@ -1057,6 +1161,48 @@ Intlayer v8 には Markdown と HTML コンパイラ向けの新しいキャッ
 
 ---
 
+## 実験的なビルド最適化: Minify & Purge (v8.7.0)
+
+Intlayer v8.7.0 では、本番環境のバンドルを最適化するために設計された、`intlayer.config.ts` 内の新しい実験的なビルド機能が導入されました：
+
+- **辞書のミニファイ (Minification)**: 辞書ファイルをミニファイしてサイズを削減します。
+- **未使用キーのパージ (Purging)**: 辞書から未使用の翻訳キーをスキャンして削除し、アクティブなキーを短い文字にリネームします（例: `"products" -> "a"`, `"pricing" -> "b"`）。これにより、バンドルサイズが最大 5% 削減されます。
+- **TypeScript チェックの無効化**: コンパイルステップ中の TypeScript 型チェックを無効にすることで、ビルドを高速化します。
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * バンドルサイズを削減するために辞書をミニファイします。
+     */
+    minify: true,
+
+    /**
+     * 辞書内の未使用キーをパージします。
+     */
+    purge: true,
+
+    /**
+     * ビルド時に TypeScript の型チェックを行うかどうかを示します。
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## 柔軟性: 統一されたインポートモード
 
 `live` ブールプロパティは、より包括的な `importMode` プロパティに置き換えられ、非推奨になりました。これにより、辞書をどのように読み込むか（静的、動的、またはライブ同期）を明示的に定義できるようになります。
@@ -1076,7 +1222,7 @@ Intlayer v8 には Markdown と HTML コンパイラ向けの新しいキャッ
 
 注: Intlayer v8 では、`importMode` プロパティは `intlayer.config.ts` の `build` 設定から `dictionary` 設定へ移動しました。これにより、すべての辞書に対するデフォルトのインポートモードを定義しつつ、各辞書ごとに上書きできるようになります。
 
-**グローバル設定の例:**
+**グローバル設定 of 例:**
 
 ```typescript fileName="intlayer.config.ts"
 export default {
@@ -1204,6 +1350,49 @@ Svelte 内の Markdown および HTML コンテンツは、文字列化（string
 
 ---
 
+## Angular サポート: Vite バンドラー (v8.11.0)
+
+Angular ユーザー向けに、Intlayer は新しいカスタム esbuild プラグインを介して Vite バンドラーをネイティブにサポートするようになり、開発およびビルド時間が短縮されました。
+
+設定の詳細については、[Angular 環境のドキュメント](https://intlayer.org/ja/doc/environment/angular) を参照してください。
+
+---
+
+## サイトマップ生成 (v8.6.0)
+
+Intlayer は、ロケールとルーティングモードに基づいてサイトマップを自動的に生成するようになりました。これは、TanStack Router などのルーターアーキテクチャにおける SEO 最適化に特に役立ちます：
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## v7 からの移行ノート
 
 ### 設定の変更

package/docs/ja/releases/v9.md

@@ -0,0 +1,316 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-26
+title: Intlayer v9の新機能
+description: Intlayer v9の新機能をご覧ください。主要なi18nライブラリ向けのドロップイン互換性パッケージと、コレクション、バリアントのサポートを導入します。
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Intlayer v9の新機能
+
+Intlayer v9へようこそ！このメジャーリリースは、主要なi18nライブラリ（`react-i18next`、`next-intl`、`vue-i18n`など）向けの**互換アダプターパッケージ**により、Intlayerへの移行パスを簡素化し、**コレクション**、**バリアント**といったリッチなコンテンツ構造のサポートを追加することで、大きな節目となります。
+
+## 目次
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## 互換アダプターパッケージ
+
+人気のi18nライブラリからIntlayerへの移行がこれまで以上に簡単になりました。標準のi18nライブラリと**まったく同じ公開API**を公開しつつ、すべての翻訳作業をIntlayerにランタイムで委譲する5つの互換パッケージを作成しました。
+
+### 厳密な型付けで同じ公開APIを公開
+
+インポートを置き換えるだけで、最小限のコード変更でIntlayerのすべての利点（実際の辞書に対するコンパイル時の型安全性を含む）を得ることができます。
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+例えば、次のように変更するだけです。
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+を次のように変更します。
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+これにより、キーはIntlayer辞書に対して**厳密に型付け**され、IDEで完全なドットパスのオートコンプリートが提供されます！
+
+### バンドラーエイリアスプラグイン (Vite, Next.js, Turbopack)
+
+すべてのインポートステートメントを手動で書き換えることなく移行できるように、各互換アダプターパッケージには、`/plugin`サブパスの下に**カスタムバンドラープラグイン**（ViteまたはNext.js）が含まれています。
+
+これらのプラグインは、ビルド時に既存のインポート（例：`react-i18next`や`next-intl`）を自動的に`@intlayer/*`の同等物に書き換えます。
+
+#### Next.js (Webpack / Turbopack) の例
+
+`withIntlayer`の代わりに、互換プラグインでNext.jsの設定をラップします。
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Vite (React, Vue, Solid, Svelte) の例
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## 共通化されたランタイムリゾルバー
+
+すべての互換アダプターは、単一の高度に最適化されたランタイムパーサーである`@intlayer/core/messageFormat`を介して翻訳解決をルーティングするようになりました。
+
+- **メッセージ補間**: 標準の`{{var}}`（空白とドットパス）、ICU形式の引数（`{v, number, percent}`など）、および裸の`{var}`テンプレートを解決します。
+- **メッセージノードリゾルバー**: ネストされたノードを解決します：`insert()`、`plural()`（CLDR複数形ルール）、`enu()`（列挙）、`gender()`、HTMLタグ、配列、および呼び出し可能な関数ノード。
+- **トークン化されたタグパーサー**: インラインXML/HTMLタグと番号付きタグ（例：`<1>children</1>`)をサポートし、リッチテキストレンダリングをすぐに利用できるようにします。
+
+---
+
+## 機能仕様：コレクション、バリアント
+
+Intlayer v9は、静的なキーと値のオブジェクトを超えて拡張され、辞書がエンドツーエンドで完全に型付けされた動的なレイアウト構造を宣言できるようになりました。
+
+### 1. コレクション
+
+CMSで管理される順序付きアイテムのリスト（例：FAQ、製品、ブログリスト）を定義します。
+
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
+} satisfies Dictionary;
+```
+
+#### 使用法：
+
+```ts
+// Fetch all items as an array
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
+```
+
+### 2. バリアント
+
+A/Bテスト、季節限定ヘッダー、機能フラグ、またはカスタムランディングページを提供します。
+
+#### 文字列バリアント（例：A/Bテスト）
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ ja: "ようこそ", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      ja: "今すぐ購入",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### 使用法：
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+#### オブジェクトバリアント（例：動的レコード）
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  variant: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ ja: "クリーンコード", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### 使用法：
+
+```ts
+// Fetches only the requested item dynamically (requires Suspense)
+const product = useIntlayer("product-copy", {
+  variant: { id: "prod_123", category: "books" },
+});
+```
+
+---
+
+## 動的ロードとバンドルサイズの最適化
+
+バンドルを極めて小さく保つため、Intlayer v9は動的な遅延ロードをサポートしています。
+
+設定で、`importMode`を`'dynamic'`または`'fetch'`に設定します。
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+ビルド時、`@intlayer/swc`と`@intlayer/babel`はファイルをスキャンし、`useIntlayer` / `getIntlayer`の呼び出しをツリーシェイク可能なラッパー（`useDictionary` / `useDictionaryDynamic`）に置き換えます。選択されたコレクションアイテム、バリアント、またはロケールに必要なコンテンツのみがロードされ、本番バンドルに未使用の翻訳が含まれるのを防ぎます。
+
+---
+
+## Vite Plugin: バンドルされたコンパイラとプロキシ
+
+`intlayer()` Vite プラグインは、**コンパイラ**と**ロケールルーティングプロキシ**を直接バンドルするようになったため、ほとんどのプロジェクトは `vite.config.ts` に単一のプラグインのみが必要です：
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: `compiler.enabled` が `true` に設定され、`compiler.output` パスが構成されている場合、自動的に有効化されます。`intlayerCompiler()` を個別に登録する必要はなくなりました。
+- **Proxy**: 新しい `routing.enableProxy` オプション（デフォルトは `true`）に基づいて自動的に有効化されます。開発、プレビュー、本番 SSR でロケール検出・リダイレクト・書き換えミドルウェアを配線します。`intlayerProxy()` を個別に登録する必要はなくなりました。
+
+### `routing.enableProxy` オプション
+
+新しい `routing.enableProxy` オプションは、locale-routing プロキシがプラグインされているかどうかを制御します。デフォルトは `true` です。locale ルーティングを自分で処理したい場合は、これを無効にしてください:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // デフォルト: true
+  },
+};
+
+export default config;
+```
+
+スタンドアロンの `intlayerCompiler()` と `intlayerProxy()` プラグインは、高度なセットアップ用にエクスポートされたままです。これらを `intlayer()` と一緒に登録しても安全です — 各プラグインは自動的に重複排除され、1 回だけ実行されます。
+
+---
+
+## コンパイラはデフォルトで無効
+
+Intlayer v9 以降、**コンパイラはデフォルトで無効になっています**（`compiler.enabled` のデフォルト値は `false` になりました）。`.content.ts` ファイルのビルド時抽出を有効にするには、設定で `compiler.enabled: true` を指定します。
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // デフォルト: false — v9 以降、コンパイラを有効にするために必要
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+コンパイラが無効の場合、Intlayer はビルド時の抽出ステップをスキップし、すでに宣言済みの辞書に依存します。バンドラープラグイン（`@intlayer/swc`、`@intlayer/babel`、または `intlayer()` Vite プラグイン）にコンテンツを自動的に抽出させたい場合にのみ有効にしてください。
+
+---
+
+## React Native: 単一パッケージでのインポート
+
+React Native または Expo アプリでは、`react-intlayer` と `react-native-intlayer` の両方を使い分ける必要がなくなりました。`react-native-intlayer` パッケージは現在、**`react-intlayer` の完全な API を再エクスポート**しており（フック、ユーティリティ、および `/format`、`/html`、`/markdown` サブパス）、その `IntlayerProvider` は自動的に React Native のポリフィルを適用します。
+
+すべての機能を単一の `react-native-intlayer` パッケージからインポートしてください：
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> `react-intlayer` からのインポートも引き続き機能しますが、React Native の推奨される単一エントリポイントは `react-native-intlayer` になりました。このプロバイダは、Web 指向の `react-intlayer` プロバイダには含まれていないポリフィルを提供します。
+
+---
+
+## v8からの移行に関する注意点
+
+v8からアップグレードする場合、v9には破壊的変更は含まれていません。ただし、主な変更点は次のとおりです。
+
+- **コンパイラはデフォルトで無効**: `compiler.enabled` のデフォルト値は `false` になりました。`.content.ts` ファイルのビルド時抽出に依存している場合は、`intlayer.config.ts` で `compiler.enabled: true` を設定してください。
+- **ロケールと方言**: 外部i18n依存関係を使用している場合、設定またはバンドラーセットアップにそれぞれの互換アダプタープラグインを追加して、インポートを自動的に書き換えるようにします。
+- **カスタムセレクター**: `useIntlayer`を呼び出す際、2番目のパラメーターは`{ locale, item, variant }`を含むオプションオブジェクトのために予約されるようになりました。以前にロケール文字列を直接渡していた場合でも引き続き可能ですが、高度な選択にはオプションオブジェクトの使用が推奨されます。
+
+---
+
+## 役立つリンク
+
+- [互換アダプターパッケージガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)
+- [動的辞書 - コレクション、バリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
+- [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)

package/docs/ja/roadmap.md

@@ -29,6 +29,12 @@ Intlayerは、アプリケーション全体でコンテンツを宣言、管理
 
 ---
 
+## 目次
+
+<TOC/>
+
+---
+
 ## 現在の機能
 
 ### 1. コンテンツ宣言

package/docs/ko/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer는 콘텐츠 선언 파일에 대한 번역을 자동으로 생성할 수 있도록 합니다. 워크플로우에 따라 이를 달성하는 여러 가지 방법이 있습니다.
 
+## 목차
+
+<TOC/>
+
 ## CMS 사용하기
 
 Intlayer를 사용하면 로컬에서는 단일 로케일만 선언하고 모든 번역은 CMS를 통해 원격으로 관리하는 워크플로우를 채택할 수 있습니다. 이를 통해 콘텐츠와 번역이 코드베이스와 완전히 분리되어 콘텐츠 편집자에게 더 많은 유연성을 제공하며, 핫 콘텐츠 리로딩이 가능해져(변경 사항 적용을 위해 애플리케이션을 다시 빌드할 필요 없음) 편리합니다.