Die Lingo.dev CLI verbindet deine Codebasis über deine Projektkonfiguration mit einer Lokalisierungs-Engine. Jede lingo push läuft über deine Engine, die dabei automatisch deine Markenstimme, dein Glossar, deine Regeln und deine Modellkonfiguration anwendet. Keine Codeänderungen, keine neuen Abhängigkeiten.
Was sich ändert#
| Vorher | Nachher | |
|---|---|---|
| Übersetzungspipeline | Standard-Pipeline von Lingo.dev | Deine Lokalisierungs-Engine |
| Markenstimme | Keine | Wird pro Zielsprache angewendet |
| Glossar | Keines | Wird pro Anfrage semantisch abgeglichen |
| Regeln | Keine | Pro Zielsprache enthalten |
| Modellauswahl | Lingo.dev-Standard | Deine Modellkonfiguration mit Fallbacks |
| Qualitätsprüfung | Keine | Deine konfigurierten KI-Bewerter laufen automatisch |
Einrichtung#
Mit deiner Engine verknüpfen
Führe lingo link im Stammverzeichnis deines Projekts aus:
lingo linkWähle eine Organisation und eine Lokalisierungs-Engine aus (oder erstelle sie). link schreibt orgId und engineId in .lingo/config.json — committe die Datei, damit bei jedem Durchlauf dieselbe Engine verwendet wird. Die ID einer Engine findest du auch im Dashboard; sie beginnt mit eng_ (z. B. eng_SxjMwMsfOIsvV1wh).
Authentifizieren
lingo loginÖffnet einen Browser zur Authentifizierung und speichert eine Sitzung. Für CI oder nicht-interaktive Nutzung übergib stattdessen einen API-Schlüssel:
lingo login --api-key lk_...…oder setze ihn als Umgebungsvariable:
export LINGO_API_KEY="lk_..."Erstelle einen API-Schlüssel auf der Seite API Keys im Dashboard.
Push
lingo pushDie CLI sendet Quelldateien an deine Engine und schreibt die übersetzten Ergebnisse zurück auf die Festplatte – dabei werden deine Markenstimme, dein Glossar, deine Regeln und deine Modellkonfiguration automatisch angewendet.
Konfigurationsreferenz#
.lingo/config.json#
| Feld | Beschreibung |
|---|---|
orgId | Organisation, der die Engine gehört. Wird von lingo link gesetzt. |
engineId | Engine, die die Übersetzung ausführt (eng_...). Wird von lingo link gesetzt. |
sourceLocale, targetLocales und files funktionieren genauso wie in jedem anderen Projekt — siehe Konfiguration.
Umgebungsvariablen#
| Variable | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
LINGO_API_KEY | Für CI | - | Dein Lingo.dev API-Schlüssel (anstelle von lingo login) |
LINGO_API_URL | Nein | https://api.lingo.dev | Benutzerdefinierte API-Basis-URL (für Self-Hosting oder Staging) |
Was dich erwartet#
Jede Übersetzung, die die CLI erzeugt, durchläuft die vollständige Pipeline deiner Engine:
- Markenstimme steuert Ton und Formalität pro Sprache
- Glossareinträge sichern exakte Terminologie durch semantisches Matching
- Regeln wenden sprachspezifische Regeln für das jeweilige Gebietsschema an
- Modellkonfigurationen wählen das passende LLM mit automatischen Fallbacks aus
- KI-Bewerter bewerten die Qualität nach jeder Anfrage automatisch
Übersetzungen erscheinen in Reports mit dem Trigger-Typ api, zusammen mit Anfragen aus der API und Integrationen.
