@intlayer/docs 7.2.2 → 7.3.0-canary.0

package/docs/ja/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: ライブ同期コマンド
+description: ランタイムでCMSのコンテンツ変更を反映するためのライブ同期の使い方を学びます。
+keywords:
+  - ライブ同期
+  - CMS
+  - ランタイム
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# ライブ同期コマンド
+
+ライブ同期を使うと、アプリがランタイムでCMSのコンテンツ変更を反映できます。再ビルドや再デプロイは不要です。有効にすると、更新はライブ同期サーバーにストリーミングされ、アプリケーションが読み込む辞書が更新されます。詳細は[Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を参照してください。
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## 引数:
+
+**設定オプション:**
+
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。intlayerの設定を取得するために、コマンドはベースディレクトリ内の `intlayer.config.{ts,js,json,cjs,mjs}` ファイルを探します。
+
+- **`--no-cache`**: キャッシュを無効にします。
+
+  > 例: `npx intlayer dictionary push --env-file .env.production.local`
+
+**ログオプション:**
+
+- **`--verbose`**: デバッグのために詳細なログを有効にします。（CLIではデフォルトでtrue）

package/docs/ja/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 辞書のプル
+description: IntlayerエディターとCMSから辞書をプルする方法を学びます。
+keywords:
+  - プル
+  - 辞書
+  - CLI
+  - Intlayer
+  - エディター
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# 遠隔辞書のプル
+
+```bash
+npx intlayer pull
+```
+
+[Intlayerエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)がインストールされている場合、エディターからも辞書をプルできます。この方法で、アプリケーションのニーズに合わせて辞書の内容を上書きすることが可能です。
+
+## エイリアス:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## 引数:
+
+**辞書オプション:**
+
+- **`-d, --dictionaries`**: プルする辞書のID。指定しない場合は、すべての辞書がプルされます。
+
+  > 例: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: プルする辞書のID（--dictionariesのエイリアス）。
+
+  > 例: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**設定オプション:**
+
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。intlayerの設定を取得するために、コマンドはベースディレクトリ内の `intlayer.config.{ts,js,json,cjs,mjs}` ファイルを探します。
+
+  > 例: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: キャッシュを無効にします。
+
+  > 例: `npx intlayer build --no-cache`
+
+**環境変数オプション:**
+
+- **`--env`**: 環境を指定します（例: `development`、`production`）。
+- **`--env-file`**: 変数を読み込むためのカスタム環境ファイルを指定します。
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。intlayerの設定を取得するために、コマンドはベースディレクトリ内の `intlayer.config.{ts,js,json,cjs,mjs}` ファイルを探します。
+
+  > 例: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > 例: `npx intlayer dictionary push --env production`
+
+**出力オプション:**
+
+- **`--new-dictionaries-path`** : 新しい辞書が保存されるディレクトリへのパス。指定しない場合、新しい辞書はプロジェクトの `./intlayer-dictionaries` ディレクトリに保存されます。辞書の内容に `filePath` フィールドが指定されている場合、この引数は無視され、指定された `filePath` ディレクトリに保存されます。
+
+**ログオプション:**
+
+- **`--verbose`**: デバッグのために詳細なログを有効にします。（CLIではデフォルトでtrue）
+
+## 例:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```

package/docs/ja/cli/push.md

@@ -0,0 +1,113 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 辞書のプッシュ
+description: 辞書をIntlayerエディターとCMSにプッシュする方法を学びます。
+keywords:
+  - プッシュ
+  - 辞書
+  - CLI
+  - Intlayer
+  - エディター
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - push
+---
+
+# 辞書のプッシュ
+
+```bash
+npx intlayer dictionary push
+```
+
+[intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)がインストールされている場合、辞書をエディターにプッシュすることもできます。このコマンドにより、辞書を[エディター](https://intlayer.org/dashboard)で利用可能にします。これにより、チームと辞書を共有し、アプリケーションのコードを編集せずにコンテンツを編集できます。
+
+## エイリアス:
+
+- `npx intlayer dictionaries push`
+- `npx intlayer dictionary push`
+- `npx intlayer dic push`
+
+## 引数:
+
+**辞書オプション:**
+
+- **`-d`, `--dictionaries`**: プルする辞書のID。指定しない場合はすべての辞書がプッシュされます。
+
+  > 例: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: プルする辞書のID（--dictionariesのエイリアス）。
+
+  > 例: `npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id`
+
+**設定オプション:**
+
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。intlayerの設定を取得するために、コマンドはベースディレクトリ内の `intlayer.config.{ts,js,json,cjs,mjs}` ファイルを探します。
+
+  > 例: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: キャッシュを無効にします。
+
+  > 例: `npx intlayer build --no-cache`
+
+**環境変数オプション:**
+
+- **`--env`**: 環境を指定します（例: `development`、`production`）。intlayerの設定ファイルで環境変数を使用している場合に便利です。
+- **`--env-file`**: 変数を読み込むためのカスタム環境ファイルを指定します。intlayerの設定ファイルで環境変数を使用している場合に便利です。
+
+  > 例: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > 例: `npx intlayer dictionary push --env production`
+
+**出力オプション:**
+
+- **`-r`, `--delete-locale-dictionary`**: 辞書がプッシュされた後にロケールディレクトリを削除するかどうかの質問をスキップし、ディレクトリを削除します。デフォルトでは、辞書がローカルに定義されている場合、遠隔の辞書内容を上書きします。
+
+  > 例: `npx intlayer dictionary push -r`
+
+  > 例: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: 辞書がプッシュされた後にロケールディレクトリを削除するかどうかの質問をスキップし、ディレクトリを保持します。デフォルトでは、辞書がローカルに定義されている場合、遠隔の辞書内容を上書きします。
+
+  > 例: `npx intlayer dictionary push -k`
+
+  > 例: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**準備オプション:**
+
+- **`--build`**: プッシュする前に辞書をビルドして、内容が最新であることを確認します。true はビルドを強制し、false はビルドをスキップし、undefined はビルドのキャッシュを使用することを許可します。
+
+**ログオプション:**
+
+- **`--verbose`**: デバッグのために詳細なログを有効にします。（CLIではデフォルトでtrue）
+
+**Gitオプション:**
+
+- **`--git-diff`**: ベース（デフォルトは `origin/main`）から現在のブランチ（デフォルトは `HEAD`）への変更を含む辞書のみで実行します。
+- **`--git-diff-base`**: git diff のベース参照を指定します（デフォルトは `origin/main`）。
+- **`--git-diff-current`**: git diff の現在の参照を指定します（デフォルトは `HEAD`）。
+- **`--uncommitted`**: コミットされていない変更を含めます。
+- **`--unpushed`**: プッシュされていない変更を含めます。
+- **`--untracked`**: トラッキングされていないファイルを含めます。
+
+- **`--build`**: プッシュ前に辞書をビルドして、内容が最新であることを保証します。`true` はビルドを強制し、`false` はビルドをスキップし、`undefined` はビルドのキャッシュを使用することを許可します。
+
+**ログオプション:**
+
+- **`--verbose`**: デバッグのために詳細なログ出力を有効にします。（CLIではデフォルトでtrue）
+
+**Gitオプション:**
+
+- **`--git-diff`**: ベース（デフォルトは `origin/main`）から現在のブランチ（デフォルトは `HEAD`）への変更を含む辞書のみを対象に実行します。
+- **`--git-diff-base`**: git diffのベース参照を指定します（デフォルトは `origin/main`）。
+- **`--git-diff-current`**: git diffの現在の参照を指定します（デフォルトは `HEAD`）。
+- **`--uncommitted`**: コミットされていない変更を含めます。
+- **`--unpushed`**: プッシュされていない変更を含めます。
+- **`--untracked`**: トラッキングされていないファイルを含めます。
+
+  > 例: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 例: `npx intlayer dictionary push --uncommitted --unpushed --untracked`

package/docs/ja/cli/sdk.md

@@ -0,0 +1,67 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI SDK
+description: Intlayer CLI SDKを自分のコードで使用する方法を学びます。
+keywords:
+  - SDK
+  - CLI
+  - Intlayer
+  - プログラム的
+slugs:
+  - doc
+  - concept
+  - cli
+  - sdk
+---
+
+# CLI SDK
+
+CLI SDKは、Intlayer CLIを自分のコード内で使用できるライブラリです。
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+使用例:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  listContentDeclaration,
+  testMissingTranslations,
+  docTranslate,
+  docReview,
+  transform,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+listContentDeclaration();
+// ...
+testMissingTranslations();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+transform();
+// ...
+```

package/docs/ja/cli/test.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 翻訳の欠落をテストする
+description: 辞書内の翻訳の欠落をテストし特定する方法を学びます。
+keywords:
+  - テスト
+  - 翻訳の欠落
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - test
+---
+
+# 翻訳の欠落をテストする
+
+```bash
+npx intlayer content test
+```
+
+## エイリアス:
+
+- `npx intlayer test`
+
+このコマンドは、コンテンツ宣言ファイルを解析し、設定されたすべてのロケールで欠落している翻訳を特定します。どの翻訳キーがどのロケールで欠落しているかを示す包括的なレポートを提供し、多言語コンテンツの一貫性を維持するのに役立ちます。
+
+## 出力例:
+
+```bash
+pnpm intlayer content test
+Missing translations:
+ - home-page                      - tr         - src/components/HomePage/homePage.content.ts
+ - server-component               - es, tr     - src/components/ServerComponent/serverComponent.content.ts
+ - client-component               - pl, tr     - src/components/ClientComponent/clientComponent.content.ts
+Locales: en, ru, ja, fr, ko, zh, es, de, ar, it, en-GB, pt, hi, tr, pl
+Required locales: en
+Missing locales: pl, tr, es
+Missing required locales: -
+Total missing locales: 3
+Total missing required locales: 0
+```
+
+## 引数:
+
+**設定オプション:**
+
+- **`--env`**: 環境を指定します（例: `development`、`production`）。
+- **`--env-file [envFile]`**: 変数を読み込むためのカスタム環境ファイルを指定します。
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。
+
+  > 例: `npx intlayer content test --base-dir ./src --env-file .env.production.local`
+
+- **`--no-cache`**: キャッシュを無効にします。
+
+  > 例: `npx intlayer build --no-cache`
+
+**準備オプション:**
+
+- **`--build`**: プッシュ前に辞書をビルドして、コンテンツが最新であることを保証します。true はビルドを強制し、false はビルドをスキップし、undefined はビルドのキャッシュを使用します。
+
+**ログオプション:**
+
+- **`--verbose`**: デバッグのために詳細なログを有効にします。（CLIではデフォルトでtrue）
+
+  > 例: `npx intlayer content test --verbose`
+
+## 例:
+
+```bash
+npx intlayer content test --verbose
+```
+
+この出力により、すべての設定されたロケールでアプリケーションが正しく動作するために、どの翻訳を完了する必要があるかを迅速に特定できます。

package/docs/ja/cli/transform.md

@@ -0,0 +1,65 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: コンポーネントの変換
+description: 既存のコンポーネントをIntlayerで使用するように変換する方法を学びます。
+keywords:
+  - 変換
+  - コンポーネント
+  - マイグレーション
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - transform
+---
+
+# コンポーネントの変換
+
+```bash
+npx intlayer transform
+```
+
+このコマンドはコードファイルを解析し、既存のコンポーネントをIntlayerで使用するように移行するのを支援します。対話的なファイル選択や特定ファイルの指定に対応しています。
+
+## エイリアス:
+
+- `npx intlayer trans`
+
+## 引数:
+
+**ファイル選択オプション:**
+
+- **`-f, --file [files...]`**: 変換する特定のファイルのリスト。指定しない場合、CLIは一致するファイル（`**/*.{tsx,jsx,vue,svelte,ts,js}`）をスキャンし、どのファイルを変換するか選択を促します。
+
+  > 例: `npx intlayer transform -f src/components/MyComponent.tsx`
+
+**出力オプション:**
+
+- **`-o, --output-content-declarations [outputContentDeclarations]`**: 生成されたコンテンツ宣言ファイルを保存するディレクトリ。
+
+  > 例: `npx intlayer transform -o src/content`
+
+- **`--code-only`**: コンポーネントのコードのみを変換し、コンテンツ宣言は書き込みません。
+
+  > 例: `npx intlayer transform --code-only`
+
+- **`--declaration-only`**: コンテンツ宣言のみを生成し、コンポーネントの書き換えは行いません。
+
+  > 例: `npx intlayer transform --declaration-only`
+
+**設定オプション:**
+
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。
+- **`--env`**: 環境を指定します。
+- **`--env-file`**: カスタム環境ファイルを指定します。
+- **`--verbose`**: 詳細なログ出力を有効にします。
+
+**必要なプラグイン:**
+
+transform コマンドは TypeScript / JSX ファイルでは追加プラグインなしで動作します。ただし、Vue および Svelte プロジェクトでは以下のプラグインのインストールが必要です:
+
+- **`@intlayer/vue-transformer`**: Vue ファイル用。
+- **`@intlayer/svelte-transformer`**: Svelte ファイル用。

package/docs/ja/cli/version.md

@@ -0,0 +1,24 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI バージョンの確認
+description: インストールされている Intlayer CLI のバージョンを確認する方法を学びます。
+keywords:
+  - バージョン
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - version
+---
+
+# CLI バージョンの確認
+
+```bash
+npx intlayer --version
+npx intlayer version
+```
+
+どちらのコマンドも、インストールされている Intlayer CLI のバージョンを表示します。

package/docs/ja/cli/watch.md

@@ -0,0 +1,37 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 辞書の監視
+description: コンテンツ宣言ファイルの変更を監視し、自動的に辞書をビルドする方法を学びます。
+keywords:
+  - 監視
+  - 辞書
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - watch
+---
+
+# 辞書の監視
+
+```bash
+npx intlayer watch
+```
+
+このコマンドは、コンテンツ宣言ファイルの変更を監視し、`.intlayer` ディレクトリ内に辞書をビルドします。
+このコマンドは `npx intlayer build --watch --skip-prepare` と同等です。
+
+## エイリアス:
+
+- `npx intlayer dictionaries watch`
+- `npx intlayer dictionary watch`
+- `npx intlayer dic watch`
+
+## 引数:
+
+- **`--with`**: 監視と並行してコマンドを開始します。
+
+> 例: `npx intlayer watch --with "next dev --turbopack"`

package/docs/ja/intlayer_with_svelte_kit.md

@@ -555,8 +555,9 @@ export const load: Load = ({ params }) => {
 	let { children, data }: { children: Snippet, data: LayoutData } = $props();
 
 	// ルートからのロケールでIntlayerを初期化
-	setupIntlayer(data.locale);
-
+  $effect(() => {
+      setupIntlayer(data.locale);
+  });
 	// レイアウトのコンテンツ辞書を使用
 	const layoutContent = useIntlayer('layout');
 </script>