Installiere die Lingo.dev CLI, konfiguriere dein Projekt und generiere deine ersten Übersetzungen.
Voraussetzungen
Node.js 18 oder höher ist erforderlich. Führe node -v aus, um deine Version zu prüfen.
Schritt 1. Projekt initialisieren#
Wechsle in dein Projekt
cd your-project-directoryFühre den Init-Befehl aus
npx lingo.dev@latest initWindows-Nutzer: Wenn npx lingo.dev nicht funktioniert, installiere das Paket zuerst mit npm install lingo.dev@latest und verwende anschließend npx lingo.
Folge den Anweisungen. Die CLI erstellt im Stammverzeichnis deines Projekts eine i18n.json-Konfigurationsdatei.
Schritt 2. Einen Bucket konfigurieren#
Konfiguriere in i18n.json mindestens einen Bucket – also ein Dateiformat zusammen mit Include-Mustern, die der CLI sagen, wo übersetzbare Inhalte liegen:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}Der Platzhalter [locale] wird zur Laufzeit in deine konfigurierten Sprachcodes aufgelöst – locales/en.json für die Quellsprache, locales/es.json für Spanisch und so weiter.
Die vollständige Liste aller unterstützten Dateiformate und ihrer Bucket-Konfigurationen findest du unter Supported Formats.
Schritt 3. Ein Übersetzungs-Backend verbinden#
Die CLI benötigt ein Übersetzungs-Backend, um Übersetzungen zu generieren. Dafür gibt es zwei Optionen:
Eine Lokalisierungs-Engine auf Lingo.dev wendet automatisch Markenstimme, Glossar, Anweisungen und Modellkonfiguration auf jede Übersetzungsanfrage an.
Erstelle ein Konto und generiere auf der Seite API Keys einen API-Schlüssel.
Lege den API-Schlüssel als Umgebungsvariable fest:
export LINGO_API_KEY="your-api-key"Es ist keine zusätzliche Konfiguration nötig – die CLI verwendet die Standard-Lokalisierungs-Engine deiner Organisation. Wenn du gezielt eine bestimmte Engine ansprechen möchtest, füge engineId zu deiner i18n.json hinzu:
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Schritt 4. Übersetzungen generieren#
npx lingo.dev@latest runDie CLI erkennt deine Quelldateien, extrahiert übersetzbare Inhalte, sendet sie an dein konfiguriertes Übersetzungs-Backend und schreibt die Ergebnisse zurück auf die Festplatte. Dabei wird eine i18n.lock-Datei erstellt, die nachverfolgt, was bereits übersetzt wurde – committe sie zusammen mit deinen Sprachdateien.
