Installation
Prérequis
- Node.js 20.11+ (ESM natif)
- Une clé d'API de traduction (voir ci-dessous)
Installer
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev champollion
npx champollion sync
pnpm add -D champollion
yarn add --dev champollion
Obtenir une clé d'API
Champollion nécessite un moteur de traduction. Choisissez l'un des suivants :
| Fournisseur | Variable d'environnement | Idéal pour |
|---|---|---|
| OpenRouter (recommandé) | OPENROUTER_API_KEY | Projets riches en contenu, Markdown, 200+ modèles |
| Gemini (accès gratuit) | GEMINI_API_KEY | Démarrage sans frais, bonne qualité |
| OpenAI | OPENAI_API_KEY | Accès direct à GPT-4o |
| Anthropic | ANTHROPIC_API_KEY | Accès direct à Claude, texte nuancé |
| DeepL | DEEPL_API_KEY | Langues européennes, formalité intégrée |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Paires clé-valeur à haut volume, 130+ langues |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure, 100+ langues |
| LibreTranslate | LIBRETRANSLATE_API_URL | Auto-hébergé, confidentialité d'abord |
- OpenRouter (recommended)
- Google Translate
OpenRouter fournit une API unifiée pour 200+ modèles LLM. Accès gratuit disponible.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
Ou ajoutez à .env.local :
OPENROUTER_API_KEY=sk-or-v1-your-key-here
Idéal pour : projets riches en contenu, traduction Markdown, et projets nécessitant une protection du contenu (blocs de code, shortcodes, variables d'interpolation).
export GOOGLE_TRANSLATE_API_KEY=...
Idéal pour : paires de chaînes clé-valeur à haut volume (130+ langues). Non recommandé pour le contenu Markdown — Google Translate n'a pas de conscience des blocs de code, shortcodes ou variables d'interpolation.
:::tip Détection intelligente
Si seul GOOGLE_TRANSLATE_API_KEY est défini (pas de clé OpenRouter), champollion bascule automatiquement vers Google Translate. Aucune modification de configuration nécessaire.
:::
Vérifier l'installation
npx champollion --help
Vous devriez voir la liste des commandes disponibles. Vous êtes prêt pour le Démarrage rapide.