Pag-install
Mga Kinakailangan
- Node.js 20.11+ (native ESM)
- Isang translation API key (tingnan sa ibaba)
I-install
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev champollion
npx champollion sync
pnpm add -D champollion
yarn add --dev champollion
Kumuha ng API Key
Kailangan ng Champollion ng translation backend. Pumili po ng isa:
| Provider | Environment Variable | Pinakamainam Para Sa |
|---|---|---|
| OpenRouter (inirerekomenda) | OPENROUTER_API_KEY | Mga proyektong maraming content, Markdown, 200+ models |
| Gemini (free tier) | GEMINI_API_KEY | Pagsisimulang walang gastos, magandang kalidad |
| OpenAI | OPENAI_API_KEY | Direktang GPT-4o access |
| Anthropic | ANTHROPIC_API_KEY | Direktang Claude access, tekstong may mas pinong pagpapakahulugan |
| DeepL | DEEPL_API_KEY | Mga wikang European, built-in na pormalidad |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Mataas na volume ng key-value pairs, 130+ languages |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure, 100+ languages |
| LibreTranslate | LIBRETRANSLATE_API_URL | Self-hosted, inuuna ang privacy |
- OpenRouter (recommended)
- Google Translate
Nagbibigay ang OpenRouter ng unified API para sa 200+ LLM models. May available na free tier.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
O idagdag sa .env.local:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
Pinakamainam para sa: mga proyektong maraming content, pagsasalin ng Markdown, at mga proyektong nangangailangan ng content-aware shielding (code blocks, shortcodes, interpolation variables).
export GOOGLE_TRANSLATE_API_KEY=...
Pinakamainam para sa: mataas na volume ng key-value string pairs (130+ languages). Hindi inirerekomenda para sa Markdown content — walang awareness ang Google Translate sa code blocks, shortcodes, o interpolation variables.
:::tip Smart detection
Kung GOOGLE_TRANSLATE_API_KEY lamang ang naka-set (walang OpenRouter key), awtomatikong lilipat ang champollion sa Google Translate. Walang kailangang baguhin sa config.
:::
I-verify ang Pag-install
npx champollion --help
Dapat ninyong makita ang listahan ng mga available na command. Handa na po kayo para sa Quick Start.