@intlayer/docs 9.4.1 → 9.4.3

package/docs/ko/introduction.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-08-30
 title: 소개
 description: Intlayer의 작동 방식을 알아보세요. Intlayer가 애플리케이션에서 사용하는 단계를 확인하세요. 다양한 패키지가 어떤 역할을 하는지 알아보세요.
 keywords:
@@ -93,7 +93,6 @@ export const MyComponent: FC = () => {
 `next-intl`이나 `i18next`와 같은 주요 솔루션과 비교하여 Intlayer는 다음과 같은 통합된 최적화를 제공하는 솔루션입니다:
 
 <AccordionGroup>
-
 <Accordion header="번들 크기 (Bundle size)">
 
 거대한 JSON 파일을 페이지에 로드하는 대신 필요한 콘텐츠만 로드하세요. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄여줍니다**.
@@ -204,3 +203,107 @@ Intlayer는 현대 웹 개발의 요구를 충족하도록 설계된 다양한
 저희는 오픈 소스와 커뮤니티 주도 개발의 힘을 소중히 여깁니다. 개선 사항을 제안하거나 새로운 가이드를 추가하거나 문서의 문제를 수정하려면 [GitHub 리포지토리](https://github.com/aymericzip/intlayer/blob/main/docs/docs)에서 Pull Request를 제출하거나 Issue를 열어주시기 바랍니다.
 
 **애플리케이션을 더 빠르고 효율적으로 번역할 준비가 되셨나요?** 오늘 바로 문서를 살펴보고 Intlayer 사용을 시작하세요. 콘텐츠를 체계적으로 유지하고 팀의 생산성을 높이는 강력하고 간소화된 국제화 접근 방식을 경험해 보세요.
+
+## 자주 묻는 질문
+
+<FAQ>
+
+<Question title="Intlayer는 어떤 용도로 사용되나요?">
+
+Intlayer는 JavaScript 및 TypeScript 애플리케이션을 위한 국제화(i18n) 라이브러리입니다. 컴포넌트의 콘텐츠를 컴포넌트 바로 옆의 `.content.ts` 파일에 선언하면, Intlayer가 빌드 타임에 이러한 선언을 타입 안전한 사전으로 컴파일하며 컴포넌트는 `useIntlayer`와 같은 훅을 통해 이를 읽습니다. 번역, 복수형 규칙, 성별, Markdown, 로케일 인식 라우팅, SEO 메타데이터, AI 지원 번역 및 비개발자를 위한 비주얼 에디터까지 종합적으로 지원합니다.
+
+</Question>
+
+<Question title="i18n이 번들 크기에 얼마나 영향을 미치나요?">
+
+네임스페이스 기반 설정보다 훨씬 적습니다. 페이지는 렌더링하지 않는 언어의 카탈로그를 절대 다운로드하지 않기 때문입니다. 서버 렌더링 마크업은 서버에서 콘텐츠를 확인하고, 빌드 타임 컴파일러는 `useIntlayer` 호출을 컴포넌트가 사용하는 정확한 사전 항목으로 대체하므로 사용되지 않는 키와 언어는 제거됩니다. [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)을 통해 로케일별로 분할됩니다. 일반적인 대안들과 비교했을 때 Intlayer는 번들 및 페이지 크기를 최대 50%까지 줄여줍니다. [번들 최적화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)와 [벤치마크](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/index.md)를 참조하세요.
+
+</Question>
+
+<Question title="컴포넌트를 다시 작성하지 않고 i18next, next-intl 또는 react-i18next에서 마이그레이션할 수 있나요?">
+
+네, 두 가지 방법이 있습니다. [i18next 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_i18next_to_intlayer.md) 또는 [next-intl 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_next-intl_to_intlayer.md)를 따라 점진적으로 이전할 수 있습니다. 또는 현재 API를 완전히 유지할 수도 있습니다: [호환 어댑터(compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)는 `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` 및 `Lingui`와 완전히 동일한 API를 노출하면서 Intlayer 사전에서 데이터를 제공하므로, import 구문만 변경하고 컴포넌트 코드는 그대로 유지할 수 있습니다.
+
+</Question>
+
+<Question title="기존 JSON 번역 파일을 유지할 수 있나요?">
+
+네. [sync JSON 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-json.md)은 `/messages/{locale}/{namespace}.json` 파일을 단일 진실 공급원(source of truth)으로 유지하면서 양방향으로 Intlayer 사전을 생성합니다. [sync PO 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-po.md)은 gettext 카탈로그에 대해 동일한 작업을 수행하며, [로케일별 파일](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/per_locale_file.md)을 통해 로케일을 한 파일에 모으는 대신 언어별로 콘텐츠를 분할할 수도 있습니다.
+
+</Question>
+
+<Question title="콘텐츠를 키 단위로 하나씩 옮겨야 하나요?">
+
+아닙니다. `npx intlayer extract`를 실행하면 Intlayer가 소스 파일을 읽고 사용자 대면 문자열을 추출하여 각 컴포넌트 옆에 `.content` 파일을 생성하므로 카탈로그에 일일이 복사할 필요 없이 diff만 검토하면 됩니다. [extract 명령](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)을 참조하세요.
+
+완전 자동화된 파이프라인을 위해 [Intlayer 컴파일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md)는 빌드 타임에 JSX, TSX, Vue 및 Svelte 소스에서 동일한 작업을 수행하여 변경될 때마다 사전을 생성하고 HMR을 통해 동기화하므로 수동으로 키를 관리할 필요가 없습니다. 정적 분석으로 작동하므로 런타임에만 존재하는 문자열은 제외되며, 사용자 텍스트와 애플리케이션 로직을 구분하기 위해 몇 가지 주석이 필요합니다.
+
+</Question>
+
+<Question title="사용 가능한 에디터 및 AI 에이전트 도구는 무엇이 있나요?">
+
+5가지 도구가 모두 선택 사항으로 제공됩니다:
+
+- **[VS Code 확장 프로그램](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md)**: `useIntlayer` 키에서 이를 선언한 콘텐츠 파일로 바로 이동하고, 컴포넌트에서 콘텐츠를 추출하며, 명령 팔레트나 전용 Intlayer 탭에서 build, fill, test, push, pull을 실행할 수 있습니다.
+- **[LSP 서버](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**: LSP를 지원하는 모든 에디터에서 정의로 이동, 모든 참조 찾기, 번역 값 마우스 오버 미리보기, 키 및 필드 자동 완성, 선언되지 않은 키에 대한 경고 등 동일한 기능을 제공합니다. 또한 `i18next`, `react-i18next`, `next-intl`, `use-intl` 호출도 해석하므로 마이그레이션 시 유용합니다.
+- **[MCP 서버](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)**: Cursor, VS Code, Claude Desktop, Claude Code, ChatGPT에 Intlayer 문서와 CLI를 노출하여 AI 어시스턴트가 최신 문서를 기반으로 정확히 답변하고 `intlayer fill` 등의 명령을 직접 실행할 수 있게 합니다.
+- **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)**: `intlayer-config`, `intlayer-cli`, `intlayer-content` 및 각 프레임워크 전용 스킬을 통해 AI 에이전트에게 라우팅 설정과 콘텐츠 노드 타입을 학습시킵니다.
+- **[ESLint 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/eslint.md)**: `no-raw-text` 규칙으로 하드코딩된 문자열을 표시하고, 정적 사전 키 및 사용되지 않는 콘텐츠에 대한 추가 규칙을 제공합니다.
+
+</Question>
+
+<Question title="JavaScript 앱을 국제화하는 데 사용할 수 있는 다양한 솔루션은 무엇인가요?">
+
+이 분야는 크게 세 세대로 구분됩니다:
+
+- **런타임 카탈로그 라이브러리**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`. 메시지가 런타임에 로드되는 JSON 네임스페이스에 존재합니다. 성숙하고 프레임워크에 구애받지 않지만 타입이 없고 번들 전체가 전달됩니다.
+- **컴파일 타임 메시지 라이브러리**: `Lingui`, `Paraglide`, 그리고 추출 단계를 거치는 `react-intl`, `next-intl`. 더 나은 번들 동작과 일부 타입 검사를 제공하지만 여전히 중앙 집중식 카탈로그에 의존합니다.
+- **콘텐츠 레이어 라이브러리**: `Intlayer`. 컴포넌트별로 콘텐츠를 선언하고 컴파일하므로 타입 안전성, 트리 쉐이킹(tree-shaking), 개발 도구 및 편집 기능이 동일한 소스에서 완벽하게 제공됩니다.
+
+자세한 비교는 [왜 Intlayer인가](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/interest_of_intlayer.md)를, 번들 및 성능 측정 수치는 [벤치마크](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/index.md)를 참조하세요.
+
+</Question>
+
+<Question title="Intlayer는 어떤 프레임워크를 지원하나요?">
+
+React, Next.js, Vite, TanStack Start, React Router, Vue, Nuxt, Svelte, SvelteKit, Angular, Solid, Preact, Lit, 모든 아일랜드 프레임워크를 지원하는 Astro, Expo를 포함한 React Native, Lynx, 그리고 서버 측에서는 Express, Fastify, NestJS, Hono, Elysia, AdonisJS를 지원합니다. 각각 [environments](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/introduction.md)에서 전용 가이드를 제공합니다.
+
+</Question>
+
+<Question title="중앙 JSON 파일 대신 컴포넌트 옆에 콘텐츠를 선언하는 이유는 무엇인가요?">
+
+세 가지 이유가 있습니다. 첫째, 전체 네임스페이스 대신 컴포넌트가 렌더링하는 항목만 전달하므로 번들 크기가 대폭 줄어듭니다. 둘째, 기능 폴더를 복사하거나 삭제할 때 공유 카탈로그에서 고아 키를 찾을 필요 없이 한 번에 관리할 수 있습니다. 셋째, 컴포넌트를 편집하는 LLM이나 AI 에이전트가 동일한 폴더에서 콘텐츠를 직접 볼 수 있어 AI 지원 작업이 훨씬 정확하고 안정적입니다. [Intlayer 작동 방식](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/how_works_intlayer.md)을 참조하세요.
+
+</Question>
+
+<Question title="AI를 사용하여 앱을 자동으로 번역하려면 어떻게 하나요?">
+
+`npx intlayer fill`을 실행하세요. CLI가 누락된 번역을 감지하고 자체 제공업체 및 API 키를 사용하여 원하는 LLM으로 채워주므로 비용을 AI 제공업체에 직접 지불합니다. `--git-diff`를 사용하면 브랜치에서 변경된 콘텐츠로만 작업 범위를 제한하여 CI 비용을 절감할 수 있습니다. [fill 명령](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md) 및 [CI/CD 통합](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/CI_CD.md)을 참조하세요.
+
+</Question>
+
+<Question title="누락된 번역은 어떻게 감지하나요?">
+
+`npx intlayer test`를 실행하세요. 선언된 로케일에 콘텐츠가 누락되면 실패하므로 번역되지 않은 문자열이 프로덕션에 절대 배포되지 않습니다. [VS Code 확장 프로그램](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md)은 동일한 오류를 인라인으로 표시하며, [ESLint 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/eslint.md)은 `no-raw-text` 규칙을 통해 하드코딩된 문자열을 표시합니다. [콘텐츠 테스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/testing.md)를 참조하세요.
+
+</Question>
+
+<Question title="URL에 로케일을 반드시 포함해야 하나요?">
+
+아닙니다. `routing.mode`는 `"prefix-no-default"`(기본값: `/about` 및 `/ko/about`), `"prefix-all"`, `"no-prefix"`, `"search-params"`를 지원하며, `routing.domains`를 통해 각 로케일을 자체 도메인에 매핑할 수도 있습니다. 어떤 방식을 선택하든 `getMultilingualUrls`가 메타데이터와 사이트맵을 위한 `hreflang` 대체를 자동으로 구축합니다. [설정 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
+
+</Question>
+
+<Question title="번역가와 콘텐츠 편집자가 코드를 건드리지 않고 작업하려면 어떻게 하나요?">
+
+[비주얼 에디터](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)는 배포 없이 변경될 수 있도록 콘텐츠를 외부화하며, [실시간 동기화(live sync)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md)를 통해 런타임에 업데이트를 즉시 적용합니다.
+
+</Question>
+
+<Question title="Intlayer는 무료이며 오픈 소스인가요?">
+
+네. Intlayer는 Apache 2.0 라이선스에 따른 오픈 소스이며, 라이브러리, CLI, 컴파일러 및 비주얼 에디터는 상업용 프로젝트를 포함하여 무료로 사용할 수 있습니다. 호스팅형 CMS는 선택적 유료 서비스이며 [자체 호스팅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md)도 가능합니다.
+
+</Question>
+
+</FAQ>

package/docs/ko/migration_from_i18next_to_intlayer.md

@@ -27,7 +27,6 @@ author: aymericzip
 ## 왜 i18next에서 Intlayer로 마이그레이션해야 하나요?
 
 <AccordionGroup>
-
 <Accordion header="번들 크기">
 
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
@@ -65,7 +64,6 @@ AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이
 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)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---
@@ -103,15 +101,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` 플래그는 선택 사항입니다. AI 에이전트인 경우 `intlayer-cli init`를 사용하세요.

package/docs/ko/migration_from_next-i18next_to_intlayer.md

@@ -30,7 +30,6 @@ author: aymericzip
 ## 왜 next-i18next에서 Intlayer로 마이그레이션해야 하나요?
 
 <AccordionGroup>
-
 <Accordion header="번들 크기">
 
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
@@ -68,7 +67,6 @@ AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이
 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)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---
@@ -106,15 +104,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` 플래그는 선택 사항입니다. AI 에이전트인 경우 `intlayer-cli init`를 사용하세요.

package/docs/ko/migration_from_next-intl_to_intlayer.md

@@ -28,7 +28,6 @@ author: aymericzip
 ## 왜 next-intl에서 Intlayer로 마이그레이션해야 하나요?
 
 <AccordionGroup>
-
 <Accordion header="번들 크기">
 
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
@@ -66,7 +65,6 @@ AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이
 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)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---
@@ -102,15 +100,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` 플래그는 선택 사항입니다. AI 에이전트인 경우 `intlayer-cli init`를 사용하세요.

package/docs/ko/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -29,7 +29,6 @@ author: aymericzip
 ## 왜 @nuxtjs/i18n에서 Intlayer로 마이그레이션해야 하나요?
 
 <AccordionGroup>
-
 <Accordion header="번들 크기">
 
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
@@ -67,7 +66,6 @@ AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이
 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)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---
@@ -105,15 +103,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` 플래그는 선택 사항입니다. AI 에이전트인 경우 `intlayer-cli init`를 사용하세요.

package/docs/ko/migration_from_react-i18next_to_intlayer.md

@@ -29,7 +29,6 @@ author: aymericzip
 ## 왜 react-i18next / i18next에서 Intlayer로 마이그레이션해야 하나요?
 
 <AccordionGroup>
-
 <Accordion header="번들 크기">
 
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
@@ -67,7 +66,6 @@ AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이
 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)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---
@@ -105,15 +103,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` 플래그는 선택 사항입니다. AI 에이전트인 경우 `intlayer-cli init`를 사용하세요.

package/docs/ko/migration_from_vue-i18n_to_intlayer.md

@@ -28,7 +28,6 @@ author: aymericzip
 ## 왜 vue-i18n에서 Intlayer로 마이그레이션해야 하나요?
 
 <AccordionGroup>
-
 <Accordion header="번들 크기">
 
 거대한 JSON 파일을 페이지에 불러오는 대신, 필요한 콘텐츠만 불러옵니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이도록** 도와줍니다.
@@ -66,7 +65,6 @@ AI 제공 업체의 비용만으로 원하는 LLM을 사용하여 CI/CD 파이
 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)**를 제공합니다. 이를 통해 번역가, 카피라이터 및 기타 팀 구성원과 원활하게 협업할 수 있습니다. 콘텐츠는 로컬 및/또는 원격으로 저장될 수 있습니다.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---
@@ -104,15 +102,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` 플래그는 선택 사항입니다. AI 에이전트인 경우 `intlayer-cli init`를 사용하세요.

package/docs/ko/packages/express-intlayer/t.md

@@ -67,7 +67,7 @@ t(translations: Record<string, string>): string;
 
 애플리케이션 내 모든 라우트가 국제화의 혜택을 받을 수 있도록 `app.use(intlayer())` 미들웨어를 **모든 라우트보다 먼저** 배치하세요:
 
-````typescript {7} fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
+```typescript {7} fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import express, { type Express } from "express";
 import { intlayer } from "express-intlayer";
 
@@ -79,11 +79,15 @@ app.use(intlayer());
 // 미들웨어 로드 후 라우트 정의
 app.get("/", (_req, res) => {
   res.send(
-`express-intlayer`에서 제공하는 국제화 기능이 올바르게 작동하려면, Express 애플리케이션의 시작 부분에서 반드시 국제화 미들웨어를 로드해야 합니다. 이렇게 하면 `t` 함수가 활성화되고, 로케일 감지 및 번역 처리가 제대로 이루어집니다.
-
-애플리케이션의 모든 라우트가 국제화 기능을 활용할 수 있도록 `app.use(intlayer())` 미들웨어를 **모든 라우트보다 먼저** 배치하세요:
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
 
-```typescript {7} fileName="src/index.ts" codeFormat="typescript"
 ### 왜 이것이 필요한가
 
 - **로케일 감지**: `intlayer` 미들웨어는 헤더, 쿠키 또는 기타 구성된 방법을 기반으로 사용자의 선호 로케일을 감지하기 위해 들어오는 요청을 처리합니다.
@@ -277,4 +281,3 @@ app.get("/morning", (_req, res) => {
 ## 결론
 
 `t` 함수는 백엔드 국제화를 위한 강력한 도구입니다. 이를 효과적으로 사용하면 전 세계 사용자를 위한 보다 포용적이고 사용자 친화적인 애플리케이션을 만들 수 있습니다. 고급 사용법과 상세한 구성 옵션은 [문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
-````

package/docs/ko/packages/vite-intlayer/intlayerMinify.md

@@ -71,7 +71,7 @@ export default defineConfig({
 
 `intlayerPrune`이 코드베이스를 분석하고 `pruneContext.dictionaryKeyToFieldRenameMap`을 채우면, `intlayerMinify`도 콘텐츠 필드 이름을 짧은 별칭으로 바꿉니다. 예를 들어:
 
-```json
+```jsonc
 // 변경 전
 { "key": "myDict", "content": { "title": "Hello", "description": "World" } }