@intlayer/docs 7.5.10 → 7.5.12

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

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // 必須
   location?: string, // オプションのラベル、デフォルト: "plugin"
   priority?: number, // コンフリクト解決のためのオプションの優先度、デフォルト: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // オプションのフォーマッター、デフォルト: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // オプションのフォーマッター、Intlayerランタイム互換性のために使用
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-JSONファイルを同期する際に辞書コンテンツに使用するフォーマッターを指定します。これにより、さまざまなi18nライブラリと互換性のある異なるメッセージフォーマット構文を使用できます。
+JSONファイルを同期する際に辞書コンテンツに使用するフォーマッターを指定します。これにより、Intlayerランタイムと互換性のある異なるメッセージフォーマット構文を使用できます。
 
+- `undefined`: フォーマッターは使用されず、JSONコンテンツはそのまま使用されます。
 - `'intlayer'`: デフォルトのIntlayerフォーマッター（デフォルト）。
 - `'icu'`: ICUメッセージフォーマットを使用します（react-intl、vue-i18nなどのライブラリと互換性があります）。
 - `'i18next'`: i18nextメッセージフォーマットを使用します（i18next、next-i18next、Solid-i18nextと互換性があります）。
 
+> フォーマッターを使用すると、JSONコンテンツの入力と出力が変換されることに注意してください。ICU複数形などの複雑なJSONルールの場合、パースは入力と出力の1対1のマッピングを保証できない場合があります。
+> Intlayerランタイムを使用しない場合は、フォーマッターを設定しない方が良いかもしれません。
+
 **例：**
 
 ```ts

package/docs/ko/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 명령어는 두 가지 모드로 작동합니다:
+
+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이 아닌 경우, 명령어는 오류로 종료됩니다.
+- 프로젝트 경로가 존재하지 않는 경우, 경고와 함께 건너뜁니다.
+- 프로젝트가 실패한 경우, 명령어는 0이 아닌 상태 코드로 종료됩니다.
+
+## 사용 사례
+
+- **모노레포 자동화**: 모노레포의 여러 프로젝트에서 Intlayer 명령어 실행
+- **CI/CD 파이프라인**: 지속적 통합 워크플로우에서 사전 관리 자동화
+- **일괄 작업**: 여러 Intlayer 프로젝트에 대해 동일한 작업을 한 번에 수행
+- **비밀 관리**: 환경 변수를 사용하여 여러 프로젝트의 자격 증명을 안전하게 관리
+
+## 보안 모범 사례
+
+- CI/CD 플랫폼에서 `INTLAYER_PROJECT_CREDENTIALS`를 암호화된 비밀 값으로 저장
+- 자격 증명을 버전 관리에 커밋하지 않기
+- 다양한 배포 환경에 대해 환경별 자격 증명 사용
+- 정기적으로 자격 증명 로테이션

package/docs/ko/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/ko/cli/build.md)** - 콘텐츠 선언 파일에서 사전을 빌드합니다.
 - **[사전 감시](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/watch.md)** - 변경 사항을 감시하고 자동으로 사전을 빌드합니다.
 - **[CLI 버전 확인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/version.md)** - 설치된 Intlayer CLI 버전을 확인합니다.
+- **[프로젝트 목록](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/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/ko/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/ko/cli/list_projects.md

@@ -0,0 +1,128 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Intlayer 프로젝트 목록
+description: 디렉터리 또는 Git 저장소에서 모든 Intlayer 프로젝트를 나열하는 방법을 알아봅니다.
+keywords:
+  - List
+  - Projects
+  - 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`
+
+- **`--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
+```
+
+### 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 관리**: 모노레포 구조에서 모든 Intlayer 프로젝트를 발견
+- **프로젝트 검색**: 워크스페이스 내 Intlayer 사용 프로젝트 찾기
+- **CI/CD**: 자동화된 워크플로우에서 Intlayer 프로젝트를 검증
+- **Documentation**: Intlayer를 사용하는 모든 프로젝트를 나열하는 문서를 생성
+
+출력은 각 프로젝트 디렉터리에 대한 절대 경로를 제공하므로 여러 Intlayer 프로젝트로 이동하거나 여러 프로젝트에 대해 스크립트를 실행하기 쉽습니다.

package/docs/ko/intlayer_CMS.md

@@ -71,6 +71,26 @@ Vite + React와 통합하려면 [설치 가이드](https://github.com/aymericzip
 
 ## 구성
 
+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/ko/intlayer_with_next-i18next.md

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

package/docs/ko/intlayer_with_nextjs_14.md

@@ -78,6 +78,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/ko/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/ko/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"