การติดตั้ง
ข้อกำหนดเบื้องต้น
- Node.js 20.11+ (native ESM)
- API key สำหรับการแปล (ดูด้านล่าง)
ติดตั้ง
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev champollion
npx champollion sync
pnpm add -D champollion
yarn add --dev champollion
รับ API Key
Champollion ต้องการ backend สำหรับการแปล เลือกหนึ่งรายการ:
| ผู้ให้บริการ | ตัวแปรสภาพแวดล้อม | เหมาะสำหรับ |
|---|---|---|
| OpenRouter (แนะนำ) | OPENROUTER_API_KEY | โปรเจกต์ที่มีเนื้อหาจำนวนมาก, Markdown, โมเดล 200+ รายการ |
| Gemini (ฟรีเทียร์) | GEMINI_API_KEY | เริ่มต้นโดยไม่มีค่าใช้จ่าย, คุณภาพดี |
| OpenAI | OPENAI_API_KEY | เข้าถึง GPT-4o โดยตรง |
| Anthropic | ANTHROPIC_API_KEY | เข้าถึง Claude โดยตรง, เหมาะกับข้อความที่ต้องการความละเอียดอ่อน |
| DeepL | DEEPL_API_KEY | ภาษายุโรป, รองรับระดับความเป็นทางการในตัว |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | คู่ key-value ปริมาณสูง, 130+ ภาษา |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure, 100+ ภาษา |
| LibreTranslate | LIBRETRANSLATE_API_URL | Self-hosted, ให้ความสำคัญกับความเป็นส่วนตัว |
- OpenRouter (recommended)
- Google Translate
OpenRouter ให้บริการ API แบบรวมศูนย์สำหรับโมเดล LLM กว่า 200 รายการ มีฟรีเทียร์ให้ใช้งาน
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
หรือเพิ่มลงใน .env.local:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
เหมาะสำหรับ: โปรเจกต์ที่มีเนื้อหาจำนวนมาก, การแปล Markdown และโปรเจกต์ที่ต้องการการป้องกันเนื้อหา (code block, shortcode, ตัวแปร interpolation)
export GOOGLE_TRANSLATE_API_KEY=...
เหมาะสำหรับ: คู่ string แบบ key-value ปริมาณสูง (130+ ภาษา) ไม่แนะนำ สำหรับเนื้อหา Markdown — Google Translate ไม่รับรู้ code block, shortcode หรือตัวแปร interpolation
:::tip การตรวจจับอัตโนมัติ
หากตั้งค่าเฉพาะ GOOGLE_TRANSLATE_API_KEY (ไม่มี OpenRouter key) champollion จะสลับไปใช้ Google Translate โดยอัตโนมัติ โดยไม่ต้องเปลี่ยนการตั้งค่าใดๆ
:::
ตรวจสอบการติดตั้ง
npx champollion --help
คุณควรเห็นรายการคำสั่งที่ใช้งานได้ ตอนนี้คุณพร้อมสำหรับการเริ่มต้นอย่างรวดเร็วแล้ว