@llm-translate/cli 1.0.0-next.1

package/docs/ja/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以上
+- 少なくとも1つの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/ja/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/ja/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は一度翻訳して終わりではありません。反復的な改善プロセスを使用します：