การติดตั้ง
ข้อกำหนดเบื้องต้น
- Node.js 20.11+ (native ESM)
- API key สำหรับการแปลภาษา (ดูรายละเอียดด้านล่าง)
ติดตั้ง
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev i18n-rosetta
npx i18n-rosetta sync
pnpm add -D i18n-rosetta
yarn add --dev i18n-rosetta
รับ API Key
Rosetta จำเป็นต้องใช้ระบบเบื้องหลัง (backend) สำหรับการแปลภาษา โปรดเลือกหนึ่งรายการ:
| ผู้ให้บริการ | Environment Variable | เหมาะสำหรับ |
|---|---|---|
| OpenRouter (แนะนำ) | OPENROUTER_API_KEY | โปรเจกต์ที่มีเนื้อหาจำนวนมาก, Markdown, โมเดลมากกว่า 200+ รายการ |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | ข้อมูลแบบ key-value จำนวนมาก (รองรับ 130+ ภาษา) |
- 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 blocks, shortcodes, ตัวแปร interpolation)
export GOOGLE_TRANSLATE_API_KEY=...
เหมาะสำหรับ: ข้อมูลสตริงแบบ key-value จำนวนมาก (รองรับ 130+ ภาษา) ไม่แนะนำ สำหรับเนื้อหา Markdown — เนื่องจาก Google Translate ไม่สามารถรับรู้ถึง code blocks, shortcodes หรือตัวแปร interpolation ได้
:::tip การตรวจจับอัจฉริยะ
หากมีการตั้งค่าเพียง GOOGLE_TRANSLATE_API_KEY (ไม่มีคีย์ OpenRouter) rosetta จะสลับไปใช้ Google Translate โดยอัตโนมัติ คุณไม่จำเป็นต้องเปลี่ยนการตั้งค่าใดๆ
:::
ตรวจสอบการติดตั้ง
npx i18n-rosetta --help
คุณควรจะเห็นรายการคำสั่งที่สามารถใช้งานได้ ตอนนี้คุณพร้อมสำหรับ เริ่มต้นใช้งานด่วน แล้ว