@llm-translate/cli 1.0.0-next.1

package/docs/ko/guide/getting-started.md

@@ -0,0 +1,150 @@
+# 시작하기
+
+::: info 번역
+모든 비영어 문서는 Claude Sonnet 4를 사용하여 자동으로 번역됩니다.
+:::
+
+## 설치
+
+### npm (권장)
+
+```bash
+npm install -g @llm-translate/cli
+```
+
+### 소스에서 설치
+
+```bash
+git clone https://github.com/selenehyun/llm-translate.git
+cd llm-translate
+npm install
+npm run build
+npm link
+```
+
+## 사전 요구사항
+
+- Node.js 24 이상
+- 최소 하나의 LLM 제공자에 대한 API 키:
+  - Anthropic (Claude)
+  - OpenAI
+  - Ollama (로컬, API 키 불필요)
+
+## 구성
+
+### 1. API 키 설정
+
+```bash
+# For Claude (recommended)
+export ANTHROPIC_API_KEY=sk-ant-xxxxx
+
+# For OpenAI
+export OPENAI_API_KEY=sk-xxxxx
+
+# For Ollama (no key needed, just ensure server is running)
+# See the Ollama guide for setup: ./ollama
+export OLLAMA_BASE_URL=http://localhost:11434
+```
+
+### 2. 구성 초기화 (선택사항)
+
+```bash
+llm-translate init
+```
+
+이는 기본 설정으로 `.translaterc.json` 파일을 생성합니다:
+
+```json
+{
+  "provider": {
+    "name": "claude",
+    "model": "claude-haiku-4-5-20251001"
+  },
+  "translation": {
+    "qualityThreshold": 85,
+    "maxIterations": 4
+  },
+  "paths": {
+    "glossary": "./glossary.json"
+  }
+}
+```
+
+## 첫 번째 번역
+
+### 기본 사용법
+
+```bash
+# Translate a markdown file to Korean
+llm-translate file README.md -o README.ko.md -s en -t ko
+
+# Using long option names
+llm-translate file docs/guide.md -o docs/guide.ja.md --source-lang en --target-lang ja
+```
+
+### 용어집 사용
+
+1. `glossary.json` 파일을 생성합니다:
+
+```json
+{
+  "sourceLanguage": "en",
+  "terms": [
+    {
+      "source": "component",
+      "targets": { "ko": "컴포넌트" },
+      "context": "UI component"
+    },
+    {
+      "source": "prop",
+      "targets": { "ko": "프롭" },
+      "context": "React prop"
+    },
+    {
+      "source": "TypeScript",
+      "doNotTranslate": true
+    }
+  ]
+}
+```
+
+2. 용어집과 함께 번역합니다:
+
+```bash
+llm-translate file README.md -o README.ko.md -s en -t ko --glossary glossary.json
+```
+
+### 일괄 번역
+
+전체 디렉토리를 번역합니다:
+
+```bash
+llm-translate dir ./docs ./docs-ko -s en -t ko --glossary glossary.json
+```
+
+## 출력 결과 이해하기
+
+번역 후 다음과 같은 정보를 확인할 수 있습니다:
+
+```
+✓ Translation complete
+  Quality: 92/85 (threshold met)
+  Iterations: 2
+  Tokens: 1,234 input / 1,456 output
+  Cache: 890 read / 234 written (78% hit rate)
+  Duration: 3.2s
+```
+
+- **Quality**: 최종 점수 대 임계값
+- **Iterations**: 개선 사이클 수
+- **Tokens**: API 토큰 사용량
+- **Cache**: 프롬프트 캐싱 통계 (Claude만 해당)
+- **Duration**: 총 처리 시간
+
+## 다음 단계
+
+- 최적 설정을 위한 [프로젝트 구성](./configuration)
+- 일관된 용어를 위한 [용어집 설정](./glossary)
+- [품질 제어](./quality-control) 및 튜닝 이해
+- 대규모 프로젝트를 위한 [비용 최적화](./cost-optimization)
+- 비공개 오프라인 번역을 위한 [Ollama로 로컬 실행](./ollama)

package/docs/ko/guide/glossary.md

@@ -0,0 +1,214 @@
+# 용어집
+
+::: info 번역
+모든 비영어 문서는 Claude Sonnet 4를 사용하여 자동으로 번역됩니다.
+:::
+
+용어집 기능은 모든 번역에서 일관된 용어 사용을 보장합니다. 용어를 한 번 정의하면 매번 동일한 방식으로 번역됩니다.
+
+## 용어집 파일 형식
+
+`glossary.json` 파일을 생성합니다:
+
+```json
+{
+  "sourceLanguage": "en",
+  "version": "1.0.0",
+  "terms": [
+    {
+      "source": "component",
+      "targets": {
+        "ko": "컴포넌트",
+        "ja": "コンポーネント",
+        "zh": "组件"
+      },
+      "context": "UI component in React/Vue"
+    }
+  ]
+}
+```
+
+## 용어 구조
+
+### 기본 용어
+
+```json
+{
+  "source": "endpoint",
+  "targets": {
+    "ko": "엔드포인트",
+    "ja": "エンドポイント"
+  }
+}
+```
+
+### 컨텍스트 포함
+
+컨텍스트는 LLM이 용어를 사용하는 방법을 이해하는 데 도움이 됩니다:
+
+```json
+{
+  "source": "state",
+  "targets": { "ko": "상태" },
+  "context": "Application state in state management"
+}
+```
+
+### 번역하지 않음
+
+기술 용어를 영어로 유지합니다:
+
+```json
+{
+  "source": "Kubernetes",
+  "doNotTranslate": true
+}
+```
+
+### 특정 언어에 대해 번역하지 않음
+
+```json
+{
+  "source": "React",
+  "doNotTranslateFor": ["ko", "ja"],
+  "targets": {
+    "zh": "React框架"
+  }
+}
+```
+
+### 대소문자 구분
+
+```json
+{
+  "source": "API",
+  "targets": { "ko": "API" },
+  "caseSensitive": true
+}
+```
+
+## 완전한 예제
+
+```json
+{
+  "sourceLanguage": "en",
+  "version": "1.0.0",
+  "description": "Technical documentation glossary",
+  "terms": [
+    {
+      "source": "component",
+      "targets": { "ko": "컴포넌트", "ja": "コンポーネント" },
+      "context": "UI component"
+    },
+    {
+      "source": "prop",
+      "targets": { "ko": "프롭", "ja": "プロップ" },
+      "context": "React component property"
+    },
+    {
+      "source": "hook",
+      "targets": { "ko": "훅", "ja": "フック" },
+      "context": "React hook (useState, useEffect, etc.)"
+    },
+    {
+      "source": "state",
+      "targets": { "ko": "상태", "ja": "ステート" },
+      "context": "Component or application state"
+    },
+    {
+      "source": "TypeScript",
+      "doNotTranslate": true
+    },
+    {
+      "source": "JavaScript",
+      "doNotTranslate": true
+    },
+    {
+      "source": "npm",
+      "doNotTranslate": true
+    },
+    {
+      "source": "API",
+      "doNotTranslate": true,
+      "caseSensitive": true
+    }
+  ]
+}
+```
+
+## CLI 명령어
+
+### 용어집 용어 목록 보기
+
+```bash
+llm-translate glossary list --glossary glossary.json
+```
+
+### 용어집 검증
+
+```bash
+llm-translate glossary validate --glossary glossary.json
+```
+
+### 용어 추가
+
+```bash
+llm-translate glossary add "container" --target ko="컨테이너" --glossary glossary.json
+```
+
+### 용어 제거
+
+```bash
+llm-translate glossary remove "container" --glossary glossary.json
+```
+
+## 모범 사례
+
+### 1. 일반적인 기술 용어부터 시작
+
+```json
+{
+  "terms": [
+    { "source": "API", "doNotTranslate": true },
+    { "source": "SDK", "doNotTranslate": true },
+    { "source": "CLI", "doNotTranslate": true },
+    { "source": "URL", "doNotTranslate": true },
+    { "source": "JSON", "doNotTranslate": true }
+  ]
+}
+```
+
+### 2. 제품별 용어 포함
+
+```json
+{
+  "source": "Workspace",
+  "targets": { "ko": "워크스페이스" },
+  "context": "Product-specific workspace feature"
+}
+```
+
+### 3. 모호한 용어에 컨텍스트 추가
+
+```json
+{
+  "source": "run",
+  "targets": { "ko": "실행" },
+  "context": "Execute a command or script"
+}
+```
+
+### 4. 브랜드명에 `doNotTranslate` 사용
+
+```json
+{
+  "source": "GitHub",
+  "doNotTranslate": true
+}
+```
+
+### 5. 용어집 버전 관리
+
+문서와 함께 용어집 변경 사항을 추적합니다.
+
+## 용어 적용 방식

package/docs/ko/guide/index.md

@@ -0,0 +1,32 @@
+# llm-translate란 무엇입니까?
+
+::: info 번역
+모든 비영어 문서는 Claude Sonnet 4를 사용하여 자동으로 번역됩니다.
+:::
+
+llm-translate는 대규모 언어 모델을 사용하여 문서를 번역하는 CLI 도구입니다. 일관성, 정확성, 형식 보존이 중요한 기술 문서를 위해 특별히 설계되었습니다.
+
+## 주요 기능
+
+### 용어집 강제 적용
+
+도메인별 전문 용어를 한 번 정의하고 모든 문서에서 일관되게 번역되도록 보장합니다.
+
+```json
+{
+  "terms": [
+    {
+      "source": "API endpoint",
+      "targets": { "ko": "API 엔드포인트", "ja": "APIエンドポイント" }
+    },
+    {
+      "source": "Kubernetes",
+      "doNotTranslate": true
+    }
+  ]
+}
+```
+
+### Self-Refine 품질 관리
+
+llm-translate는 단순히 한 번 번역하고 끝내지 않습니다. 반복적인 개선 프로세스를 사용합니다: