Installation
Voraussetzungen
- Node.js 20.11+ (natives ESM)
- Ein Übersetzungs-API-Schlüssel (siehe unten)
Installieren
- 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-Schlüssel beziehen
Rosetta benötigt ein Übersetzungs-Backend. Wählen Sie eines aus:
| Anbieter | Umgebungsvariable | Am besten geeignet für |
|---|---|---|
| OpenRouter (empfohlen) | OPENROUTER_API_KEY | Inhaltsreiche Projekte, Markdown, 200+ Modelle |
| Gemini (kostenloser Tarif) | GEMINI_API_KEY | Kostenloser Einstieg, gute Qualität |
| OpenAI | OPENAI_API_KEY | Direkter GPT-4o-Zugriff |
| Anthropic | ANTHROPIC_API_KEY | Direkter Claude-Zugriff, nuancierte Texte |
| DeepL | DEEPL_API_KEY | Europäische Sprachen, integrierte Formalität |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Große Mengen an Schlüssel-Wert-Paaren, 130+ Sprachen |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure, 100+ Sprachen |
| LibreTranslate | LIBRETRANSLATE_API_URL | Selbstgehostet, Datenschutz im Vordergrund |
- OpenRouter (recommended)
- Google Translate
OpenRouter bietet eine einheitliche API für über 200 LLM-Modelle. Ein kostenloser Tarif ist verfügbar.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
Oder fügen Sie dies zu .env.local hinzu:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
Am besten geeignet für: inhaltsreiche Projekte, Markdown-Übersetzungen und Projekte, die einen inhaltsbezogenen Schutz benötigen (Codeblöcke, Shortcodes, Interpolationsvariablen).
export GOOGLE_TRANSLATE_API_KEY=...
Am besten geeignet für: große Mengen an Schlüssel-Wert-Zeichenfolgenpaaren (130+ Sprachen). Nicht empfohlen für Markdown-Inhalte — Google Translate erkennt keine Codeblöcke, Shortcodes oder Interpolationsvariablen.
:::tip Intelligente Erkennung
Wenn nur GOOGLE_TRANSLATE_API_KEY festgelegt ist (kein OpenRouter-Schlüssel), wechselt rosetta automatisch zu Google Translate. Es ist keine Konfigurationsänderung erforderlich.
:::
Installation überprüfen
npx i18n-rosetta --help
Sie sollten die Liste der verfügbaren Befehle sehen. Sie sind bereit für den Schnellstart.