@intlayer/docs 7.5.10 → 7.5.12

package/docs/it/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // richiesto
   location?: string, // etichetta opzionale, predefinito: "plugin"
   priority?: number, // priorità opzionale per la risoluzione dei conflitti, predefinito: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // formattatore opzionale, predefinito: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // formattatore opzionale, usato per la compatibilità con il runtime Intlayer
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Specifica il formattatore da utilizzare per il contenuto del dizionario durante la sincronizzazione dei file JSON. Ciò consente di utilizzare diverse sintassi di formattazione dei messaggi compatibili con varie librerie i18n.
+Specifica il formattatore da utilizzare per il contenuto del dizionario durante la sincronizzazione dei file JSON. Ciò consente di utilizzare diverse sintassi di formattazione dei messaggi compatibili con il runtime Intlayer.
 
+- `undefined`: Nessun formattatore verrà utilizzato, il contenuto JSON sarà usato così com'è.
 - `'intlayer'`: Il formattatore Intlayer predefinito (predefinito).
 - `'icu'`: Utilizza la formattazione dei messaggi ICU (compatibile con librerie come react-intl, vue-i18n).
 - `'i18next'`: Utilizza la formattazione dei messaggi i18next (compatibile con i18next, next-i18next, Solid-i18next).
 
+> Nota che l'uso di un formattatore trasformerà il tuo contenuto JSON in input e output. Per regole JSON complesse come i plurali ICU, il parsing potrebbe non garantire una mappatura 1 a 1 tra input e output.
+> Se non usi il runtime Intlayer, potresti preferire non impostare un formattatore.
+
 **Esempio:**
 
 ```ts

package/docs/ja/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: CIコマンド
+description: CI/CDパイプラインとモノレポで自動注入された認証情報を使用してIntlayerコマンドを実行する方法を学びます。
+keywords:
+  - CI
+  - CI/CD
+  - 自動化
+  - モノレポ
+  - 認証情報
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: CIコマンドを追加
+---
+
+# CIコマンド
+
+```bash
+npx intlayer ci <command...>
+```
+
+CIコマンドは、自動化とCI/CDパイプライン用に設計されています。`INTLAYER_PROJECT_CREDENTIALS`環境変数から認証情報を自動的に注入し、モノレポ内の複数のプロジェクトでIntlayerコマンドを実行できます。
+
+## 動作方法
+
+CIコマンドは2つのモードで動作します：
+
+1. **単一プロジェクトモード**: 現在の作業ディレクトリが`INTLAYER_PROJECT_CREDENTIALS`内のプロジェクトパスのいずれかと一致する場合、その特定のプロジェクトに対してのみコマンドを実行します。
+
+2. **反復モード**: 特定のプロジェクトコンテキストが検出されない場合、すべての設定済みプロジェクトを反復処理し、それぞれに対してコマンドを実行します。
+
+## 環境変数
+
+コマンドには`INTLAYER_PROJECT_CREDENTIALS`環境変数の設定が必要です。この変数には、プロジェクトパスを認証情報にマッピングするJSONオブジェクトが含まれている必要があります：
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## パッケージマネージャーの検出
+
+CIコマンドは、`npm_config_user_agent`環境変数に基づいて使用されているパッケージマネージャー（npm、yarn、pnpm、またはbun）を自動的に検出し、Intlayerを実行するために適切なコマンドを使用します。
+
+## 引数
+
+- **`<command...>`**: 実行するIntlayerコマンド（例：`fill`、`push`、`build`）。任意のIntlayerコマンドとその引数を渡すことができます。
+
+  > 例: `npx intlayer ci fill --verbose`
+  >
+  > 例: `npx intlayer ci push`
+  >
+  > 例: `npx intlayer ci build`
+
+## 例
+
+### 単一プロジェクトモードでコマンドを実行
+
+`INTLAYER_PROJECT_CREDENTIALS`内のパスのいずれかと一致するプロジェクトディレクトリにいる場合：
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+これにより、`packages/app`プロジェクトの認証情報が自動的に注入されて`fill`コマンドが実行されます。
+
+### すべてのプロジェクトでコマンドを実行
+
+プロジェクトパスと一致しないディレクトリにいる場合、コマンドはすべての設定済みプロジェクトを反復処理します：
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+これにより、`INTLAYER_PROJECT_CREDENTIALS`で設定された各プロジェクトに対して`push`コマンドが実行されます。
+
+### 追加のフラグを渡す
+
+基になるIntlayerコマンドに任意のフラグを渡すことができます：
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### CI/CDパイプラインで使用
+
+CI/CD設定（例：GitHub Actions、GitLab CI）で、`INTLAYER_PROJECT_CREDENTIALS`をシークレットとして設定します：
+
+```yaml
+# GitHub Actionsの例
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: 辞書を埋める
+    run: npx intlayer ci fill
+```
+
+## エラーハンドリング
+
+- `INTLAYER_PROJECT_CREDENTIALS`が設定されていない場合、コマンドはエラーで終了します。
+- `INTLAYER_PROJECT_CREDENTIALS`が有効なJSONでない場合、コマンドはエラーで終了します。
+- プロジェクトパスが存在しない場合、警告とともにスキップされます。
+- いずれかのプロジェクトが失敗した場合、コマンドは非ゼロのステータスコードで終了します。
+
+## 使用例
+
+- **モノレポの自動化**: モノレポ内の複数のプロジェクトでIntlayerコマンドを実行
+- **CI/CDパイプライン**: 継続的インテグレーションワークフローでの辞書管理の自動化
+- **一括操作**: 複数のIntlayerプロジェクトに対して同じ操作を一度に実行
+- **シークレット管理**: 環境変数を使用して複数のプロジェクトの認証情報を安全に管理
+
+## セキュリティのベストプラクティス
+
+- CI/CDプラットフォームで`INTLAYER_PROJECT_CREDENTIALS`を暗号化されたシークレットとして保存
+- 認証情報をバージョン管理にコミットしない
+- 異なるデプロイ環境に対して環境固有の認証情報を使用
+- 定期的に認証情報をローテーション

package/docs/ja/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Intlayer CLIを使用して多言語ウェブサイトを管理する方法を紹介します。このオンラインドキュメントの手順に従って、数分でプロジェクトをセットアップしましょう。
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: projects listコマンドを追加
   - version: 7.5.9
     date: 2025-12-30
     changes: initコマンドを追加
@@ -119,6 +122,7 @@ Intlayer は複数の設定ファイル形式をサポートしています：
 - **[辞書のビルド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/build.md)** - コンテンツ宣言ファイルから辞書をビルドします
 - **[辞書の監視](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/watch.md)** - 変更を監視し、自動的に辞書をビルドします
 - **[CLI バージョンの確認](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/version.md)** - インストールされている Intlayer CLI のバージョンを確認します
+- **[プロジェクトの一覧表示](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/list_projects.md)** - ディレクトリまたはgitリポジトリ内のすべてのIntlayerプロジェクトを一覧表示します
 
 ### 辞書管理
 
@@ -166,6 +170,7 @@ Intlayer は複数の設定ファイル形式をサポートしています：
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Intlayer は複数の設定ファイル形式をサポートしています：
 >
 > - `npx intlayer list` は `npx intlayer content list` の代わりに使用可能
 > - `npx intlayer test` は `npx intlayer content test` の代わりに使用可能
+> - `npx intlayer projects-list` または `npx intlayer pl` は `npx intlayer projects list` の代わりに使用可能

package/docs/ja/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: コンテンツ宣言ファイルの一覧表示
 description: プロジェクト内のすべてのコンテンツ宣言ファイルを一覧表示する方法を学びます。
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: listコマンドに絶対パス出力オプションを追加
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: listコマンドにJSON出力オプションを追加
 ---
 
 # コンテンツ宣言ファイルの一覧表示
@@ -27,14 +34,36 @@ npx intlayer content list
 
 このコマンドは、プロジェクト内のすべてのコンテンツ宣言ファイルを表示し、それらの辞書キーとファイルパスを示します。すべてのコンテンツファイルの概要を把握し、Intlayerによって正しく検出されているかを確認するのに役立ちます。
 
+## 引数:
+
+- **`--json`**: 結果をフォーマットされたテキストではなくJSONとして出力します。スクリプト作成やプログラムからのアクセスに便利です。
+
+  > 例: `npx intlayer content list --json`
+
 ## 例:
 
+### コンテンツ宣言ファイルの一覧表示:
+
 ```bash
 npx intlayer content list
 ```
 
+### JSONとして出力:
+
+```bash
+npx intlayer content list --json
+```
+
+### 絶対パスとして出力:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## 出力例:
 
+### フォーマットされた出力:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 合計コンテンツ宣言ファイル数: 3
 ```
 
+### JSON出力:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 このコマンドは以下を出力します:
 
 - すべてのコンテンツ宣言ファイルのキーと相対ファイルパスを含む整形されたリスト

package/docs/ja/cli/list_projects.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Intlayer プロジェクトを一覧表示
+description: ディレクトリまたは git リポジトリ内のすべての Intlayer プロジェクトを一覧表示する方法を学びます。
+keywords:
+  - 一覧
+  - プロジェクト
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: list projects コマンドに絶対パス出力オプションを追加
+---
+
+# Intlayer プロジェクトを一覧表示
+
+```bash
+npx intlayer projects list
+```
+
+このコマンドは Intlayer の設定ファイルを含むディレクトリを検出して、すべての Intlayer プロジェクトを検索・一覧表示します。モノレポ、ワークスペース、または git リポジトリ内のすべての Intlayer プロジェクトを見つけるのに便利です。
+
+## エイリアス:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## 引数:
+
+- **`--base-dir [path]`**: 検索を開始する基準ディレクトリを指定します。デフォルトは現在の作業ディレクトリです。
+
+  > 例: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > 例: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: ベースディレクトリではなく git ルートディレクトリから検索します。モノレポや git リポジトリ内のすべての Intlayer プロジェクトを見つけるのに便利です。
+
+  > 例: `npx intlayer projects list --git-root`
+
+- **`--json`**: 結果をフォーマットされたテキストではなくJSONとして出力します。スクリプト作成やプログラムからのアクセスに便利です。
+
+  > 例: `npx intlayer projects list --json`
+
+- **`--absolute`**: 結果を相対パスではなく絶対パスとして出力します。
+
+  > 例: `npx intlayer projects list --absolute`
+
+## 動作方法:
+
+コマンドは指定したディレクトリ（`--git-root` が使用された場合は git ルート）内で Intlayer の設定ファイルを検索します。次の設定ファイルパターンを探します:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+これらのファイルのいずれかを含む各ディレクトリは Intlayer プロジェクトと見なされ、出力に一覧表示されます。
+
+## 例:
+
+### 現在のディレクトリ内のプロジェクトを一覧表示:
+
+```bash
+npx intlayer projects list
+```
+
+### 現在のディレクトリ内のプロジェクトを一覧表示:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### 特定ディレクトリ内のプロジェクトを一覧表示:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Git リポジトリ内のすべてのプロジェクトを一覧表示:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### ショートカットエイリアスを使う:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### JSONとして出力:
+
+```bash
+npx intlayer projects list --json
+```
+
+## 出力例:
+
+### フォーマットされた出力:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### JSON出力:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## ユースケース:
+
+- **Monorepo management**: モノレポ構成内のすべての Intlayer プロジェクトを検出する
+- **Project discovery**: ワークスペース内の Intlayer 対応プロジェクトを見つける
+- **CI/CD**: 自動化ワークフロー内で Intlayer プロジェクトを検証する
+- **ドキュメント**: Intlayer を使用しているすべてのプロジェクトを一覧表示するドキュメントを生成する
+
+出力は各プロジェクトディレクトリへの絶対パスを提供するため、複数の Intlayer プロジェクトに移動したり、スクリプトで操作を実行したりするのが容易になります。

package/docs/ja/intlayer_CMS.md

@@ -71,6 +71,26 @@ Vite + Reactとの統合については、[セットアップガイド](https://
 
 ## 設定
 
+Intlayer CMSにログインするには、次のコマンドを実行してください：
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+これにより、デフォルトのブラウザが開き、認証プロセスを完了し、Intlayerサービスを使用するために必要な認証情報（Client IDとClient Secret）を受け取ることができます。
+
 Intlayerの設定ファイル内で、CMSの設定をカスタマイズできます：
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ja/intlayer_with_next-i18next.md

@@ -592,7 +592,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/ja/intlayer_with_nextjs_14.md

@@ -81,6 +81,34 @@ IntlayerをNext.jsと統合するパッケージです。Next.jsの国際化の
 
 ### ステップ2: プロジェクトの設定
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 アプリケーションの言語を設定するための設定ファイルを作成します：
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ja/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ IntlayerをNext.jsと統合するパッケージです。Next.jsの国際化の
 
 ### ステップ2: プロジェクトの設定
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 アプリケーションの言語を設定するための設定ファイルを作成します：
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ja/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ IntlayerをNext.jsと統合するパッケージです。Next.jsの国際化の
 
 ### ステップ2: プロジェクトの設定
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 アプリケーションの言語を設定するための設定ファイルを作成します：
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"