@intlayer/docs 9.4.3 → 9.5.0

package/docs/ko/migration_from_i18next_to_intlayer.md

@@ -32,7 +32,6 @@ author: aymericzip
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
 
 </Accordion>
-
 <Accordion header="유지보수성">
 
 애플리케이션 콘텐츠의 스코프를 나누면 대규모 애플리케이션의 **유지보수가 쉬워집니다**. 전체 콘텐츠 코드베이스를 검토할 필요 없이 기능 디렉토리를 복제하거나 삭제할 수 있습니다. 게다가 Intlayer는 콘텐츠의 정확성을 보장하기 위해 **강력한 타입이 적용**되어 있습니다.
@@ -40,25 +39,21 @@ author: aymericzip
 Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션이기도 합니다. 문제가 신속히 해결되고 새로운 프레임워크 어댑터가 주기적으로 추가되며, 실제 운영 환경의 피드백을 기반으로 핵심 API가 지속적으로 개선됩니다.
 
 </Accordion>
-
 <Accordion header="AI 에이전트">
 
 콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(LLM)에 필요한 **컨텍스트가 줄어듭니다**. Intlayer에는 누락된 번역을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
 
 </Accordion>
-
 <Accordion header="자동화">
 
 AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이프라인에서 번역을 자동화하세요. Intlayer는 콘텐츠 추출을 자동화하기 위한 **컴파일러**와 **백그라운드 번역**을 지원하는 [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
 
 </Accordion>
-
 <Accordion header="성능">
 
 거대한 JSON 파일을 컴포넌트에 연결하면 성능 및 반응성 문제가 발생할 수 있습니다. Intlayer는 빌드 시간에 콘텐츠를 불러오도록 최적화합니다.
 
 </Accordion>
-
 <Accordion header="비개발자와의 스케일업">
 
 Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **[시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 다국어 콘텐츠를 **실시간**으로 관리할 수 있는 **[풀 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
@@ -66,8 +61,6 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 마이그레이션 전략
 
 `i18next`에서 Intlayer로 마이그레이션하기 위한 두 가지 보완적 전략이 있습니다:
@@ -78,20 +71,15 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 
 이 가이드에서는 먼저 **전략 1** (쉽게 도입할 수 있는 호환성 어댑터)에 대해 설명하고, 선택 사항인 전체 마이그레이션에 대해 알아봅니다.
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 빠른 마이그레이션
 
 다음 단계는 코드베이스를 변경하지 않고 기존 `i18next` 앱을 Intlayer에서 실행하기 위해 필요한 최소한의 작업입니다.
 
 <Steps>
-
 <Step number={1} title="의존성 설치">
 
 Intlayer 핵심 패키지와 호환성 어댑터를 설치합니다:
@@ -135,7 +123,6 @@ bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
 > `i18next`를 계속 설치해 둘 수 있습니다 — 호환성 어댑터는 TypeScript 타입을 위해 이를 `devDependency` / `peerDependency`로 사용합니다.
 
 </Step>
-
 <Step number={2} title="Intlayer 설정">
 
 `intlayer init` 명령어는 초기 `intlayer.config.ts` 파일을 만듭니다. 기존 로케일(언어)과 일치하도록 업데이트하고 `syncJSON` 플러그인이 메시지 파일을 가리키도록 설정하세요:
@@ -170,7 +157,6 @@ export default config;
 > **`source`**는 로케일을 해당 JSON 파일 경로로 매핑합니다. **`location`**은 Intlayer 관찰자(Watcher)에게 변경 사항을 모니터링할 폴더를 알려줍니다. `format: 'i18next'` 옵션은 `{{name}}`과 같은 플레이스홀더가 올바르게 분석되도록 보장합니다.
 
 </Step>
-
 <Step number={3} title="번들러 별칭 업데이트 (선택 사항)">
 
 번들러(Vite, Webpack, esbuild)를 사용하는 경우 모듈 별칭을 삽입하여 `import ... from 'i18next'`가 자동으로 `@intlayer/i18next`로 확인되게 할 수 있습니다. 이를 통해 코드베이스 전체에서 가져오기 경로를 수동으로 변경하지 않아도 됩니다.
@@ -194,14 +180,11 @@ export default defineConfig({
 
 이것으로 빠른 마이그레이션이 완료되었습니다. 이제 앱은 모든 가져오기와 `i18next` API를 그대로 유지한 채 Intlayer에서 작동합니다.
 
----
-
 ## 전체 마이그레이션
 
 아래 단계는 선택 사항이며 점진적으로 수행할 수 있습니다. 이는 시각적 에디터, CMS, 타입이 있는 콘텐츠 파일, AI 지원 번역 자동화 등 Intlayer의 전체 기능을 열어줍니다.
 
 <Steps>
-
 <Step number={4} title="명시적으로 가져오기 이름 변경 (선택 사항)" isOptional={true}>
 
 소스 파일에서 명시적으로 의존성을 나타내고 싶거나, 가져오기를 별칭 지정하는 번들러 플러그인을 사용하지 않는다면 수동으로 가져오기 경로를 변경할 수 있습니다:
@@ -215,7 +198,6 @@ export default defineConfig({
 이는 **드롭인 교체(Drop-in replacements)**이므로 함수 호출 시그니처, 매개변수, 반환 타입을 변경할 필요가 없습니다.
 
 </Step>
-
 <Step number={5} title="AI 기반 번역 자동화 활성화" isOptional={true}>
 
 Intlayer 설정이 완료되면, CLI를 사용하여 누락된 번역을 자동으로 채울 수 있습니다:
@@ -277,8 +259,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 마이그레이션 후 삭제할 수 있는 항목
 
 호환성 어댑터가 제자리에 배치되면 기존에 사용하던 표준 `i18next` 상용구를 삭제할 수 있습니다:
@@ -291,8 +271,6 @@ export default config;
 
 한 단계 더 나아갈 준비가 되면 Intlayer는 **코드베이스 내의 모든 `.content.ts` 및 `.content.json` 파일을 자동으로 감지합니다**(기본적으로 `./src` 내의 어느 곳에서든). 로직 파일 바로 옆에 `my-component.content.ts` 파일을 추가하기만 하면 Intlayer는 별도 설정 없이 컴파일 타임에 이를 감지합니다 — 가져오기, 등록, 중앙 인덱스 파일이 필요 없습니다. 번역의 위치 통일이 매우 매끄러워집니다.
 
----
-
 ## TypeScript 설정
 
 Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)를 제공하기 위해 모듈 확장을 사용합니다. `tsconfig.json` 파일에 자동으로 생성된 타입이 포함되어 있는지 확인하세요:
@@ -307,8 +285,6 @@ Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)
 }
 ```
 
----
-
 ## Git 설정
 
 Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
@@ -318,8 +294,6 @@ Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
 .intlayer
 ```
 
----
-
 ## 더 알아보기
 
 - **시각적 에디터** — 브라우저에서 시각적으로 번역을 관리하세요: [Intlayer 시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)

package/docs/ko/migration_from_next-i18next_to_intlayer.md

@@ -35,7 +35,6 @@ author: aymericzip
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
 
 </Accordion>
-
 <Accordion header="유지보수성">
 
 애플리케이션 콘텐츠의 스코프를 나누면 대규모 애플리케이션의 **유지보수가 쉬워집니다**. 전체 콘텐츠 코드베이스를 검토할 필요 없이 기능 디렉토리를 복제하거나 삭제할 수 있습니다. 게다가 Intlayer는 콘텐츠의 정확성을 보장하기 위해 **강력한 타입이 적용**되어 있습니다.
@@ -43,25 +42,21 @@ author: aymericzip
 Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션이기도 합니다. 문제가 신속히 해결되고 새로운 프레임워크 어댑터가 주기적으로 추가되며, 실제 운영 환경의 피드백을 기반으로 핵심 API가 지속적으로 개선됩니다.
 
 </Accordion>
-
 <Accordion header="AI 에이전트">
 
 콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(LLM)에 필요한 **컨텍스트가 줄어듭니다**. Intlayer에는 누락된 번역을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
 
 </Accordion>
-
 <Accordion header="자동화">
 
 AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이프라인에서 번역을 자동화하세요. Intlayer는 콘텐츠 추출을 자동화하기 위한 **컴파일러**와 **백그라운드 번역**을 지원하는 [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
 
 </Accordion>
-
 <Accordion header="성능">
 
 거대한 JSON 파일을 컴포넌트에 연결하면 성능 및 반응성 문제가 발생할 수 있습니다. Intlayer는 빌드 시간에 콘텐츠를 불러오도록 최적화합니다.
 
 </Accordion>
-
 <Accordion header="비개발자와의 스케일업">
 
 Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **[시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 다국어 콘텐츠를 **실시간**으로 관리할 수 있는 **[풀 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
@@ -69,8 +64,6 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 마이그레이션 전략
 
 `next-i18next`는 내부적으로 `react-i18next`와 `i18next`를 포장(wrapping)하므로, Intlayer로 마이그레이션하기 위한 두 가지 보완적 전략이 있습니다:
@@ -81,20 +74,15 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 
 이 가이드에서는 먼저 **전략 1** (쉽게 도입할 수 있는 호환성 어댑터)에 대해 설명하고, 선택 사항인 전체 마이그레이션에 대해 알아봅니다.
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 빠른 마이그레이션
 
 다음 단계는 페이지와 컴포넌트 코드를 변경하지 않고 기존 Next.js Pages Router 앱을 Intlayer에서 실행하기 위해 필요한 최소한의 작업입니다.
 
 <Steps>
-
 <Step number={1} title="의존성 설치">
 
 Intlayer 핵심 패키지와 호환성 어댑터를 설치합니다:
@@ -138,7 +126,6 @@ bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/r
 > 마이그레이션 도중 별칭 설정이 완료될 때까지 `next-i18next`, `react-i18next`, `i18next`를 계속 설치해 둘 수 있습니다.
 
 </Step>
-
 <Step number={2} title="Intlayer 설정">
 
 `intlayer init` 명령어는 초기 `intlayer.config.ts` 파일을 만듭니다. 기존 로케일(언어)과 일치하도록 업데이트하고 `syncJSON` 플러그인이 `next-i18next` 메시지 파일(일반적으로 `public/locales`)을 가리키도록 설정하세요:
@@ -173,7 +160,6 @@ export default config;
 > **`source`**는 로케일과 네임스페이스(`key`)를 해당 JSON 파일 경로로 매핑합니다. **`location`**은 Intlayer 관찰자(Watcher)에게 변경 사항을 모니터링할 폴더를 알려줍니다. `format: 'i18next'` 옵션은 `next-i18next`의 플레이스홀더가 올바르게 분석되도록 보장합니다.
 
 </Step>
-
 <Step number={3} title="Next.js 설정 업데이트">
 
 기존 `next.config.ts` (또는 `.js`) 파일을 `@intlayer/next-i18next/plugin`의 `createNextI18nPlugin`으로 래핑하세요. 이 래퍼는 `withIntlayer`를 결합**하면서** 동시에 `next-i18next` / `react-i18next` / `i18next` → `@intlayer/*` 별칭을 주입합니다. 이를 통해 기존의 `import { useTranslation } from 'next-i18next'`와 같은 호출이 빌드 시 자동으로 리디렉션됩니다. 소스 코드를 변경할 필요가 없습니다.
@@ -217,14 +203,11 @@ export default withIntlayer(nextConfig);
 > tAbout("counter.label"); // ✓ 타입 적용됨
 > ```
 
----
-
 ## 전체 마이그레이션
 
 아래 단계는 선택 사항이며 점진적으로 수행할 수 있습니다. 이는 시각적 에디터, CMS, 타입이 있는 콘텐츠 파일, AI 지원 번역 자동화 등 Intlayer의 전체 기능을 열어줍니다.
 
 <Steps>
-
 <Step number={4} title="명시적으로 가져오기 이름 변경 (선택 사항)" isOptional={true}>
 
 Intlayer 플러그인은 이미 번들러 수준에서 별칭 지정을 처리합니다. 소스 파일에서 명시적으로 의존성을 나타내고 싶다면 수동으로 가져오기 경로를 변경할 수 있습니다:
@@ -239,7 +222,6 @@ Intlayer 플러그인은 이미 번들러 수준에서 별칭 지정을 처리
 이는 **드롭인 교체(Drop-in replacements)**이므로 함수 호출 시그니처, 매개변수, 반환 타입을 변경할 필요가 없습니다.
 
 </Step>
-
 <Step number={5} title="AI 기반 번역 자동화 활성화" isOptional={true}>
 
 Intlayer 설정이 완료되면, CLI를 사용하여 누락된 번역을 자동으로 채울 수 있습니다:
@@ -301,8 +283,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 마이그레이션 후 삭제할 수 있는 항목
 
 호환성 어댑터가 제자리에 배치되면 기존에 사용하던 표준 `next-i18next` 상용구를 삭제할 수 있습니다:
@@ -315,8 +295,6 @@ export default config;
 
 한 단계 더 나아갈 준비가 되면 Intlayer는 **코드베이스 내의 모든 `.content.ts` 및 `.content.json` 파일을 자동으로 감지합니다**(기본적으로 `./src` 내의 어느 곳에서든). `MyComponent.tsx` 파일 바로 옆에 `my-component.content.ts` 파일을 추가하기만 하면 Intlayer는 별도 설정 없이 컴파일 타임에 이를 감지합니다 — 가져오기, 등록, 중앙 인덱스 파일이 필요 없습니다. 페이지와 컴포넌트에서 번역의 위치 통일이 매우 매끄러워집니다.
 
----
-
 ## TypeScript 설정
 
 Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)를 제공하기 위해 모듈 확장을 사용합니다. `tsconfig.json` 파일에 자동으로 생성된 타입이 포함되어 있는지 확인하세요:
@@ -331,8 +309,6 @@ Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)
 }
 ```
 
----
-
 ## Git 설정
 
 Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
@@ -342,8 +318,6 @@ Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
 .intlayer
 ```
 
----
-
 ## 더 알아보기
 
 - **시각적 에디터** — 브라우저에서 시각적으로 번역을 관리하세요: [Intlayer 시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)

package/docs/ko/migration_from_next-intl_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
 
 </Accordion>
-
 <Accordion header="유지보수성">
 
 애플리케이션 콘텐츠의 스코프를 나누면 대규모 애플리케이션의 **유지보수가 쉬워집니다**. 전체 콘텐츠 코드베이스를 검토할 필요 없이 기능 디렉토리를 복제하거나 삭제할 수 있습니다. 게다가 Intlayer는 콘텐츠의 정확성을 보장하기 위해 **강력한 타입이 적용**되어 있습니다.
@@ -41,25 +40,21 @@ author: aymericzip
 Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션이기도 합니다. 문제가 신속히 해결되고 새로운 프레임워크 어댑터가 주기적으로 추가되며, 실제 운영 환경의 피드백을 기반으로 핵심 API가 지속적으로 개선됩니다.
 
 </Accordion>
-
 <Accordion header="AI 에이전트">
 
 콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(LLM)에 필요한 **컨텍스트가 줄어듭니다**. Intlayer에는 누락된 번역을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
 
 </Accordion>
-
 <Accordion header="자동화">
 
 AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이프라인에서 번역을 자동화하세요. Intlayer는 콘텐츠 추출을 자동화하기 위한 **컴파일러**와 **백그라운드 번역**을 지원하는 [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
 
 </Accordion>
-
 <Accordion header="성능">
 
 거대한 JSON 파일을 컴포넌트에 연결하면 성능 및 반응성 문제가 발생할 수 있습니다. Intlayer는 빌드 시간에 콘텐츠를 불러오도록 최적화합니다.
 
 </Accordion>
-
 <Accordion header="비개발자와의 스케일업">
 
 Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **[시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 다국어 콘텐츠를 **실시간**으로 관리할 수 있는 **[풀 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
@@ -67,8 +62,6 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 마이그레이션 전략
 
 기존 애플리케이션을 위한 추천 접근 방식은 **호환성 어댑터**를 사용하는 것입니다: `@intlayer/next-intl`을 설치하세요. 이 어댑터는 `next-intl`과 **정확히 동일한 API**를 제공하면서 모든 번역 작업을 백그라운드에서 Intlayer에 위임합니다.
@@ -77,20 +70,15 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 
 시간이 지남에 따라 점진적으로 개별 파일을 더욱 강력한 Intlayer의 `.content.ts` 형식으로 옮기면, 시각적 에디터, CMS 및 컴포넌트 레벨의 콘텐츠 스코프를 활용할 수 있습니다 — 하지만 이는 전적으로 선택 사항이며 점진적으로 도입할 수 있습니다.
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 빠른 마이그레이션
 
 다음 단계는 코드를 변경하지 않고 기존 `next-intl` 앱을 Intlayer에서 실행하기 위해 필요한 최소한의 작업입니다.
 
 <Steps>
-
 <Step number={1} title="의존성 설치">
 
 Intlayer 핵심 패키지와 `@intlayer/next-intl` 호환성 어댑터를 설치합니다:
@@ -134,7 +122,6 @@ bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
 > `next-intl`은 계속 설치해 두세요 — **URL 라우팅**(`createNavigation`, `createMiddleware`, `Link`, `redirect`, `usePathname`, `useRouter`)을 위해 계속 필요합니다. 호환성 어댑터는 라우팅 레이어를 교체**하지 않습니다**.
 
 </Step>
-
 <Step number={2} title="Intlayer 설정">
 
 `intlayer init` 명령어는 초기 `intlayer.config.ts` 파일을 만듭니다. 기존 로케일(언어)과 일치하도록 업데이트하고 `syncJSON` 플러그인이 메시지 파일을 가리키도록 설정하세요:
@@ -171,7 +158,6 @@ export default config;
 > 가능한 모든 구성 옵션은 [설정 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
 
 </Step>
-
 <Step number={3} title="Next.js에 Intlayer 플러그인 통합">
 
 기존 Next.js 설정을 `@intlayer/next-intl/plugin`의 `createNextIntlPlugin`으로 래핑하세요. 이 래퍼는 `withIntlayer`를 결합**하면서** 동시에 `next-intl` → `@intlayer/next-intl` 별칭을 등록합니다:
@@ -212,14 +198,11 @@ export default withIntlayer(nextConfig);
 > t("counter.label"); // ✓ 타입 적용됨
 > ```
 
----
-
 ## 전체 마이그레이션
 
 아래 단계는 선택 사항이며 점진적으로 수행할 수 있습니다. 이는 시각적 에디터, CMS, 타입이 있는 콘텐츠 파일, AI 지원 번역 자동화 등 Intlayer의 전체 기능을 열어줍니다.
 
 <Steps>
-
 <Step number={4} title="명시적으로 가져오기 이름 변경 (선택 사항)" isOptional={true}>
 
 `createNextIntlPlugin()` 래퍼는 이미 번들러 수준에서 `next-intl` → `@intlayer/next-intl` 별칭 처리를 관리합니다. 소스 파일에서 의존성을 명확히 하고 싶거나, 단순한 `withIntlayer` 플러그인을 직접 사용하려는 경우 가져오기 경로를 수동으로 변경할 수 있습니다:
@@ -246,7 +229,6 @@ export default withIntlayer(nextConfig);
 > 혹은 `@intlayer/next-intl/routing`의 `defineRouting`을 사용하면 `intlayer.config.ts` 파일의 로케일 설정을 자동으로 병합할 수 있습니다.
 
 </Step>
-
 <Step number={5} title="AI 기반 번역 자동화 활성화" isOptional={true}>
 
 Intlayer 설정이 완료되면, CLI를 사용하여 원하는 LLM을 이용해 누락된 번역을 자동으로 채울 수 있습니다:
@@ -308,8 +290,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 마이그레이션 후 삭제할 수 있는 항목
 
 `@intlayer/next-intl`이 적용되면, 다음의 기존 `next-intl` 표준 상용구를 삭제할 수 있습니다:
@@ -322,8 +302,6 @@ export default config;
 
 한 단계 더 나아갈 준비가 되면 Intlayer는 **코드베이스 내의 모든 `.content.ts` 및 `.content.json` 파일을 자동으로 감지합니다**(기본적으로 `./src` 내의 어느 곳에서든). `about/page.tsx` 파일 바로 옆에 `about.content.ts` 파일을 추가하기만 하면 Intlayer는 별도 설정 없이 컴파일 타임에 이를 감지합니다 — 가져오기, 등록, 중앙 인덱스 파일이 필요 없습니다. 페이지와 컴포넌트에서 번역의 위치 통일이 매우 매끄러워집니다.
 
----
-
 ## TypeScript 설정
 
 Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)를 제공하기 위해 모듈 확장을 사용합니다. `tsconfig.json` 파일에 자동으로 생성된 타입이 포함되어 있는지 확인하세요:
@@ -338,8 +316,6 @@ Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)
 }
 ```
 
----
-
 ## Git 설정
 
 Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
@@ -349,8 +325,6 @@ Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
 .intlayer
 ```
 
----
-
 ## 더 알아보기
 
 - **시각적 에디터** — 브라우저에서 시각적으로 번역을 관리하세요: [Intlayer 시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)

package/docs/ko/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
 
 </Accordion>
-
 <Accordion header="유지보수성">
 
 애플리케이션 콘텐츠의 스코프를 나누면 대규모 애플리케이션의 **유지보수가 쉬워집니다**. 전체 콘텐츠 코드베이스를 검토할 필요 없이 기능 디렉토리를 복제하거나 삭제할 수 있습니다. 게다가 Intlayer는 콘텐츠의 정확성을 보장하기 위해 **강력한 타입이 적용**되어 있습니다.
@@ -42,25 +41,21 @@ author: aymericzip
 Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션이기도 합니다. 문제가 신속히 해결되고 새로운 프레임워크 어댑터가 주기적으로 추가되며, 실제 운영 환경의 피드백을 기반으로 핵심 API가 지속적으로 개선됩니다.
 
 </Accordion>
-
 <Accordion header="AI 에이전트">
 
 콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(LLM)에 필요한 **컨텍스트가 줄어듭니다**. Intlayer에는 누락된 번역을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
 
 </Accordion>
-
 <Accordion header="자동화">
 
 AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이프라인에서 번역을 자동화하세요. Intlayer는 콘텐츠 추출을 자동화하기 위한 **컴파일러**와 **백그라운드 번역**을 지원하는 [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
 
 </Accordion>
-
 <Accordion header="성능">
 
 거대한 JSON 파일을 컴포넌트에 연결하면 성능 및 반응성 문제가 발생할 수 있습니다. Intlayer는 빌드 시간에 콘텐츠를 불러오도록 최적화합니다.
 
 </Accordion>
-
 <Accordion header="비개발자와의 스케일업">
 
 Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **[시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 다국어 콘텐츠를 **실시간**으로 관리할 수 있는 **[풀 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
@@ -68,8 +63,6 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 마이그레이션 전략
 
 `@nuxtjs/i18n`은 내부적으로 `vue-i18n`에 의해 작동하므로, Intlayer로 마이그레이션하기 위한 두 가지 보완적 전략이 있습니다:
@@ -80,20 +73,15 @@ Intlayer는 단순한 i18n 솔루션을 넘어, 자체 호스팅이 가능한 **
 
 이 가이드에서는 먼저 **전략 1** (쉽게 도입할 수 있는 호환성 어댑터)에 대해 설명하고, 선택 사항인 전체 마이그레이션에 대해 알아봅니다.
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 빠른 마이그레이션
 
 다음 단계는 컴포넌트 코드를 변경하지 않고 기존 Nuxt 앱을 Intlayer에서 실행하기 위해 필요한 최소한의 작업입니다.
 
 <Steps>
-
 <Step number={1} title="의존성 설치">
 
 Intlayer 핵심 패키지와 호환성 어댑터를 설치합니다:
@@ -137,7 +125,6 @@ bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-js
 > 조만간 Nuxt 설정에서 `@nuxtjs/i18n`을 제거하겠지만 마이그레이션하는 동안 안전하게 설치해 둘 수 있습니다.
 
 </Step>
-
 <Step number={2} title="Intlayer 설정">
 
 `intlayer init` 명령어는 초기 `intlayer.config.ts` 파일을 만듭니다. 기존 로케일(언어)과 일치하도록 업데이트하고 `syncJSON` 플러그인이 메시지 파일을 가리키도록 설정하세요:
@@ -172,7 +159,6 @@ export default config;
 > **`source`**는 로케일을 해당 JSON 파일 경로로 매핑합니다. **`location`**은 Intlayer 관찰자(Watcher)에게 변경 사항을 모니터링할 폴더를 알려줍니다. `format: 'icu'` 옵션은 `vue-i18n` 플레이스홀더가 올바르게 분석되도록 보장합니다.
 
 </Step>
-
 <Step number={3} title="Nuxt 설정 업데이트">
 
 `nuxt.config.ts`에서 `@nuxtjs/i18n` 모듈을 `nuxt-intlayer`로 교체하세요. Intlayer 플러그인이 모듈 별칭을 자동으로 주입하므로, 기존의 `import { useI18n } from 'vue-i18n'` 호출이 부드럽게 `@intlayer/vue-i18n`으로 리디렉션됩니다.
@@ -192,14 +178,11 @@ export default defineNuxtConfig({
 
 이것으로 빠른 마이그레이션이 완료되었습니다. 이제 Nuxt 앱은 모든 `$t` 호출 및 `useI18n()`을 그대로 유지한 채 Intlayer에서 작동합니다.
 
----
-
 ## 전체 마이그레이션
 
 아래 단계는 선택 사항이며 점진적으로 수행할 수 있습니다. 이는 시각적 에디터, CMS, 타입이 있는 콘텐츠 파일, AI 지원 번역 자동화 등 Intlayer의 전체 기능을 열어줍니다.
 
 <Steps>
-
 <Step number={4} title="명시적으로 가져오기 이름 변경 (선택 사항)" isOptional={true}>
 
 Intlayer 플러그인은 이미 번들러 수준에서 별칭 지정을 처리합니다. 소스 파일에서 명시적으로 의존성을 나타내고 싶다면 수동으로 가져오기 경로를 변경할 수 있습니다:
@@ -211,7 +194,6 @@ Intlayer 플러그인은 이미 번들러 수준에서 별칭 지정을 처리
 이는 **드롭인 교체(Drop-in replacements)**이므로 함수 호출 시그니처, 매개변수, 반환 타입을 변경할 필요가 없습니다.
 
 </Step>
-
 <Step number={5} title="AI 기반 번역 자동화 활성화" isOptional={true}>
 
 Intlayer 설정이 완료되면, CLI를 사용하여 누락된 번역을 자동으로 채울 수 있습니다:
@@ -273,8 +255,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 마이그레이션 후 삭제할 수 있는 항목
 
 호환성 어댑터가 제자리에 배치되면 기존에 사용하던 다음 상용구를 삭제할 수 있습니다:
@@ -287,8 +267,6 @@ export default config;
 
 한 단계 더 나아갈 준비가 되면 Intlayer는 **코드베이스 내의 모든 `.content.ts` 및 `.content.json` 파일을 자동으로 감지합니다**(기본적으로 `./src` 내의 어느 곳에서든). `MyComponent.vue` 바로 옆에 `my-component.content.ts` 파일을 추가하기만 하면 Intlayer는 별도 설정 없이 컴파일 타임에 이를 감지합니다 — 가져오기, 등록, 중앙 인덱스 파일이 필요 없습니다. 페이지와 컴포넌트에서 번역의 위치 통일이 매우 매끄러워집니다.
 
----
-
 ## TypeScript 설정
 
 Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)를 제공하기 위해 모듈 확장을 사용합니다. `tsconfig.json` 파일에 자동으로 생성된 타입이 포함되어 있는지 확인하세요:
@@ -303,8 +281,6 @@ Intlayer는 번역 키에 대해 전체 TypeScript IntelliSense(자동 완성)
 }
 ```
 
----
-
 ## Git 설정
 
 Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
@@ -314,8 +290,6 @@ Intlayer가 생성한 디렉토리를 `.gitignore`에 추가하세요:
 .intlayer
 ```
 
----
-
 ## 더 알아보기
 
 - **시각적 에디터** — 브라우저에서 시각적으로 번역을 관리하세요: [Intlayer 시각적 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)