@intlayer/docs 5.5.9 → 5.5.11

package/docs/ko/introduction.md

@@ -0,0 +1,209 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: 소개
+description: Intlayer가 어떻게 작동하는지 알아보세요. 애플리케이션에서 Intlayer가 사용하는 단계들을 확인하세요. 다양한 패키지들이 하는 일을 살펴보세요.
+keywords:
+  - 소개
+  - 시작하기
+  - Intlayer
+  - 애플리케이션
+  - 패키지
+slugs:
+  - doc
+  - get-started
+---
+
+# Intlayer 문서
+
+공식 Intlayer 문서에 오신 것을 환영합니다! 여기에서는 Next.js, React, Vite, Express 또는 기타 자바스크립트 환경에서 작업하든, 모든 국제화(i18n) 요구 사항을 위해 Intlayer를 통합, 구성 및 마스터하는 데 필요한 모든 정보를 찾을 수 있습니다.
+
+## 소개
+
+### Intlayer란 무엇인가요?
+
+**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 국제화 라이브러리입니다. 코드 어디에서나 콘텐츠를 선언할 수 있도록 허용합니다. 다국어 콘텐츠 선언을 구조화된 사전(dictionary)으로 변환하여 코드에 쉽게 통합할 수 있게 합니다. TypeScript를 사용하여, **Intlayer**는 개발을 더욱 견고하고 효율적으로 만듭니다.
+
+Intlayer는 또한 콘텐츠를 쉽게 편집하고 관리할 수 있는 선택적 시각적 편집기를 제공합니다. 이 편집기는 콘텐츠 관리를 위한 시각적 인터페이스를 선호하는 개발자나, 코드를 신경 쓰지 않고 콘텐츠를 생성하는 팀에게 특히 유용합니다.
+
+### 사용 예시
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// 컴포넌트 콘텐츠 선언
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// 컴포넌트 콘텐츠 선언
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## 주요 기능
+
+Intlayer는 현대 웹 개발의 요구에 맞춘 다양한 기능을 제공합니다. 아래는 주요 기능과 각 기능에 대한 자세한 문서 링크입니다:
+
+- **국제화 지원**: 내장된 국제화 지원으로 애플리케이션의 글로벌 도달 범위를 확장하세요.
+- **비주얼 에디터**: Intlayer를 위해 설계된 에디터 플러그인으로 개발 워크플로우를 향상시키세요. [비주얼 에디터 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)를 확인하세요.
+- **구성 유연성**: [구성 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에 자세히 설명된 광범위한 구성 옵션으로 설정을 맞춤화하세요.
+- **고급 CLI 도구**: Intlayer의 명령줄 인터페이스를 사용하여 프로젝트를 효율적으로 관리하세요. [CLI 도구 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md)에서 기능을 탐색할 수 있습니다.
+
+## 핵심 개념
+
+### 사전(Dictionary)
+
+다국어 콘텐츠를 코드 가까이에 정리하여 모든 것을 일관되고 유지 관리하기 쉽게 만드세요.
+
+- **[시작하기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/get_started.md)**  
+  Intlayer에서 콘텐츠를 선언하는 기본 사항을 배우세요.
+
+- **[번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md)**  
+  번역이 어떻게 생성되고 저장되며 애플리케이션에서 활용되는지 이해하세요.
+
+- **[열거](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/enumeration.md)**  
+  여러 언어에 걸쳐 반복되거나 고정된 데이터 집합을 쉽게 관리하세요.
+
+- **[조건](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/conditional.md)**  
+  Intlayer에서 조건 논리를 사용하여 동적 콘텐츠를 만드는 방법을 배우세요.
+
+- **[삽입](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/insertion.md)**  
+  삽입 자리 표시자를 사용하여 문자열에 값을 삽입하는 방법을 알아보세요.
+
+- **[함수 페칭](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/function_fetching.md)**  
+  프로젝트 워크플로우에 맞게 맞춤 로직으로 동적으로 콘텐츠를 가져오는 방법을 확인하세요.
+
+- **[마크다운](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)**  
+  Intlayer에서 외부 파일을 임베딩하여 콘텐츠 편집기에서 사용하는 방법을 알아보세요.
+
+- **[중첩](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/nesting.md)**  
+  Intlayer에서 콘텐츠를 중첩하여 복잡한 구조를 만드는 방법을 이해하세요.
+
+### 환경 및 통합
+
+Intlayer는 유연성을 염두에 두고 설계되어, 인기 있는 프레임워크와 빌드 도구와의 원활한 통합을 제공합니다:
+
+- **[Next.js 15와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_15.md)**
+- **[Next.js 14 (앱 라우터)와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_14.md)**
+- **[Next.js 페이지 라우터와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_page_router.md)**
+- **[React CRA와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_create_react_app.md)**
+- **[Vite + React와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_vite+react.md)**
+- **[React Native와 Expo와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_react_native+expo.md)**
+- **[Lynx와 React와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_lynx+react.md)**
+- **[Express와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_express.md)**
+
+각 통합 가이드에는 **서버 사이드 렌더링**, **동적 라우팅**, 또는 **클라이언트 사이드 렌더링**과 같은 Intlayer 기능을 사용하는 모범 사례가 포함되어 있어, 빠르고 SEO 친화적이며 매우 확장 가능한 애플리케이션을 유지할 수 있습니다.
+
+## 기여 및 피드백
+
+우리는 오픈 소스와 커뮤니티 주도 개발의 힘을 소중히 여깁니다. 개선 사항을 제안하거나, 새로운 가이드를 추가하거나, 문서의 문제를 수정하고 싶다면 언제든지 Pull Request를 제출하거나 [GitHub 저장소](https://github.com/aymericzip/intlayer/blob/main/docs/docs)에서 이슈를 열어 주세요.
+
+**더 빠르고 효율적으로 애플리케이션을 번역할 준비가 되셨나요?** 지금 바로 문서를 탐색하여 Intlayer를 사용해 보세요. 콘텐츠를 체계적으로 관리하고 팀의 생산성을 높이는 강력하고 간소화된 국제화 방식을 경험할 수 있습니다.
+
+---
+
+## 문서 이력
+
+- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/mcp_server.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-06-07
+title: MCP 서버 문서
+description: MCP 서버의 기능과 설정을 탐색하여 서버 관리 및 운영을 최적화하세요.
+keywords:
+  - MCP 서버
+  - 서버 관리
+  - 최적화
+  - Intlayer
+  - 문서
+  - 설정
+  - 기능
+slugs:
+  - doc
+  - mcp-server
+---
+
+# Intlayer MCP 서버
+
+**Intlayer MCP (Model Context Protocol) 서버**는 Intlayer 생태계에 맞춤화된 AI 기반 IDE 지원을 제공합니다. **Cursor**, **GitHub Copilot 작업 공간**과 같은 최신 개발 환경 및 MCP 프로토콜을 지원하는 모든 IDE를 위해 설계되었으며, 프로젝트 설정에 기반한 상황별 실시간 지원을 제공합니다.
+
+## 왜 Intlayer MCP 서버를 사용해야 하나요?
+
+IDE에서 Intlayer MCP 서버를 활성화하면 다음과 같은 기능을 사용할 수 있습니다:
+
+- **스마트 CLI 통합**
+  IDE 인터페이스에서 직접 Intlayer CLI 명령을 실행하고 접근할 수 있습니다. 명령어와 옵션의 전체 목록은 [Intlayer CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md)에서 확인하세요.
+
+- **상황 인식 문서 제공**
+  MCP 서버는 프로젝트에서 사용 중인 Intlayer 버전에 해당하는 문서를 로드하고 노출합니다. 이를 통해 코드 제안, 명령 옵션 및 설명이 항상 최신 상태이고 관련성이 있도록 보장합니다.
+
+- **AI 지원 개발**
+  프로젝트 인식 제안 및 자동 완성을 통해 AI 어시스턴트가 코드를 설명하고, CLI 사용법을 추천하거나 현재 파일을 기반으로 Intlayer의 특정 기능 사용 방법을 제안할 수 있습니다.
+
+- **경량 및 즉시 설정**
+  서버 유지 관리나 무거운 설치가 필요 없습니다. 단지 `.cursor/mcp.json` 또는 이에 상응하는 MCP 설정을 구성하면 바로 사용할 수 있습니다.
+
+---
+
+## Cursor 설정
+
+프로젝트 루트에 다음 `.cursor/mcp.json` 구성 파일을 추가하세요:
+
+```json
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+이 구성은 IDE에 `npx`를 사용하여 Intlayer MCP 서버를 실행하도록 지시하며, 버전을 고정하지 않는 한 항상 최신 버전을 사용하도록 보장합니다.
+
+---
+
+## VS Code 설정
+
+VS Code에서 Intlayer MCP 서버를 사용하려면 작업 공간 또는 사용자 설정에서 구성해야 합니다.
+
+### 작업 공간 구성
+
+프로젝트 루트에 `.vscode/mcp.json` 파일을 생성하세요:
+
+```json
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### VS Code에서 MCP 서버 사용하기
+
+1. **에이전트 모드 활성화**: 채팅 뷰를 열고 (Mac에서는 ⌃⌘I, Windows/Linux에서는 Ctrl+Alt+I) 드롭다운에서 **Agent** 모드를 선택하세요.
+
+2. **도구 접근**: **도구(Tools)** 버튼을 클릭하여 사용 가능한 Intlayer 도구를 확인하세요. 필요에 따라 특정 도구를 선택하거나 선택 해제할 수 있습니다.
+
+3. **직접 도구 참조**: 프롬프트에서 `#` 뒤에 도구 이름을 입력하여 도구를 직접 참조할 수 있습니다.
+
+4. **도구 확인**: 기본적으로 VS Code는 도구 실행 전에 확인을 요청합니다. **계속(Continue)** 버튼 옵션을 사용하여 현재 세션, 작업 공간 또는 모든 향후 호출에 대해 도구를 자동으로 확인할 수 있습니다.
+
+### 서버 관리
+
+- 명령 팔레트에서 **MCP: 서버 목록(List Servers)** 을 실행하여 구성된 서버를 확인하세요.
+- 필요에 따라 Intlayer MCP 서버를 시작, 중지 또는 재시작하세요.
+- 서버를 선택하고 **출력 표시(Show Output)** 를 선택하여 문제 해결을 위한 서버 로그를 확인하세요.
+
+VS Code MCP 통합에 대한 자세한 정보는 [공식 VS Code MCP 문서](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)를 참조하세요.
+
+---
+
+## CLI를 통한 MCP 서버 사용
+
+Intlayer MCP 서버를 명령줄에서 직접 실행하여 테스트, 디버깅 또는 다른 도구와의 통합에 사용할 수 있습니다.
+
+### MCP 서버 설치
+
+먼저, MCP 서버 패키지를 전역으로 설치하거나 npx를 통해 사용하세요:
+
+```bash
+# 전역 설치
+npm install -g @intlayer/mcp
+
+# 또는 npx로 직접 사용 (권장)
+npx @intlayer/mcp
+```
+
+### 서버 시작
+
+디버깅 및 테스트를 위한 인스펙터와 함께 MCP 서버를 시작하려면:
+
+```bash
+# 내장된 start 명령어 사용
+npm run start
+
+# 또는 npx로 직접 실행
+npx @modelcontextprotocol/inspector npx @intlayer/mcp
+```
+
+이 명령은 검사기 인터페이스와 함께 MCP 서버를 실행하여 다음 작업을 수행할 수 있습니다:
+
+- MCP 프로토콜 통신 테스트
+- 서버 응답 디버깅
+- 도구 및 리소스 구현 검증
+- 서버 성능 모니터링
+
+### 개발 용도
+
+개발 및 테스트 목적으로 서버를 다양한 모드로 실행할 수 있습니다:
+
+```bash
+# 개발 모드에서 빌드 및 시작
+npm run dev
+
+# 사용자 지정 구성으로 실행
+node dist/cjs/index.cjs
+
+# 서버 기능 테스트
+npm test
+```
+
+서버는 Cursor나 다른 IDE뿐만 아니라 모든 MCP 호환 클라이언트가 사용할 수 있는 Intlayer 전용 도구와 리소스를 제공합니다.
+
+---
+
+## 기능 개요
+
+| Feature       | Description                                                  |
+| ------------- | ------------------------------------------------------------ |
+| CLI 지원      | `intlayer` 명령어 실행, 사용법 힌트 및 인라인 인수 제공      |
+| 버전별 문서   | 현재 사용 중인 Intlayer 버전에 맞는 문서를 자동 감지 및 로드 |
+| 자동완성      | 입력 중인 명령어 및 설정에 대한 지능형 제안                  |
+| 플러그인 지원 | MCP 표준을 지원하는 IDE 및 도구와 호환 가능                  |
+
+---
+
+## 유용한 링크
+
+- [Intlayer CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md)
+- [Intlayer GitHub 저장소](https://github.com/aymericzip/intlayer)
+
+---
+
+## 문서 이력
+
+- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/@intlayer/api/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/api - Intlayer API 통합용 SDK
+description: 콘텐츠 감사, 조직, 프로젝트 및 사용자 관리를 위해 Intlayer API와 상호작용하는 소프트웨어 개발 키트(SDK)를 제공하는 NPM 패키지입니다.
+keywords:
+  - intlayer
+  - API
+  - SDK
+  - 통합
+  - 콘텐츠 감사
+  - 조직
+  - 프로젝트
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - api
+---
+
+# @intlayer/api: Intlayer API와 상호작용하는 NPM 패키지
+
+**Intlayer**는 JavaScript 개발자를 위해 특별히 설계된 패키지 모음입니다. React, React Native, Express.js와 같은 프레임워크와 호환됩니다.
+
+**`@intlayer/api`** 패키지는 Intlayer API와 상호작용하기 위한 SDK(소프트웨어 개발 키트)입니다. 콘텐츠 선언을 감사하고, 조직, 프로젝트, 사용자와 상호작용하는 기능들을 제공합니다.
+
+## 사용법
+
+```ts
+import { intlayerAPI } from "@intlayer/api";
+
+intlayerAPI.user.getUser({
+  ids: ["user-id-1", "user-id-2"],
+});
+```
+
+## 설치
+
+선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
+
+```bash packageManager="npm"
+npm install @intlayer/api
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
+
+## 문서 이력
+
+- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/@intlayer/chokidar/index.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/chokidar - Intlayer i18n용 파일 감시
+description: Intlayer를 위한 파일 감시 기능을 제공하는 NPM 패키지로, 국제화 콘텐츠의 자동 업데이트 및 핫 리로딩을 가능하게 합니다.
+keywords:
+  - intlayer
+  - chokidar
+  - 파일 감시
+  - 핫 리로드
+  - i18n
+  - 자바스크립트
+  - NPM
+  - 개발
+slugs:
+  - doc
+  - package
+  - @intlayer_chokidar
+---
+
+# @intlayer/chokidar: Intlayer 선언 파일을 사전으로 스캔 및 빌드하는 NPM 패키지
+
+**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 패키지 모음입니다. React, React, Express.js와 같은 프레임워크와 호환됩니다.
+
+**`@intlayer/chokidar`** 패키지는 [chokidar](https://github.com/paulmillr/chokidar)를 사용하여 Intlayer 선언 파일을 스캔하고 [Intlayer 구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에 따라 사전으로 빌드하는 데 사용됩니다.
+
+## 사용법
+
+```ts
+import { watch, prepareIntlayer } from "@intlayer/chokidar";
+
+await prepareIntlayer(); // Intlayer 사전 빌드
+
+watch({ persistent: true }); // 구성 파일 변경 감시
+```
+
+## 설치
+
+선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
+
+```bash packageManager="npm"
+npm install @intlayer/chokidar
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/chokidar
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/chokidar
+```
+
+## 문서 이력
+
+- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/@intlayer/cli/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/cli - Intlayer용 커맨드 라인 인터페이스 패키지
+description: 국제화 관리를 위한 모든 커맨드 라인 인터페이스의 일관성을 보장하는 Intlayer CLI 명령어용 스크립트를 제공하는 NPM 패키지.
+keywords:
+  - intlayer
+  - CLI
+  - 커맨드 라인
+  - 스크립트
+  - i18n
+  - 자바스크립트
+  - NPM
+  - 도구
+slugs:
+  - doc
+  - package
+  - @intlayer_cli
+---
+
+# @intlayer/cli: intlayer CLI가 제공하는 스크립트를 사용하기 위한 NPM 패키지
+
+**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 패키지 모음입니다. React, React, Express.js와 같은 프레임워크와 호환됩니다.
+
+**`@intlayer/cli`** 패키지는 intlayer 커맨드 라인 인터페이스와 관련된 스크립트를 선언하는 데 사용되는 NPM 패키지입니다. 모든 intlayer CLI 명령어의 일관성을 보장합니다. 이 패키지는 특히 [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/ko/packages/intlayer-cli/index.md) 및 [intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/ko/packages/intlayer/index.md) 패키지에서 사용됩니다.
+
+## 설치
+
+선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
+
+```bash packageManager="npm"
+npm install @intlayer/cli
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli
+```
+
+## 문서 이력
+
+- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/@intlayer/config/index.md

@@ -0,0 +1,140 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/config - Intlayer를 위한 구성 관리
+description: 다양한 환경에서 국제화 설정을 위한 환경 변수를 정의하고 Intlayer 구성을 가져오는 NPM 패키지입니다.
+keywords:
+  - intlayer
+  - 구성
+  - 환경
+  - 설정
+  - i18n
+  - JavaScript
+  - NPM
+  - 변수
+slugs:
+  - doc
+  - package
+  - @intlayer_config
+---
+
+# @intlayer/config: Intlayer 구성을 가져오는 NPM 패키지
+
+**Intlayer**는 JavaScript 개발자를 위해 특별히 설계된 패키지 모음입니다. React, React Native, Express.js와 같은 프레임워크와 호환됩니다.
+
+**`@intlayer/config`** 패키지는 Intlayer의 구성을 가져오고 현재 환경과 관련된 환경 변수를 정의할 수 있는 NPM 패키지입니다.
+
+## 설치
+
+선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
+
+```bash packageManager="npm"
+npm install @intlayer/config
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/config
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/config
+```
+
+## 사용법
+
+### 파일 시스템을 사용하여 Intlayer 구성 읽기
+
+예시:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config";
+
+const config: IntlayerConfig = getConfiguration();
+
+console.log(config);
+// 출력:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> 이 함수는 `fs` 패키지를 사용하며 서버 사이드에서만 작동합니다.
+
+### 환경 변수를 사용하여 Intlayer 구성 읽기
+
+예시:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config/client";
+
+const config: IntlayerConfig = getConfiguration({
+  env: "production",
+});
+
+console.log(config);
+// 출력:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> 환경 변수가 정의되어 있지 않으면 이 함수는 아무것도 반환하지 않습니다.
+
+### 환경 변수 정의하기
+
+1. 구성 파일 생성하기.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    /* ... */
+  },
+  middleware: {
+    /* ... */
+  },
+  content: {
+    /* ... */
+  },
+  editor: {
+    /* ... */
+  },
+};
+
+export default config;
+```
+
+> 자세한 내용은 [Intlayer 구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
+
+2. 환경 변수 정의하기.
+
+```ts
+import { getConfiguration } from "@intlayer/config";
+
+const intlayerConfig = getConfiguration();
+
+// 모든 구성 값을 환경 변수 형식으로 변환
+const env = formatEnvVariable();
+
+// 변환된 각 환경 변수를 process.env에 설정
+Object.assign(process.env, env);
+```
+
+3. 구성 파일을 가져옵니다.
+
+```ts
+import { getConfiguration } from "@intlayer/config/client";
+
+const intlayerConfig = getConfiguration();
+```
+
+## 문서 이력
+
+- 5.5.10 - 2025-06-29: 초기 이력