@intlayer/docs 8.1.6 → 8.1.8

package/docs/ko/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2026-02-25
 title: Intlayer 컴파일러 | i18n을 위한 자동화된 콘텐츠 추출
 description: Intlayer 컴파일러로 국제화 프로세스를 자동화하세요. Vite, Next.js 등에서 더 빠르고 효율적인 i18n을 위해 컴포넌트에서 직접 콘텐츠를 추출합니다.
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: 컴파일러 옵션 업데이트
   - version: 7.3.1
     date: 2025-11-27
     changes: 컴파일러 출시
@@ -53,6 +56,9 @@ history:
 
 ## 사용법
 
+<Tabs>
+ <Tab value='vite'>
+
 ### Vite
 
 Vite 기반 애플리케이션(React, Vue, Svelte 등)의 경우, 컴파일러를 사용하는 가장 쉬운 방법은 `vite-intlayer` 플러그인을 사용하는 것입니다.
@@ -79,6 +85,8 @@ export default defineConfig({
 });
 ```
 
+See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+
 #### 프레임워크 지원
 
 Vite 플러그인은 다양한 파일 유형을 자동으로 감지하고 처리합니다:
@@ -97,6 +105,9 @@ npm install @intlayer/vue-compiler
 npm install @intlayer/svelte-compiler
 ```
 
+ </Tab>
+ <Tab value='nextjs'>
+
 ### Next.js (Babel)
 
 Next.js 또는 Babel을 사용하는 다른 Webpack 기반 애플리케이션의 경우, `@intlayer/babel` 플러그인을 사용하여 컴파일러를 구성할 수 있습니다.
@@ -131,3 +142,70 @@ module.exports = {
 ```
 
 이 구성은 컴포넌트 내에 선언된 콘텐츠가 자동으로 추출되어 빌드 과정 중에 사전 생성에 사용되도록 보장합니다.
+
+See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
+
+ </Tab>
+
+### 사용자 정의 구성
+
+컴파일러 동작을 사용자 정의하려면 프로젝트 루트에 있는 `intlayer.config.ts` 파일을 업데이트할 수 있습니다.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    /**
+     * 컴파일러를 활성화할지 여부를 나타냅니다.
+     * 개발 중에 컴파일러를 건너뛰고 시작 시간을 단축하려면 'build-only'로 설정하세요.
+     */
+    enabled: true,
+
+    /**
+     * 최적화할 코드를 순회하는 패턴.
+     */
+    transformPattern: [
+      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
+      "!**/node_modules/**",
+    ],
+
+    /**
+     * 최적화에서 제외할 패턴.
+     */
+    excludePattern: ["**/node_modules/**"],
+
+    /**
+     * 최적화된 사전의 출력 디렉토리.
+     */
+    outputDir: "i18n",
+
+    /**
+     * 사전 키 접두사
+     */
+    dictionaryKeyPrefix: "", // 기본 접두사 제거
+
+    /**
+     * 컴포넌트가 변환된 후 저장되어야 하는지 여부를 나타냅니다.
+     * 그렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 나중에 제거할 수 있습니다.
+     */
+    saveComponents: false,
+  },
+};
+
+export default config;
+```
+
+### 누락된 번역 채우기
+
+Intlayer는 누락된 번역을 채우는 데 도움이 되는 CLI 도구를 제공합니다. `intlayer` 명령을 사용하여 코드에서 누락된 번역을 테스트하고 채울 수 있습니다.
+
+```bash
+npx intlayer test         # 누락된 번역이 있는지 테스트
+```
+
+```bash
+npx intlayer fill         # 누락된 번역 채우기
+```
+
+> 자세한 내용은 [CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/ci.md)를 참조하세요.

package/docs/ko/component_i18n.md

@@ -78,7 +78,7 @@ export default componentContent;
 
 ## 2) 콘텐츠를 가져오기
 
-### 경우 A — React 앱 (Vite/SPA)
+### 경우 A. React 앱 (Vite/SPA)
 
 기본 접근법: 키로 검색하기 위해 `useIntlayer`를 사용합니다. 이렇게 하면 컴포넌트가 간결하고 타입이 지정됩니다.
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### 사례 B — Next.js (앱 라우터)
+### 사례 B. Next.js (앱 라우터)
 
 데이터 안전성과 성능을 위해 서버 컴포넌트를 선호하세요. 서버 파일에서는 `next-intlayer/server`에서 `useIntlayer`를 사용하고, 클라이언트 컴포넌트에서는 `next-intlayer`에서 `useIntlayer`를 사용하세요.
 

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: 구성
 description: 애플리케이션에 맞게 Intlayer를 구성하는 방법을 배우세요. Intlayer를 사용자 요구에 맞게 맞춤 설정할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: 컴파일러 옵션 업데이트
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -440,6 +443,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -973,6 +987,13 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _참고_: 라이브 모드는 라이브 동기화 API를 사용하여 사전을 가져옵니다. API 호출이 실패하면 사전은 "dynamic" 모드로 동적으로 가져와집니다.
   - _참고_: 이 옵션은 `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` 및 `useDictionaryDynamic` 함수에는 영향을 미치지 않습니다.
 
+- **outputFormat**:
+  - _타입_: `'esm' | 'cjs'`
+  - _기본값_: `'esm'`
+  - _설명_: 사전의 출력 형식을 제어합니다.
+  - _예시_: `'cjs'`
+  - _참고_: 사전의 출력 형식입니다.
+
 - **traversePattern**:
   - _유형_: `string[]`
   - _기본값_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -981,3 +1002,49 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _참고_: 최적화를 관련 코드 파일로 제한하여 빌드 성능을 향상시키는 데 사용합니다.
   - _참고_: `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.
   - _참고_: glob 패턴을 사용하세요.
+
+---
+
+### 컴파일러 설정
+
+구성 요소에서 직접 사전을 추출하는 Intlayer 컴파일러를 제어하는 설정입니다.
+
+#### 속성
+
+- **enabled**:
+  - _타입_: `boolean | 'build-only'`
+  - _기본값_: `true`
+  - _설명_: 사전을 추출하기 위해 컴파일러를 활성화해야 하는지 여부를 나타냅니다.
+  - _예시_: `'build-only'`
+  - _참고_: `'build-only'`로 설정하면 개발 모드 동안 컴파일러를 건너뛰어 시작 시간을 단축합니다. 빌드 명령 시에만 실행됩니다.
+
+- **dictionaryKeyPrefix**:
+  - _타입_: `string`
+  - _기본값_: `'comp-'`
+  - _설명_: 추출된 사전 키의 접두사입니다.
+  - _예시_: `'my-key-'`
+  - _참고_: 사전을 추출할 때 파일 이름을 기반으로 키가 생성됩니다. 충돌을 방지하기 위해 생성된 키에 이 접두사가 추가됩니다.
+
+- **saveComponents**:
+  - _타입_: `boolean`
+  - _기본값_: `false`
+  - _설명_: 변환 후 구성 요소를 저장해야 하는지 여부를 나타냅니다.
+  - _참고_: true인 경우 컴파일러는 원본 파일을 변환된 파일로 대체합니다. 그렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 제거할 수 있습니다.
+
+- **transformPattern**:
+  - _타입_: `string | string[]`
+  - _기본값_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _설명_: 최적화 중에 탐색할 파일을 정의하는 패턴입니다.
+  - _예시_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _참고_: 최적화를 관련 코드 파일로 제한하여 빌드 성능을 향상시키는 데 사용합니다.
+
+- **excludePattern**:
+  - _타입_: `string | string[]`
+  - _기본값_: `['**/node_modules/**']`
+  - _설명_: 최적화 중에 제외할 파일을 정의하는 패턴입니다.
+  - _예시_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _타입_: `string`
+  - _기본값_: `'compiler'`
+  - _설명_: 추출된 사전이 저장될 디렉토리로, 프로젝트 베이스 경로에 대한 상대 경로입니다.

package/docs/ko/dictionary/content_file.md

@@ -512,7 +512,7 @@ export default aboutPageMetaContent;
 
 - `'local'`: 사전이 로컬에서만 관리됩니다. 원격 CMS로 푸시되지 않습니다. 코드베이스에 남아 있어야 하는 콘텐츠에 사용합니다.
 - `'remote'`: 사전이 원격에서만 관리됩니다. CMS로 푸시되면 로컬 파일에서 분리됩니다. 콘텐츠 로드 시 원격 사전이 CMS에서 가져옵니다. `remote` 위치를 가진 `.content` 파일은 초기 푸시 후 무시됩니다.
-- `'hybrid'`: 사전이 로컬과 원격 모두에서 관리됩니다. CMS로 푸시되면 동기화 상태를 유지합니다—로컬 파일의 변경사항이 CMS로 푸시되고, 원격 변경사항은 로컬 파일로 다시 가져올 수 있습니다.
+- `'hybrid'`: 사전이 로컬과 원격 모두에서 관리됩니다. CMS로 푸시되면 동기화 상태를 유지합니다, 로컬 파일의 변경사항이 CMS로 푸시되고, 원격 변경사항은 로컬 파일로 다시 가져올 수 있습니다.
 - `string` (예: `'plugin'`): 사전이 플러그인 또는 사용자 정의 소스에 의해 관리됩니다. 푸시하려고 하면 시스템이 수행할 작업을 묻습니다.
 
 **예시:**

package/docs/ko/index.md

@@ -65,7 +65,7 @@ Intlayer는 애플리케이션 번역을 위한 유연하고 현대적인 접근
 - **[열거형(Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/enumeration.md)**  
   여러 언어에 걸쳐 반복되거나 고정된 데이터 집합을 쉽게 관리하세요.
 
-- **[조건(Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/conditional.md)**  
+- **[조건(Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/condition.md)**  
   Intlayer에서 조건 논리를 사용하여 동적 콘텐츠를 만드는 방법을 배우세요.
 
 - **[삽입(Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/insertion.md)**  
@@ -77,7 +77,7 @@ Intlayer는 애플리케이션 번역을 위한 유연하고 현대적인 접근
 - **[마크다운](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md)**  
   Intlayer에서 마크다운을 사용하여 풍부한 콘텐츠를 만드는 방법을 배우세요.
 
-- **[파일 임베딩](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file_embeddings.md)**  
+- **[파일 임베딩](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file.md)**  
   Intlayer에서 외부 파일을 임베딩하여 콘텐츠 편집기에서 사용하는 방법을 알아보세요.
 
 - **[중첩](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/nesting.md)**  

package/docs/ko/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - AdonisJS 앱 번역 방법 – 가이드 2026
+title: AdonisJS i18n - AdonisJS 앱 번역 방법 2026
 description: AdonisJS 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위해 문서를 따르십시오.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - Analog 앱 번역 방법 – 2026 가이드
+title: Analog i18n - Analog 앱 번역 방법 2026
 description: Analog 앱을 다국어로 만드는 방법을 알아보세요. 가이드를 따라 국제화(i18n) 및 번역을 적용하세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - Angular 앱을 번역하는 방법 – 2026년 가이드
+title: Angular i18n - Angular 앱을 번역하는 방법 2026
 description: Angular 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위해 문서를 따르세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Astro 앱 번역 방법 – 가이드 2026
+title: Astro i18n - Astro 앱 번역 방법 2026
 description: Intlayer를 사용하여 Astro 웹사이트에 국제화(i18n)를 추가하는 방법을 배우세요. 이 가이드를 따라 사이트를 다국어로 만드세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Create React App i18n - React 앱 번역 방법 – 가이드 2026
+title: Create React App i18n - React 앱 번역 방법 2026
 description: Create React App (CRA) 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Express i18n - Express 앱 번역 방법 – 가이드 2026
+title: Express i18n - Express 앱 번역 방법 2026
 description: Express 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Fastify 앱 번역 방법 – 가이드 2026
+title: Fastify i18n - Fastify 앱 번역 방법 2026
 description: Fastify 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역 절차를 따르세요.
 keywords:
   - 국제화 (i18n)

package/docs/ko/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Hono i18n - Hono 앱 번역 방법 – 2026 가이드
+title: Hono i18n - Hono 앱 번역 방법 2026
 description: Hono 백엔드를 다국어로 만드는 방법을 알아보세요. 문서를 따라 국제화(i18n)하고 번역하세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx 및 React i18n - Lynx 앱 번역 방법 – 가이드 2026
+title: Lynx + React i18n - Lynx 앱 번역 방법 2026
 description: Lynx와 React를 사용하여 Page Router 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - NestJS 앱 번역 방법 – 가이드 2026
+title: NestJS i18n - NestJS 앱 번역 방법 2026
 description: NestJS 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js 및 next-i18next i18n - Next.js 앱 번역 방법 – 가이드 2026
+title: next-i18next - 2026년에 Next.js (i18n) 앱을 번역하는 방법
 description: i18next/next-i18next로 Next.js 15 App Router 앱을 국제화하고 Intlayer로 향상시키는 실용적이고 프로덕션 준비된 가이드입니다.
 keywords:
   - 국제화
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - 번역 워크플로우 자동화를 위한 Intlayer 통합 (테스트, AI 채우기, JSON 동기화)
 
 > 참고: next-i18next는 i18next 위에 구축되었습니다. 이 가이드는 App Router에서 next-i18next와 호환되는 i18next 기본 기능을 사용하며, 아키텍처를 간단하고 프로덕션 준비 상태로 유지합니다.
-> 더 넓은 비교는 [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ko/next-i18next_vs_next-i18next_vs_intlayer.md)를 참조하세요.
+> 더 넓은 비교는 [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ko/next-i18next_vs_next-intl_vs_intlayer.md)를 참조하세요.
 
 ---
 

package/docs/ko/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js 및 next-intl i18n - Next.js 앱 번역 방법 – 가이드 2026
+title: next-intl - 2026년에 Next.js (i18n) 앱을 번역하는 방법
 description: Next.js 15 App Router 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Next.js 14 앱 번역 방법 – 가이드 2026
+title: Next.js i18n - Next.js 14 앱 번역 방법 2026
 description: Next.js 14 App Router 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Next.js 15 앱 번역 방법 – 가이드 2026
+title: Next.js i18n - Next.js 15 앱 번역 방법 2026
 description: Next.js 15 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화

package/docs/ko/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Next.js 16 앱 번역 방법 – 가이드 2026
+title: Next.js i18n - Next.js 16 앱 번역 방법 2026
 description: Next.js 16 웹사이트를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화