@intlayer/docs 5.5.10 → 5.5.12

package/ko/intlayer_cli.md

@@ -1,274 +0,0 @@
-# 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

@@ -1,210 +0,0 @@
-# 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

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