@intlayer/docs 5.5.8

package/ko/intlayer_cli.md

@@ -0,0 +1,274 @@
+# Intlayer CLI
+
+## 패키지 설치
+
+npm을 사용하여 필요한 패키지를 설치합니다:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> `intlayer` 패키지가 이미 설치되어 있다면, CLI가 자동으로 설치됩니다. 이 단계를 건너뛸 수 있습니다.
+
+## intlayer-cli 패키지
+
+`intlayer-cli` 패키지는 [intlayer 선언](https://github.com/aymericzip/intlayer/blob/main/docs/ko/dictionary/get_started.md)을 사전으로 변환하는 것을 목적으로 합니다.
+
+이 패키지는 `src/**/*.content.{ts|js|mjs|cjs|json}`와 같은 모든 intlayer 파일을 변환합니다. [Intlayer 선언 파일을 선언하는 방법을 확인하세요](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+intlayer 사전을 해석하려면 [react-intlayer](https://www.npmjs.com/package/react-intlayer) 또는 [next-intlayer](https://www.npmjs.com/package/next-intlayer)와 같은 해석기를 사용할 수 있습니다.
+
+## 설정 파일 지원
+
+Intlayer는 여러 설정 파일 형식을 지원합니다:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+사용 가능한 로케일 또는 기타 매개변수를 설정하는 방법은 [여기 설정 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/configuration.md)를 참조하세요.
+
+## intlayer 명령 실행
+
+### 사전 빌드
+
+사전을 빌드하려면 다음 명령을 실행하세요:
+
+```bash
+npx intlayer dictionaries build
+```
+
+또는 감시 모드에서 실행
+
+```bash
+npx intlayer dictionaries build --watch
+```
+
+이 명령은 기본적으로 `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`로 선언된 콘텐츠 파일을 찾고 `.intlayer` 디렉토리에 사전을 빌드합니다.
+
+### 사전 푸시
+
+```bash
+npx intlayer dictionary push
+```
+
+[intlayer 편집기](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 사전을 편집기로 푸시할 수도 있습니다. 이 명령은 사전을 [편집기](https://intlayer.org/dashboard)에 사용할 수 있도록 합니다. 이를 통해 팀과 사전을 공유하고 애플리케이션 코드를 수정하지 않고 콘텐츠를 편집할 수 있습니다.
+
+##### 인수:
+
+- `-d`, `--dictionaries`: 푸시할 사전의 ID. 지정하지 않으면 모든 사전이 푸시됩니다.
+  > 예: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+- `-r`, `--deleteLocaleDictionary`: 사전을 푸시한 후 로케일 디렉토리를 삭제할지 묻는 질문을 건너뛰고 삭제합니다. 기본적으로 사전이 로컬에 정의된 경우 원격 사전의 내용을 덮어씁니다.
+  > 예: `npx intlayer dictionary push -r`
+- `-k`, `--keepLocaleDictionary`: 사전을 푸시한 후 로케일 디렉토리를 삭제할지 묻는 질문을 건너뛰고 유지합니다. 기본적으로 사전이 로컬에 정의된 경우 원격 사전의 내용을 덮어씁니다.
+  > 예: `npx intlayer dictionary push -k`
+- `--env`: 환경을 지정합니다 (예: `development`, `production`).
+- `--env-file`: 변수를 로드하기 위한 사용자 정의 환경 파일을 제공합니다.
+- `--base-dir`: 프로젝트의 기본 디렉토리를 지정합니다.
+- `--verbose`: 디버깅을 위한 자세한 로깅을 활성화합니다.
+- `--git-diff`: 푸시되지 않은 변경 사항이 있는 사전만 실행합니다.
+- `--git-diff-base`: git diff의 기본 참조를 지정합니다.
+- `--git-diff-current`: git diff의 현재 참조를 지정합니다.
+- `--uncommitted`: 커밋되지 않은 변경 사항을 포함합니다.
+- `--unpushed`: 푸시되지 않은 변경 사항을 포함합니다.
+- `--untracked`: 추적되지 않은 파일을 포함합니다.
+
+### 원격 사전 가져오기
+
+```bash
+npx intlayer dictionary pull
+```
+
+[intlayer 편집기](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 편집기에서 사전을 가져올 수도 있습니다. 이를 통해 애플리케이션의 필요에 따라 사전 내용을 덮어쓸 수 있습니다.
+
+##### 인수:
+
+- `-d, --dictionaries`: 가져올 사전의 ID. 지정하지 않으면 모든 사전이 가져와집니다.
+  > 예: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+- `--newDictionariesPath`: 새 사전이 저장될 디렉토리의 경로. 지정하지 않으면 새 사전은 프로젝트의 `./intlayer-dictionaries` 디렉토리에 저장됩니다. 사전 내용에 `filePath` 필드가 지정된 경우 사전은 이 인수를 고려하지 않고 지정된 `filePath` 디렉토리에 저장됩니다.
+- `--env`: 환경을 지정합니다 (예: `development`, `production`).
+- `--env-file`: 변수를 로드하기 위한 사용자 정의 환경 파일을 제공합니다.
+- `--base-dir`: 프로젝트의 기본 디렉토리를 지정합니다.
+- `--verbose`: 디버깅을 위한 자세한 로깅을 활성화합니다.
+
+##### 예:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```
+
+### 사전 감사
+
+```bash
+npx intlayer audit
+```
+
+이 명령은 콘텐츠 선언 파일을 분석하여 누락된 번역, 구조적 불일치 또는 타입 비호환성과 같은 잠재적인 문제를 찾습니다. 문제가 발견되면 **intlayer audit**은 사전을 일관되고 완전하게 유지하기 위해 업데이트를 제안하거나 적용합니다.
+
+##### 인수:
+
+- **`-f, --files [files...]`**  
+  감사할 특정 콘텐츠 선언 파일 목록. 제공되지 않으면 발견된 모든 `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` 파일이 감사됩니다.
+
+- **`--exclude [excludedGlobs...]`**  
+  감사에서 제외할 글로브 패턴 (예: `--exclude "src/test/**"`).
+
+- **`--source-locale [sourceLocale]`**  
+  번역할 소스 로케일. 지정하지 않으면 구성의 기본 로케일이 사용됩니다.
+
+- **`--output-locales [outputLocales...]`**  
+  번역할 대상 로케일. 지정하지 않으면 소스 로케일을 제외한 구성의 모든 로케일이 사용됩니다.
+
+- **`--mode [mode]`**  
+  번역 모드: 'complete', 'review', 또는 'missing-only'. 기본값은 'missing-only'입니다.
+
+- **`--git-diff`**  
+  git 저장소에서 푸시되지 않은 변경 사항이 있는 사전만 실행합니다.
+
+- **`--git-diff-base`**  
+  git diff의 기본 참조를 지정합니다.
+
+- **`--git-diff-current`**  
+  git diff의 현재 참조를 지정합니다.
+
+- **`--uncommitted`**  
+  커밋되지 않은 변경 사항을 포함합니다.
+
+- **`--unpushed`**  
+  푸시되지 않은 변경 사항을 포함합니다.
+
+- **`--untracked`**  
+  추적되지 않은 파일을 포함합니다.
+
+- **`--keys [keys...]`**  
+  지정된 키를 기반으로 사전을 필터링합니다.
+
+- **`--excluded-keys [excludedKeys...]`**  
+  지정된 키를 기반으로 사전을 제외합니다.
+
+- **`--path-filter [pathFilters...]`**  
+  파일 경로의 글로브 패턴을 기반으로 사전을 필터링합니다.
+
+- **`--model [model]`**  
+  번역에 사용할 AI 모델 (예: `gpt-3.5-turbo`).
+
+- **`--provider [provider]`**  
+  번역에 사용할 AI 제공자.
+
+- **`--temperature [temperature]`**  
+  AI 모델의 온도 설정.
+
+- **`--api-key [apiKey]`**  
+  AI 서비스에 대한 자체 API 키를 제공합니다.
+
+- **`--custom-prompt [prompt]`**  
+  번역 지침을 위한 사용자 정의 프롬프트를 제공합니다.
+
+- **`--application-context [applicationContext]`**  
+  AI 번역을 위한 추가 컨텍스트를 제공합니다.
+
+- **`--env`**  
+  환경을 지정합니다 (예: `development`, `production`).
+
+- **`--env-file [envFile]`**  
+  변수를 로드하기 위한 사용자 정의 환경 파일을 제공합니다.
+
+- **`--base-dir`**  
+  프로젝트의 기본 디렉토리를 지정합니다.
+
+- **`--verbose`**  
+  디버깅을 위한 자세한 로깅을 활성화합니다.
+
+##### 예:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+이 명령은 GPT-3.5 Turbo 모델을 사용하여 `src/home/` 디렉토리의 모든 콘텐츠 선언 파일의 내용을 영어에서 프랑스어와 스페인어로 번역합니다.
+
+### 설정 관리
+
+#### 설정 가져오기
+
+`get configuration` 명령은 Intlayer의 현재 설정, 특히 로케일 설정을 검색합니다. 이는 설정을 확인하는 데 유용합니다.
+
+```bash
+npx intlayer config get
+```
+
+##### 인수:
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file`**: 변수를 로드할 사용자 지정 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
+- **`--verbose`**: 디버깅을 위한 자세한 로깅을 활성화합니다.
+
+#### 설정 푸시
+
+`push configuration` 명령은 설정을 Intlayer CMS 및 편집기로 업로드합니다. 이 단계는 Intlayer Visual Editor에서 원격 사전을 사용하려면 필수입니다.
+
+```bash
+npx intlayer config push
+```
+
+##### 인수:
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file`**: 변수를 로드할 사용자 지정 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
+- **`--verbose`**: 디버깅을 위한 자세한 로깅을 활성화합니다.
+
+설정을 푸시하면 프로젝트가 Intlayer CMS와 완전히 통합되어 팀 간 원활한 사전 관리를 가능하게 합니다.
+
+## `package.json`에서 intlayer 명령 사용
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer dictionaries build",
+  "intlayer:watch": "npx intlayer dictionaries build --watch",
+  "intlayer:push": "npx intlayer dictionary push",
+  "intlayer:pull": "npx intlayer dictionary pull",
+  "intlayer:audit": "npx intlayer audit"
+}
+```
+
+## intlayer 명령어 디버깅
+
+### 1. **최신 버전을 사용하고 있는지 확인**
+
+실행:
+
+```bash
+npx intlayer --version                  # 현재 로컬 intlayer 버전
+npx intlayer@latest --version          # 최신 intlayer 버전
+```
+
+### 2. **명령어가 등록되어 있는지 확인**
+
+다음과 같이 확인할 수 있습니다:
+
+```bash
+npx intlayer --help      # 사용 가능한 명령어 목록과 사용 정보 표시
+```
+
+### 3. **터미널 재시작**
+
+새로운 명령어를 인식하기 위해 터미널 재시작이 필요할 수 있습니다.
+
+### 4. **npx 캐시 지우기 (이전 버전에 문제가 있는 경우)**
+
+```bash
+npx clear-npx-cache
+```

package/ko/intlayer_visual_editor.md

@@ -0,0 +1,210 @@
+# Intlayer Visual Editor Documentation
+
+<iframe title="Visual Editor + CMS for Your Web App: Intlayer Explained" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+Intlayer Visual Editor는 시각적 편집기를 사용하여 콘텐츠 선언 파일과 상호작용할 수 있도록 웹사이트를 래핑하는 도구입니다.
+
+![Intlayer Visual Editor Interface](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+`intlayer-editor` 패키지는 Intlayer를 기반으로 하며, React (Create React App), Vite + React, Next.js와 같은 JavaScript 애플리케이션에서 사용할 수 있습니다.
+
+## 시각적 편집기 vs CMS
+
+Intlayer Visual Editor는 로컬 사전(dictionary)을 위한 시각적 편집기에서 콘텐츠를 관리할 수 있는 도구입니다. 변경 사항이 이루어지면 콘텐츠가 코드베이스에서 교체됩니다. 즉, 애플리케이션이 다시 빌드되고 페이지가 새 콘텐츠를 표시하기 위해 다시 로드됩니다.
+
+반면, [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_CMS.md)는 원격 사전(dictionary)을 위한 시각적 편집기에서 콘텐츠를 관리할 수 있는 도구입니다. 변경 사항이 이루어지더라도 콘텐츠가 코드베이스에 영향을 미치지 않습니다. 그리고 웹사이트는 변경된 콘텐츠를 자동으로 표시합니다.
+
+## 애플리케이션에 Intlayer 통합
+
+Intlayer를 통합하는 방법에 대한 자세한 내용은 아래 관련 섹션을 참조하세요:
+
+### Next.js와 통합
+
+Next.js와 통합하려면 [설치 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_nextjs_15.md)를 참조하세요.
+
+### Create React App과 통합
+
+Create React App과 통합하려면 [설치 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_create_react_app.md)를 참조하세요.
+
+### Vite + React와 통합
+
+Vite + React와 통합하려면 [설치 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_vite+react.md)를 참조하세요.
+
+## Intlayer Editor 작동 방식
+
+시각적 편집기는 두 가지 요소를 포함하는 애플리케이션입니다:
+
+- 웹사이트를 iframe에 표시하는 프론트엔드 애플리케이션. 웹사이트가 Intlayer를 사용하는 경우, 시각적 편집기는 콘텐츠를 자동으로 감지하고 상호작용할 수 있도록 합니다. 수정이 이루어지면 변경 사항을 다운로드할 수 있습니다.
+
+- 다운로드 버튼을 클릭하면, 시각적 편집기가 서버에 요청을 보내 프로젝트 내에 선언된 콘텐츠 파일을 새 콘텐츠로 교체합니다.
+
+> 현재 Intlayer Editor는 콘텐츠 선언 파일을 JSON 파일로 작성합니다.
+
+## 설치
+
+프로젝트에서 Intlayer가 구성된 후, `intlayer-editor`를 개발 의존성으로 설치하세요:
+
+```bash packageManager="npm"
+npm install intlayer-editor --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-editor --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-editor --save-dev
+```
+
+## 구성
+
+Intlayer 구성 파일에서 편집기 설정을 사용자 정의할 수 있습니다:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... 기타 구성 설정
+  editor: {
+    /**
+     * 필수
+     * 애플리케이션의 URL.
+     * 시각적 편집기가 대상으로 하는 URL입니다.
+     * 예: 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * 선택 사항
+     * 기본값은 `true`입니다. `false`로 설정하면 편집기가 비활성화되어 접근할 수 없습니다.
+     * 보안상의 이유로 특정 환경(예: 프로덕션)에서 편집기를 비활성화하는 데 사용할 수 있습니다.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * 선택 사항
+     * 기본값은 `8000`입니다.
+     * 편집기 서버의 포트입니다.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * 선택 사항
+     * 기본값은 "http://localhost:8000"입니다.
+     * 편집기 서버의 URL입니다.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 기타 구성 설정
+  editor: {
+    /**
+     * 필수
+     * 애플리케이션의 URL.
+     * 시각적 편집기가 대상으로 하는 URL입니다.
+     * 예: 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * 선택 사항
+     * 기본값은 `true`입니다. `false`로 설정하면 편집기가 비활성화되어 접근할 수 없습니다.
+     * 보안상의 이유로 특정 환경(예: 프로덕션)에서 편집기를 비활성화하는 데 사용할 수 있습니다.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * 선택 사항
+     * 기본값은 `8000`입니다.
+     * 시각적 편집기 서버가 사용하는 포트입니다.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * 선택 사항
+     * 기본값은 "http://localhost:8000"입니다.
+     * 애플리케이션에서 접근할 수 있는 편집기 서버의 URL입니다. 보안상의 이유로 애플리케이션과 상호작용할 수 있는 출처를 제한하는 데 사용됩니다. `'*'`로 설정하면 모든 출처에서 편집기에 접근할 수 있습니다. 포트가 변경되거나 편집기가 다른 도메인에 호스팅되는 경우 설정해야 합니다.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 기타 구성 설정
+  editor: {
+    /**
+     * 필수
+     * 애플리케이션의 URL.
+     * 시각적 편집기가 대상으로 하는 URL입니다.
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * 선택 사항
+     * 기본값은 `8000`입니다.
+     * 편집기 서버의 포트입니다.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * 선택 사항
+     * 기본값은 "http://localhost:8000"입니다.
+     * 편집기 서버의 URL입니다.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+    /**
+     * 선택 사항
+     * 기본값은 `true`입니다. `false`로 설정하면 편집기가 비활성화되어 접근할 수 없습니다.
+     * 보안상의 이유로 특정 환경(예: 프로덕션)에서 편집기를 비활성화하는 데 사용할 수 있습니다.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+  },
+};
+
+module.exports = config;
+```
+
+> 사용 가능한 모든 매개변수를 보려면 [구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/configuration.md)를 참조하세요.
+
+## 편집기 사용
+
+1. 편집기가 설치되면 다음 명령어를 사용하여 편집기를 시작할 수 있습니다:
+
+   ```bash packageManager="npm"
+   npx intlayer-editor start
+   ```
+
+   ```bash packageManager="yarn"
+   yarn intlayer-editor start
+   ```
+
+   ```bash packageManager="pnpm"
+   pnpm intlayer-editor start
+   ```
+
+   > **애플리케이션을 병렬로 실행해야 합니다.** 애플리케이션 URL은 편집기 구성(`applicationURL`)에 설정한 URL과 일치해야 합니다.
+
+2. 제공된 URL을 엽니다. 기본값은 `http://localhost:8000`입니다.
+
+   Intlayer에 의해 색인된 각 필드를 커서를 사용하여 콘텐츠 위로 이동하면 볼 수 있습니다.
+
+   ![Hovering over content](https://github.com/aymericzip/intlayer/blob/main/docs/assets/intlayer_editor_hover_content.png)
+
+3. 콘텐츠가 윤곽선으로 표시되면, 길게 눌러 편집 서랍을 표시할 수 있습니다.
+
+## 디버그
+
+시각적 편집기에서 문제가 발생하면 다음을 확인하세요:
+
+- 시각적 편집기와 애플리케이션이 실행 중인지 확인하세요.
+
+- Intlayer 구성 파일에서 [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) 구성이 올바르게 설정되었는지 확인하세요.
+
+  - 필수 필드:
+    - 애플리케이션 URL은 편집기 구성(`applicationURL`)에 설정한 URL과 일치해야 합니다.
+
+- 시각적 편집기는 iframe을 사용하여 웹사이트를 표시합니다. 웹사이트의 콘텐츠 보안 정책(CSP)이 CMS URL을 `frame-ancestors`로 허용하는지 확인하세요(기본값은 'http://localhost:8000'). 편집기 콘솔에서 오류를 확인하세요.

package/ko/intlayer_with_angular.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/intlayer_with_vite+preact.md