@intlayer/docs 7.5.9 → 7.5.11

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/cli/push.md

@@ -23,7 +23,7 @@ slugs:
 npx intlayer dictionary push
 ```
 
-[intlayer 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 사전을 에디터로도 푸시할 수 있습니다. 이 명령어는 사전을 [에디터](https://intlayer.org/dashboard)에서 사용할 수 있도록 합니다. 이를 통해 팀과 사전을 공유하고 애플리케이션 코드를 수정하지 않고도 콘텐츠를 편집할 수 있습니다.
+[intlayer 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 사전을 에디터로도 푸시할 수 있습니다. 이 명령어는 사전을 [에디터](https://app.intlayer.org/)에서 사용할 수 있도록 합니다. 이를 통해 팀과 사전을 공유하고 애플리케이션 코드를 수정하지 않고도 콘텐츠를 편집할 수 있습니다.
 
 ## 별칭:
 

package/docs/ko/configuration.md

@@ -245,14 +245,14 @@ module.exports = config;
 - **clientId**:
   - _유형_: `string` | `undefined`
   - _기본값_: `undefined`
-  - _설명_: clientId와 clientSecret은 intlayer 패키지가 oAuth2 인증을 사용하여 백엔드와 인증할 수 있도록 합니다. 액세스 토큰은 프로젝트와 관련된 사용자를 인증하는 데 사용됩니다. 액세스 토큰을 얻으려면 https://intlayer.org/dashboard/project 에서 계정을 생성하세요.
+  - _설명_: clientId와 clientSecret은 intlayer 패키지가 oAuth2 인증을 사용하여 백엔드와 인증할 수 있도록 합니다. 액세스 토큰은 프로젝트와 관련된 사용자를 인증하는 데 사용됩니다. 액세스 토큰을 얻으려면 https://app.intlayer.org/project 에서 계정을 생성하세요.
   - _예시_: `true`
   - _참고_: 중요: clientId와 clientSecret은 비밀로 유지되어야 하며 공개적으로 공유되어서는 안 됩니다. 환경 변수와 같은 안전한 위치에 보관하시기 바랍니다.
 
 - **clientSecret**:
   - _유형_: `string` | `undefined`
   - _기본값_: `undefined`
-  - _설명_: clientId와 clientSecret은 intlayer 패키지가 oAuth2 인증을 사용하여 백엔드와 인증할 수 있도록 합니다. 액세스 토큰은 프로젝트와 관련된 사용자를 인증하는 데 사용됩니다. 액세스 토큰을 얻으려면 https://intlayer.org/dashboard/project 에서 계정을 생성하세요.
+  - _설명_: clientId와 clientSecret은 intlayer 패키지가 oAuth2 인증을 사용하여 백엔드와 인증할 수 있도록 합니다. 액세스 토큰은 프로젝트와 관련된 사용자를 인증하는 데 사용됩니다. 액세스 토큰을 얻으려면 https://app.intlayer.org/project 에서 계정을 생성하세요.
   - _예시_: `true`
   - _참고_: 중요: clientId와 clientSecret은 비밀로 유지되어야 하며 공개적으로 공유해서는 안 됩니다. 환경 변수와 같은 안전한 위치에 보관하시기 바랍니다.
 
@@ -468,7 +468,7 @@ module.exports = config;
 
 Intlayer의 AI 기능을 제어하는 설정으로, 제공자(provider), 모델(model), API 키를 포함합니다.
 
-이 구성은 [Intlayer 대시보드](https://intlayer.org/dashboard/project)에 액세스 키로 등록된 경우 선택 사항입니다. Intlayer는 귀하의 요구에 가장 효율적이고 비용 효과적인 AI 솔루션을 자동으로 관리합니다. 기본 옵션을 사용하면 Intlayer가 가장 적합한 모델을 지속적으로 업데이트하므로 장기적인 유지 관리가 더 용이합니다.
+이 구성은 [Intlayer 대시보드](https://app.intlayer.org/project)에 액세스 키로 등록된 경우 선택 사항입니다. Intlayer는 귀하의 요구에 가장 효율적이고 비용 효과적인 AI 솔루션을 자동으로 관리합니다. 기본 옵션을 사용하면 Intlayer가 가장 적합한 모델을 지속적으로 업데이트하므로 장기적인 유지 관리가 더 용이합니다.
 
 자신의 API 키나 특정 모델을 사용하려는 경우, 사용자 정의 AI 구성을 정의할 수 있습니다.
 이 AI 구성은 Intlayer 환경 전반에 걸쳐 전역적으로 사용됩니다. CLI 명령어는 이 설정을 기본값으로 사용하며(예: `fill`), SDK, 비주얼 에디터, CMS에서도 동일하게 적용됩니다. 특정 사용 사례에 대해서는 명령어 매개변수를 사용하여 이러한 기본값을 재정의할 수 있습니다.

package/docs/ko/interest_of_intlayer.md

@@ -227,7 +227,7 @@ const ComponentExample = () => {
 | 기능                                                                                                                      | 설명                                                                                                                                                                                                                                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **크로스 프레임워크 지원**<br><br>Intlayer는 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 등 주요 프레임워크와 라이브러리를 모두 지원합니다.                                                                                                                                                                                                                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true)       | **자바스크립트 기반 콘텐츠 관리**<br><br>자바스크립트의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리하세요. <br><br> - [콘텐츠 선언](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **자바스크립트 기반 콘텐츠 관리**<br><br>자바스크립트의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리하세요. <br><br> - [콘텐츠 선언](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                   |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **로케일별 콘텐츠 선언 파일**<br><br>자동 생성 전에 콘텐츠를 한 번 선언하여 개발 속도를 높이세요.<br><br> - [로케일별 콘텐츠 선언 파일](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                               |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **타입 안전 환경**<br><br>TypeScript를 활용하여 콘텐츠 정의와 코드에 오류가 없도록 보장하고, IDE 자동 완성 기능도 함께 누리세요.<br><br> - [TypeScript 설정](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                  |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **간소화된 설정**<br><br>최소한의 구성으로 빠르게 시작하세요. 국제화, 라우팅, AI, 빌드 및 콘텐츠 처리 설정을 손쉽게 조정할 수 있습니다.<br><br> - [Next.js 통합 탐색](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                      |

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"
@@ -92,7 +112,7 @@ const config: IntlayerConfig = {
      *
      * 편집기를 활성화하려면 클라이언트 ID와 클라이언트 시크릿이 필요합니다.
      * 이를 통해 콘텐츠를 편집하는 사용자를 식별할 수 있습니다.
-     * Intlayer 대시보드 - 프로젝트(https://intlayer.org/dashboard/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
+     * Intlayer 대시보드 - 프로젝트(https://app.intlayer.org/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -142,7 +162,7 @@ const config = {
      *
      * 편집기를 활성화하려면 클라이언트 ID와 클라이언트 시크릿이 필요합니다.
      * 이를 통해 콘텐츠를 편집하는 사용자를 식별할 수 있습니다.
-     * Intlayer 대시보드 - 프로젝트(https://intlayer.org/dashboard/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
+     * Intlayer 대시보드 - 프로젝트(https://app.intlayer.org/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -192,7 +212,7 @@ const config = {
      *
      * 에디터를 활성화하려면 클라이언트 ID와 클라이언트 시크릿이 필요합니다.
      * 이를 통해 콘텐츠를 편집하는 사용자를 식별할 수 있습니다.
-     * Intlayer 대시보드 - 프로젝트(https://intlayer.org/dashboard/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
+     * Intlayer 대시보드 - 프로젝트(https://app.intlayer.org/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -224,7 +244,7 @@ const config = {
 module.exports = config;
 ```
 
-> 클라이언트 ID와 클라이언트 시크릿이 없는 경우, [Intlayer 대시보드 - 프로젝트](https://intlayer.org/dashboard/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
+> 클라이언트 ID와 클라이언트 시크릿이 없는 경우, [Intlayer 대시보드 - 프로젝트](https://app.intlayer.org/projects)에서 새 클라이언트를 생성하여 얻을 수 있습니다.
 
 > 사용 가능한 모든 매개변수를 확인하려면 [구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
 
@@ -264,7 +284,7 @@ npx intlayer dictionary push -d my-first-dictionary-key --env production
 
 ### 사전 편집
 
-그런 다음 [Intlayer CMS](https://intlayer.org/dashboard/content)에서 사전을 보고 관리할 수 있습니다.
+그런 다음 [Intlayer CMS](https://app.intlayer.org/content)에서 사전을 보고 관리할 수 있습니다.
 
 ## 라이브 동기화
 

package/docs/ko/intlayer_with_express.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - express
+applicationTemplate: https://github.com/aymericzip/intlayer-express-template
 history:
   - version: 7.5.9
     date: 2025-12-30