@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/ko/autoFill.md

@@ -25,8 +25,56 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "이력 초기화"
+author: aymericzip
 ---
 
+# 콘텐츠 선언 파일 번역 채우기
+
+**CI에서 콘텐츠 선언 파일 자동 채우기**는 개발 워크플로우를 가속화하는 방법입니다.
+
+## 동작 이해하기
+
+`fill` 명령은 두 가지 모드를 포함합니다:
+
+- **Complete**: 각 로케일에 대해 누락된 모든 콘텐츠를 자동으로 채우고 현재 파일을 편집하거나, 지정된 경우 다른 파일을 편집합니다. 즉, complete 모드는 이미 번역된 경우 기존 콘텐츠의 번역을 건너뜁니다.
+- **Review**: 각 로케일에 대해 **모든** 콘텐츠를 자동으로 채우고 특정 파일에 대해 생성하거나, 지정된 경우 다른 파일을 생성합니다.
+
+`fill` 명령은 모든 로케일 콘텐츠 선언 파일을 처리합니다. 즉, CMS의 원격 콘텐츠는 처리하지 않습니다. CMS는 자체 번역 관리를 포함합니다.
+`@intlayer/sync-json-plugin`과 같은 플러그인을 사용하는 경우, Intlayer는 JSON 파일을 로케일 콘텐츠 선언 파일로 변환합니다. 즉, `fill` 명령으로 처리됩니다.
+
+새로 생성된 파일에는 사전 메타데이터로 `filled` 지시사항이 포함됩니다. 이 지시사항은 Intlayer가 파일이 자동으로 채워졌는지 여부를 알고, 존재하는 경우 이 파일을 다시 번역하지 않도록 건너뛰는 데 사용됩니다.
+
+Intlayer는 자동 채우기를 위해 다음 지시사항도 고려합니다:
+
+- `.content.{ts|js|json}` → `fill` 지시사항
+- 구성 파일 `.intlayer.config.ts` → `dictionary.fill` 지시사항
+- 그 외의 경우 기본값으로 `true`로 설정됨
+
+로케일별 콘텐츠 선언 파일의 경우, `true` 지시사항은 `./{{fileName}}.fill.content.json`으로 대체됩니다. 이는 로케일별 콘텐츠 선언 파일이 추가 지역화된 콘텐츠를 받을 수 없기 때문입니다. 따라서 기존 파일을 덮어쓰지 않기 위해 새 파일을 생성합니다.
+
+## Default Behavior
+
+기본적으로 `fill`은 전역적으로 `true`로 설정되어 있으며, 이는 Intlayer가 모든 콘텐츠 파일을 자동으로 채우고 파일 자체를 편집한다는 의미입니다. 이 동작은 여러 방법으로 사용자 정의할 수 있습니다:
+
+### 글로벌 구성 옵션
+
+1. **`fill: true` (기본값)** - 모든 로케일을 자동으로 채우고 현재 파일을 편집합니다
+2. **`fill: false`** - 이 콘텐츠 파일에 대한 자동 채우기를 비활성화합니다
+3. **`fill: "./relative/path/to/file"`** - 현재 파일을 편집하지 않고 현재 파일의 위치를 기반으로 해석되는 상대 경로를 가리켜 지정된 파일을 만들거나 업데이트합니다
+4. **`fill: "/absolute/path/to/file"`** - 현재 파일을 편집하지 않고 기본 디렉토리의 위치를 기반으로 해석되는 상대 경로를 가리켜 지정된 파일을 만들거나 업데이트합니다 (구성 파일 `.intlayer.config.ts`의 `baseDir` 필드)
+5. **`fill: "C:\\absolute\path\to\file"`** - 현재 파일을 편집하지 않고 운영 체제를 기반으로 해석되는 절대 경로를 가리켜 지정된 파일을 만들거나 업데이트합니다
+6. **`fill: { [key in Locales]?: string }`** - 각 로케일에 대해 지정된 파일을 만들거나 업데이트합니다
+
+### v7 동작 변경 사항
+
+v7에서는 `fill` 명령 동작이 업데이트되었습니다:
+
+- **`fill: true`** - 현재 파일을 모든 로케일의 채워진 콘텐츠로 다시 작성합니다
+- **`fill: "path/to/file"`** - 현재 파일을 수정하지 않고 지정된 파일을 채웁니다
+- **`fill: false`** - 자동 채우기를 완전히 비활성화합니다
+
+다른 파일에 쓰기 위해 경로 옵션을 사용할 때, fill 메커니즘은 콘텐츠 선언 파일 간의 _master-slave_ 관계를 통해 작동합니다. 메인(master) 파일이 소스 오브 트루스 역할을 하며, 업데이트될 때 Intlayer는 경로로 지정된 파생(filled) 선언 파일에 자동으로 그 변경 사항을 적용합니다.
+
 # 자동 채우기 콘텐츠 선언 파일 번역
 
 **자동 채우기 콘텐츠 선언 파일**은 개발 워크플로우를 가속화하는 방법입니다.
@@ -87,6 +135,40 @@ Intlayer는 메인 파일에 아직 선언되지 않은 모든 로케일을 채
 
 그 후, 두 선언 파일은 단일 사전으로 병합되어 표준 `useIntlayer("example")` 훅(react) / 컴포저블(vue)을 통해 접근할 수 있습니다.
 
+## 글로벌 설정
+
+`intlayer.config.ts` 파일에서 글로벌 자동 채우기 설정을 구성할 수 있습니다.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // 모든 사전에 대해 누락된 번역 자동 생성
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // "./{{fileName}}.content.json"을 사용하는 것처럼 모든 사전에 대해 누락된 번역 자동 생성
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+content 파일의 `fill` 필드를 사용하여 사전별로 세부 조정할 수 있습니다. Intlayer는 먼저 사전별 구성을 고려한 후 글로벌 구성으로 돌아갑니다.
+
 ## 자동 채워진 파일 형식
 
 자동 채워진 선언 파일에 권장되는 형식은 **JSON**으로, 형식 제약을 피하는 데 도움이 됩니다. 그러나 Intlayer는 `.ts`, `.js`, `.mjs`, `.cjs` 및 기타 형식도 지원합니다.

package/docs/ko/benchmark/index.md

@@ -17,6 +17,7 @@ history:
   - version: 8.7.5
     date: 2026-01-06
     changes: "벤치마크 초기화"
+author: aymericzip
 ---
 
 # Benchmark - 리포트

package/docs/ko/benchmark/nextjs.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - nextjs
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
   - version: 8.9.8

package/docs/ko/benchmark/solid.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - solid
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
   - version: 8.9.8
@@ -118,6 +118,28 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 - **Scoped static**: 복잡한 추가 네트워크 요청 없이 코드 구조를 유지(논리적 분리).
 - **Scoped dynamic**: 코드 분할 및 성능을 위한 최선의 접근 방식. 현재 뷰와 활성 로케일에 필요한 것만 로드하여 메모리 사용을 최소화함.
 
+### 측정 내용:
+
+각 스택에 대해 실제 브라우저에서 동일한 다국어 앱을 실행한 후 실제로 전송된 내용과 소요 시간을 기록했습니다. 크기는 **일반적인 웹 압축 후**에 보고되었습니다. 이는 원본 소스 수보다 사람들이 다운로드하는 내용에 더 가깝기 때문입니다.
+
+- **국제화 라이브러리 크기**: 번들링, 트리 셰이킹 및 축소 후 i18n 라이브러리의 크기는 빈 컴포넌트의 제공자 + 훅/프리미티브 코드의 크기입니다. 여기에는 번역 파일 로딩이 포함되지 않습니다. 콘텐츠가 들어오기 전에 라이브러리가 얼마나 비싼지 답변합니다.
+
+- **페이지당 JavaScript**: 각 벤치마크 경로의 경우, 그 방문 시 브라우저가 가져오는 스크립트의 양은 스위트의 페이지 전체에서 평균화됩니다(보고서가 롤업하는 로케일 전체). 무거운 페이지는 느린 페이지입니다.
+
+- **다른 로케일의 누수**: 감사된 페이지에 실수로 로드되는 다른 언어의 동일 페이지 콘텐츠입니다. 이 콘텐츠는 불필요하며 피해야 합니다. (예: `/en/about` 페이지 번들의 `/fr/about` 페이지 콘텐츠)
+
+- **다른 경로의 누수**: **다른 화면**의 경우 동일한 개념입니다. 한 페이지만 열었을 때 해당 사본이 함께 로드되는지 여부입니다. (예: `/en/contact` 페이지 번들의 `/en/about` 페이지 콘텐츠). 높은 점수는 약한 분할이나 과도하게 광범위한 번들을 의미합니다.
+
+- **평균 컴포넌트 번들 크기**: 일반적인 UI 조각은 하나의 거대한 앱 번호 내에 숨기는 대신 **한 번에 하나씩** 측정됩니다. 국제화가 일반적인 컴포넌트를 조용히 부풀리는지 여부를 보여줍니다. 예를 들어, 컴포넌트가 다시 렌더링되면 메모리에서 모든 데이터를 로드합니다. 거대한 JSON을 컴포넌트에 연결하는 것은 컴포넌트의 성능을 느리게 할 사용하지 않은 데이터의 큰 저장소를 연결하는 것과 같습니다.
+
+- **언어 전환 반응성**: 앱의 고유한 제어 기능을 사용하여 언어를 전환하고 페이지가 명확하게 전환될 때까지 걸리는 시간을 기록합니다. 이는 방문자가 알아차릴 미시적 단계가 아닌 것입니다.
+
+- **언어 변경 후 렌더링 작업**: 더 좁은 후속 작업입니다. 전환이 진행 중일 때 새로운 언어로 다시 칠하는 데 인터페이스가 소비한 노력입니다. "느껴지는" 시간과 프레임워크 비용이 다를 때 유용합니다.
+
+- **초기 페이지 로드 시간**: 네비게이션에서 브라우저가 테스트한 시나리오에 대해 페이지가 완전히 로드되었다고 간주할 때까지의 시간입니다. 콜드 스타트를 비교하는 데 좋습니다.
+
+- **하이드레이션 시간**: 앱이 노출하는 경우, 클라이언트가 서버 HTML을 실제로 클릭할 수 있는 것으로 변환하는 데 소비하는 시간입니다. 표의 대시는 해당 구현이 이 벤치마크에서 신뢰할 수 있는 하이드레이션 수치를 제공하지 않았음을 의미합니다.
+
 ## GitHub 스타
 
 GitHub 스타는 프로젝트의 인기, 커뮤니티 신뢰 및 장기적인 관련성을 나타내는 강력한 지표입니다. 기술적 품질을 직접적으로 측정하는 것은 아니지만, 얼마나 많은 개발자가 프로젝트가 유용하다고 생각하고 진행 상황을 팔로우하며 채택할 가능성이 있는지를 반영합니다. 프로젝트의 가치를 평가할 때 스타는 대안 간의 견인력을 비교하는 데 도움이 되며 생태계 성장에 대한 통찰력을 제공합니다.

package/docs/ko/benchmark/svelte.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - svelte
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
   - version: 8.9.8
@@ -116,6 +116,28 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 - **Scoped static**: 복잡한 추가 네트워크 요청 없이 코드 구조를 유지(논리적 분리).
 - **Scoped dynamic**: 코드 분할 및 성능을 위한 최선의 접근 방식. 현재 뷰와 활성 로케일에 필요한 것만 로드하여 메모리 사용을 최소화함.
 
+### 측정한 항목:
+
+동일한 다국어 앱을 모든 스택에서 실제 브라우저로 실행하고, 실제로 전송된 내용과 소요 시간을 기록했습니다. 크기는 **일반적인 웹 압축 후** 보고되며, 이는 원본 소스 크기보다 사용자가 실제로 다운로드하는 내용에 더 가깝습니다.
+
+- **국제화 라이브러리 크기**: 번들링, 트리 쉐이킹 및 최소화 후, i18n 라이브러리의 크기는 빈 컴포넌트의 providers + stores 코드 크기입니다. 번역 파일 로딩은 포함되지 않습니다. 콘텐츠가 포함되기 전 라이브러리의 비용이 어느 정도인지 나타냅니다.
+
+- **페이지당 JavaScript**: 각 벤치마크 경로에 대해 해당 방문에서 브라우저가 가져오는 스크립트의 양입니다. 이는 스위트의 페이지들과 리포트가 롤업하는 로케일들 전체에서 평균화됩니다. 무거운 페이지는 느린 페이지입니다.
+
+- **다른 로케일에서의 누수**: 감사된 페이지에서 실수로 로드될 수 있는 다른 언어의 동일한 페이지 콘텐츠입니다. 이 콘텐츠는 불필요하며 피해야 합니다. (예: `/en/about` 페이지 번들에서 `/fr/about` 페이지 콘텐츠)
+
+- **다른 경로에서의 누수**: **다른 화면**의 경우도 마찬가지입니다. 한 페이지만 열었을 때 해당 복사본이 함께 로드되는지 여부입니다. (예: `/en/contact` 페이지 번들에서 `/en/about` 페이지 콘텐츠). 높은 점수는 약한 분할 또는 과도하게 광범위한 번들을 시사합니다.
+
+- **평균 컴포넌트 번들 크기**: 하나의 거대한 앱 번호 내에 숨겨지지 않고 **한 번에 하나씩** 측정된 일반적인 UI 조각들입니다. 국제화가 일상적인 컴포넌트를 어느 정도 증가시키는지 보여줍니다. 예를 들어, 컴포넌트가 다시 렌더링되면 메모리에서 모든 데이터를 로드합니다. 거대한 JSON을 컴포넌트에 연결하는 것은 컴포넌트의 성능을 느리게 할 거대한 미사용 데이터 저장소를 연결하는 것과 같습니다.
+
+- **언어 전환 반응성**: 앱의 자체 컨트롤을 사용하여 언어를 전환하고 페이지가 명확하게 전환될 때까지의 시간을 측정합니다. 이는 방문자가 눈으로 보게 되는 시간이지, 랩 마이크로 스텝이 아닙니다.
+
+- **언어 변경 후 렌더링 작업**: 더 좁은 후속 조치입니다. 전환이 진행 중인 상태에서 새 언어를 위해 인터페이스가 다시 칠하는 데 소요된 노력의 정도입니다. "느껴지는" 시간과 프레임워크 비용이 다를 때 유용합니다.
+
+- **초기 페이지 로드 시간**: 테스트한 시나리오에 대해 브라우저가 페이지를 완전히 로드된 것으로 간주할 때까지의 시간입니다. 콜드 시작을 비교하는 데 유용합니다.
+
+- **Hydration 시간**: 앱이 노출할 때, 클라이언트가 서버 HTML을 실제로 클릭할 수 있는 것으로 변환하는 데 소요되는 시간입니다. 표의 대시는 해당 구현이 이 벤치마크에서 신뢰할 수 있는 hydration 수치를 제공하지 않음을 의미합니다.
+
 ## GitHub 스타
 
 GitHub 스타는 프로젝트의 인기, 커뮤니티 신뢰 및 장기적인 관련성을 나타내는 강력한 지표입니다. 기술적 품질을 직접적으로 측정하는 것은 아니지만, 얼마나 많은 개발자가 프로젝트가 유용하다고 생각하고 진행 상황을 팔로우하며 채택할 가능성이 있는지를 반영합니다. 프로젝트의 가치를 평가할 때 스타는 대안 간의 견인력을 비교하는 데 도움이 되며 생태계 성장에 대한 통찰력을 제공합니다.

package/docs/ko/benchmark/tanstack.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - tanstack
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
   - version: 8.9.8
@@ -124,6 +124,28 @@ i18n 누수 문제를 빠르게 파악하기 위해 [여기](https://intlayer.or
 - **Scoped static**: 복잡한 추가 네트워크 요청 없이 코드 구조를 유지(논리적 분리).
 - **Scoped dynamic**: 코드 분할 및 성능을 위한 최선의 접근 방식. 현재 뷰와 활성 로케일에 필요한 것만 로드하여 메모리 사용을 최소화함.
 
+### 측정 항목:
+
+모든 스택에 대해 실제 브라우저에서 동일한 다국어 앱을 실행하고, 실제로 전송되는 내용과 소요 시간을 기록했습니다. 크기는 **일반적인 웹 압축 후**에 보고되며, 이는 원본 소스 크기보다 사용자가 다운로드하는 내용에 더 가깝습니다.
+
+- **Internationalization 라이브러리 크기**: 번들링, 트리-셰이킹 및 최소화 후, i18n 라이브러리의 크기는 프로바이더(예: `NextIntlClientProvider`) + 훅(예: `useTranslations`) 코드의 크기를 빈 컴포넌트에서 측정한 것입니다. 번역 파일 로딩은 포함되지 않습니다. 콘텐츠가 들어오기 전에 라이브러리가 얼마나 비용이 드는지를 답합니다.
+
+- **페이지당 JavaScript**: 각 벤치마크 경로에 대해 방문 시 브라우저가 가져오는 스크립트의 양으로, 스위트의 페이지 전체에서 평균화됩니다(리포트가 롤업하는 경우 로케일 전체에서). 무거운 페이지는 느린 페이지입니다.
+
+- **다른 로케일에서의 유출**: 감사된 페이지에 실수로 로드될 수 있는 다른 언어의 동일한 페이지 콘텐츠입니다. 이 콘텐츠는 불필요하며 피해야 합니다. (예: `/en/about` 페이지 번들에서 `/fr/about` 페이지 콘텐츠)
+
+- **다른 경로에서의 유출**: **다른 화면**의 콘텐츠가 한 페이지만 열었을 때 함께 로드되는지 여부에 대한 동일한 개념입니다. (예: `/en/contact` 페이지 번들에서 `/en/about` 페이지 콘텐츠). 높은 점수는 약한 분할 또는 과도하게 넓은 번들을 시사합니다.
+
+- **평균 컴포넌트 번들 크기**: 일반적인 UI 조각들은 한 번에 하나씩 측정되며, 거대한 앱 번호 안에 숨겨지지 않습니다. internationalization이 일상적인 컴포넌트를 조용히 부풀리는지 여부를 보여줍니다. 예를 들어, 컴포넌트가 다시 렌더링되면 메모리에서 모든 데이터를 로드하게 됩니다. 거대한 JSON을 컴포넌트에 연결하는 것은 컴포넌트의 성능을 저하시킬 수 있는 사용되지 않은 데이터의 큰 저장소에 연결하는 것과 같습니다.
+
+- **언어 전환 반응성**: 앱의 자체 컨트롤을 사용하여 언어를 전환하고 페이지가 명확하게 전환될 때까지의 소요 시간을 측정합니다. 방문자가 알 수 있는 수준이며, 실험실 마이크로 단계가 아닙니다.
+
+- **언어 변경 후 렌더링 작업**: 더 좁은 후속 작업으로, 전환이 진행 중일 때 새 언어를 다시 칠하기 위해 인터페이스가 소비한 노력입니다. "느껴지는" 시간과 프레임워크 비용이 다를 때 유용합니다.
+
+- **초기 페이지 로드 시간**: 탐색에서 브라우저가 테스트한 시나리오에 대해 페이지가 완전히 로드되었다고 간주할 때까지의 시간입니다. 콜드 스타트를 비교하는 데 좋습니다.
+
+- **수화 시간**: 앱이 노출할 때, 클라이언트가 서버 HTML을 실제로 클릭할 수 있는 것으로 변환하는 데 소비하는 시간입니다. 테이블의 대시는 해당 구현이 이 벤치마크에서 신뢰할 수 있는 수화 수치를 제공하지 않았음을 의미합니다.
+
 ## GitHub 스타
 
 GitHub 스타는 프로젝트의 인기, 커뮤니티 신뢰 및 장기적인 관련성을 나타내는 강력한 지표입니다. 기술적 품질을 직접적으로 측정하는 것은 아니지만, 얼마나 많은 개발자가 프로젝트가 유용하다고 생각하고 진행 상황을 팔로우하며 채택할 가능성이 있는지를 반영합니다. 프로젝트의 가치를 평가할 때 스타는 대안 간의 견인력을 비교하는 데 도움이 되며 생태계 성장에 대한 통찰력을 제공합니다.

package/docs/ko/benchmark/vue.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - vue
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
   - version: 8.9.8

package/docs/ko/bundle_optimization.md

@@ -22,6 +22,7 @@ history:
   - version: 8.7.0
     date: 2026-04-08
     changes: "빌드 구성에 `minify` 및 `purge` 옵션 추가"
+author: aymericzip
 ---
 
 # i18n 번들 크기 및 성능 최적화
@@ -396,11 +397,11 @@ export default config;
 
 ### 빌드 옵션
 
-| 속성           | 타입                   | 기본값      | 설명                                                                                                                                                                          |
-| :------------- | :--------------------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`optimize`** | `boolean \| undefined` | `undefined` | 가져오기(import) 재작성 패스를 활성화합니다. `undefined` = 프로덕션 빌드에서만 활성화됩니다. `false`는 purge 및 minify도 비활성화합니다.                                      |
-| **`minify`**   | `boolean`              | `false`     | 컴파일된 JSON 파일에서 콘텐츠 필드 키의 이름을 짧은 알파벳 별칭으로 바꿉니다. 소스 코드에서 일치하는 속성 접근도 재작성합니다. `optimize`가 `false`이면 아무 효과가 없습니다. |
-| **`purge`**    | `boolean`              | `false`     | 컴파일된 JSON 파일에서 소스 코드를 통해 정적으로 접근되지 않는 콘텐츠 필드를 제거합니다. `optimize`가 `false`이면 아무 효과가 없습니다.                                       |
+| 속성           | 타입                  | 기본값      | 설명                                                                                                                                                                          |
+| :------------- | :-------------------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`optimize`** | `boolean / undefined` | `undefined` | 가져오기(import) 재작성 패스를 활성화합니다. `undefined` = 프로덕션 빌드에서만 활성화됩니다. `false`는 purge 및 minify도 비활성화합니다.                                      |
+| **`minify`**   | `boolean`             | `false`     | 컴파일된 JSON 파일에서 콘텐츠 필드 키의 이름을 짧은 알파벳 별칭으로 바꿉니다. 소스 코드에서 일치하는 속성 접근도 재작성합니다. `optimize`가 `false`이면 아무 효과가 없습니다. |
+| **`purge`**    | `boolean`             | `false`     | 컴파일된 JSON 파일에서 소스 코드를 통해 정적으로 접근되지 않는 콘텐츠 필드를 제거합니다. `optimize`가 `false`이면 아무 효과가 없습니다.                                       |
 
 ### 최소화 (필드 키 이름 변경)
 

package/docs/ko/cli/build.md

@@ -17,6 +17,7 @@ history:
   - version: 8.1.5
     date: 2026-02-23
     changes: "checkTypes 옵션 추가"
+author: aymericzip
 ---
 
 # 사전 빌드하기

package/docs/ko/cli/ci.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.11
     date: 2026-01-06
     changes: "CI 명령어 추가"
+author: aymericzip
 ---
 
 # CI 명령어
@@ -139,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Scaffolded GitHub Actions
+
+`intlayer init`을 실행하면, Intlayer가 package manager(npm, yarn, pnpm, 또는 bun)를 감지하고 `.github/workflows/` 디렉토리 아래에 해당 package manager와 일치하는 명령어를 포함한 두 개의 GitHub Actions 워크플로우를 생성합니다:
+
+- **`intlayer-fill.yml`** — 모든 pull request에서 dictionaries를 빌드하고 `intlayer fill --git-diff --mode complete`을 실행하여 변경된 dictionaries에 대한 누락된 번역을 생성한 후, 결과를 PR 브랜치에 커밋합니다.
+- **`intlayer-test.yml`** — 모든 pull request에서 dictionaries를 빌드하고 `intlayer test`를 실행하여, 필수 locales에 번역이 누락된 경우 체크를 실패합니다.
+
+기존 워크플로우 파일은 절대 덮어씌워지지 않습니다. scaffolding을 완전히 건너뛰려면, 다음을 실행합니다:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### fill 워크플로우에 AI 접근 제공
+
+스캐폴드된 `intlayer-fill.yml`은 AI 접근이 필요합니다. 두 가지 옵션을 사용할 수 있습니다(워크플로우의 `env` 블록에서 구성):
+
+1. **자신의 AI provider 키** — 리포지토리 설정(Settings → Secrets and variables → Actions)에서 `AI_API_KEY` secret을 추가합니다. 워크플로우는 `--provider`, `--model`, `--api-key`를 통해 이를 전달합니다.
+2. **Intlayer CMS 접근 키** — `INTLAYER_CLIENT_ID` 및 `INTLAYER_CLIENT_SECRET` secret을 추가하고 `intlayer.config` `editor` 섹션에 연결합니다. CMS 접근 키는 Intlayer backend을 통해 AI 접근을 제공합니다.
+
+`intlayer-test.yml` 워크플로우는 AI 접근이 필요하지 않습니다.
+
 ## 오류 처리
 
 - `INTLAYER_PROJECT_CREDENTIALS`가 설정되지 않은 경우, 명령어는 오류로 종료됩니다.

package/docs/ko/cli/configuration.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - configuration
+author: aymericzip
 ---
 
 # 구성 관리

package/docs/ko/cli/debug.md

@@ -13,6 +13,7 @@ slugs:
   - concept
   - cli
   - debug
+author: aymericzip
 ---
 
 # Intlayer 명령어 디버깅

package/docs/ko/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: 문서 검토
 description: 다양한 로케일에서 문서 파일의 품질, 일관성 및 완전성을 검토하는 방법을 알아보세요.
 keywords:
@@ -15,6 +15,11 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "--log 옵션 추가"
+author: aymericzip
 ---
 
 # 문서 검토
@@ -54,8 +59,110 @@ bun x intlayer doc review
 
 ## 인수:
 
-`doc review` 명령어는 `doc translate`와 동일한 인수를 받아 특정 문서 파일을 검토하고 품질 검사를 적용할 수 있습니다.
+**파일 목록 옵션:**
 
-git 옵션 중 하나를 활성화한 경우, 명령어는 변경된 파일 부분만 검토합니다. 스크립트는 파일을 청크 단위로 처리하고 각 청크를 검토합니다. 청크에 변경 사항이 없으면 검토 프로세스를 가속화하고 AI 제공자 API 비용을 제한하기 위해 해당 청크를 건너뜁니다.
+- **`--doc-pattern [docPattern...]`**: 검토할 문서 파일과 일치하는 Glob 패턴입니다.
 
-전체 인수 목록은 [문서 번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-translate.md) 명령어 문서를 참조하세요.
+  > 예시: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: 검토에서 제외할 Glob 패턴입니다.
+
+  > 예시: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: 지정된 시간 이전에 수정된 파일은 건너뜁니다.
+  - "2025-12-05"와 같은 절대 시간 (문자열 또는 Date)일 수 있습니다.
+  - `1 * 60 * 60 * 1000` (1시간)과 같은 상대 시간(ms)일 수 있습니다.
+  - 이 옵션은 `fs.stat` 메서드를 사용하여 파일의 수정 시간을 확인합니다. 따라서 Git이나 파일을 수정하는 다른 도구의 영향을 받을 수 있습니다.
+
+  > 예시: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: 지정된 시간 이내에 수정된 파일은 건너뜁니다.
+  - "2025-12-05"와 같은 절대 시간(문자열 또는 Date)일 수 있습니다.
+  - `1 * 60 * 60 * 1000` (1시간)과 같은 상대 시간(ms)일 수 있습니다.
+  - 이 옵션은 `fs.stat` 메서드를 사용하여 파일의 수정 시간을 확인합니다. 따라서 Git이나 파일을 수정하는 다른 도구의 영향을 받을 수 있습니다.
+
+  > 예시: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: 파일이 이미 존재하면 건너뜁니다.
+
+  > 예시: `npx intlayer doc review --skip-if-exists`
+
+**검토 모드 옵션:**
+
+- **`--log`**: 로그 전용 모드. AI로 번역하지 않고, 대신 다른 에이전트가 번역을 생성할 수 있도록 기본 및 대상 로케일에 대해 주의가 필요한 블록(줄 번호 및 내용 포함)을 기록합니다.
+
+  > 예시: `npx intlayer doc review --log`
+
+**출력 옵션:**
+
+- **`--locales [locales...]`**: 문서를 검토할 대상 로케일입니다.
+
+  > 예시: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: 비교할 원본 로케일(기본 문서)입니다.
+
+  > 예시: `npx intlayer doc review --base-locale en`
+
+**파일 처리 옵션:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: 동시에 검토할 파일 수입니다.
+
+  > 예시: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**AI 옵션:**
+
+- **`--model [model]`**: 검토에 사용할 AI 모델 (예: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: 검토에 사용할 AI 제공자.
+- **`--temperature [temperature]`**: AI 모델의 온도 설정.
+- **`--api-key [apiKey]`**: AI 서비스에 사용할 API 키를 제공합니다.
+- **`--application-context [applicationContext]`**: AI 검토에 추가 컨텍스트를 제공합니다.
+- **`--data-serialization [dataSerialization]`**: Intlayer의 AI 기능에 사용할 데이터 직렬화 형식. 옵션: `json` (표준, 신뢰할 수 있음), `toon` (토큰 적음, 일관성 낮음).
+- **`--custom-prompt [prompt]`**: 검토에 사용되는 기본 프롬프트를 사용자 정의합니다. (참고: 대부분의 사용 사례에서는 동작을 더 잘 제어할 수 있는 `--custom-instructions` 옵션을 사용하는 것이 권장됩니다.)
+
+  > 예시: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**환경 변수 옵션:**
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file [envFile]`**: 변수를 로드할 사용자 정의 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
+- **`--no-cache`**: 캐시를 비활성화합니다.
+
+  > 예시: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위한 상세 로그 활성화. (CLI에서 기본값은 true)
+
+  > 예시: `npx intlayer doc review --verbose`
+
+**사용자 지정 지침 옵션:**
+
+- **`--custom-instructions [customInstructions]`**: 프롬프트에 추가되는 사용자 지정 지침. 포맷팅, URL 번역 등 특정 규칙을 적용할 때 유용합니다.
+
+  > 예시: `npx intlayer doc review --custom-instructions "URL 번역을 피하고, 마크다운 형식을 유지하세요"`
+
+  > 예시: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Git 옵션:**
+
+- **`--git-diff`**: 기준(기본값 `origin/main`)에서 현재 브랜치(기본값 `HEAD`)로 변경된 파일만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+- **`--uncommitted`**: 커밋되지 않은 변경사항을 포함합니다.
+- **`--unpushed`**: 푸시되지 않은 변경사항을 포함합니다.
+- **`--untracked`**: 추적되지 않은 파일을 포함합니다.
+
+  > 예시: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 예시: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> 출력 파일 경로는 다음 패턴을 대체하여 결정됩니다:
+>
+> - `/{{baseLocale}}/` 는 `/{{locale}}/` 로 대체 (Unix)
+> - `\{{baseLocale}}\` 는 `\{{locale}}\` 로 대체 (Windows)
+> - `_{{baseLocale}}.` 는 `_{{locale}}.` 로 대체
+> - `{{baseLocale}}_` 는 `{{locale}}_` 로 대체
+> - `.{{baseLocaleName}}.` 는 `.{{localeName}}.` 로 대체
+>
+> 만약 패턴이 발견되지 않으면, 출력 파일은 파일 확장자에 `.{{locale}}` 를 추가합니다. 예를 들어 `./my/file.md` 는 검토되고, 프랑스어 로케일의 경우 `./my/file.fr.md` 로 업데이트됩니다.

package/docs/ko/cli/doc-translate.md

@@ -15,6 +15,7 @@ slugs:
   - concept
   - cli
   - doc-translate
+author: aymericzip
 ---
 
 # 문서 번역

package/docs/ko/cli/editor.md

@@ -13,6 +13,7 @@ slugs:
   - concept
   - cli
   - editor
+author: aymericzip
 ---
 
 # 에디터 명령어

package/docs/ko/cli/extract.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - extract
+author: aymericzip
 ---
 
 # 문자열 추출

package/docs/ko/cli/fill.md

@@ -16,6 +16,7 @@ slugs:
   - concept
   - cli
   - fill
+author: aymericzip
 ---
 
 # 사전 채우기 / 감사 / 번역
@@ -46,6 +47,14 @@ bun x intlayer fill
 - 기존 번역을 덮어쓰지 않아 기존 번역을 보존합니다.
 - 큐 시스템을 사용하여 파일, 청크 및 로케일을 병렬로 처리하여 속도를 높입니다.
 
+## 주요 포인트:
+
+- 대규모 JSON 파일을 청크로 분할하여 AI 모델의 컨텍스트 윈도우 제한 내에 유지합니다.
+- 출력 형식이 올바르지 않으면 번역을 다시 시도합니다.
+- 번역 정확도 향상을 위해 애플리케이션 및 파일별 컨텍스트를 통합합니다.
+- 기존 번역을 덮어쓰지 않음으로써 보존합니다.
+- 큐 시스템을 사용하여 파일, 청크 및 로케일을 병렬로 처리하여 속도를 높입니다.
+
 ## 별칭:
 
 - `npx intlayer dictionaries fill`

package/docs/ko/cli/index.md

@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.0.0
+    date: 2026-06-11
+    changes: "scan 명령어 추가"
   - version: 8.6.4
     date: 2026-03-31
     changes: "standalone 명령어 추가"
@@ -62,6 +65,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "기록 초기화"
+author: aymericzip
 ---
 
 # Intlayer CLI - 다국어 웹사이트를 위한 모든 Intlayer CLI 명령어
@@ -162,6 +166,10 @@ Intlayer는 여러 설정 파일 형식을 허용합니다:
 
 - **[CI 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/ci.md)** - CI/CD 파이프라인을 위해 자동으로 주입된 자격 증명으로 Intlayer 명령어를 실행합니다.
 
+### 감사 및 진단
+
+- **[웹사이트 스캔](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/scan.md)** - 공개 URL의 페이지 크기를 측정하고 i18n/SEO 상태를 감사하게 해줍니다.
+
 ### 개발 도구
 
 - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/sdk.md)** - 자체 코드에서 Intlayer CLI SDK를 사용합니다.
@@ -184,7 +192,8 @@ Intlayer는 여러 설정 파일 형식을 허용합니다:
   "intlayer:extract": "npx intlayer extract",
   "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
-  "intlayer:doc:review": "npx intlayer doc review"
+  "intlayer:doc:review": "npx intlayer doc review",
+  "intlayer:scan": "npx intlayer scan https://example.com"
 }
 ```
 

package/docs/ko/cli/init.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.9
     date: 2025-12-30
     changes: "init 명령어 추가"
+author: aymericzip
 ---
 
 # Intlayer 초기화

package/docs/ko/cli/list.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.11
     date: 2026-01-06
     changes: "list 명령에 JSON 출력 옵션 추가"
+author: aymericzip
 ---
 
 # 콘텐츠 선언 파일 목록

package/docs/ko/cli/list_projects.md

@@ -18,6 +18,7 @@ history:
   - version: 7.5.12
     date: 2026-01-06
     changes: "list projects 명령에 절대 경로 출력 옵션 추가"
+author: aymericzip
 ---
 
 # Intlayer 프로젝트 목록

package/docs/ko/cli/live.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - live
+author: aymericzip
 ---
 
 # 라이브 싱크 명령어