Verbinde deine Engine

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:

bash

lingo link

Wä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

bash

lingo login

Öffnet einen Browser zur Authentifizierung und speichert eine Sitzung. Für CI oder nicht-interaktive Nutzung übergib stattdessen einen API-Schlüssel:

bash

lingo login --api-key lk_...

…oder setze ihn als Umgebungsvariable:

bash

export LINGO_API_KEY="lk_..."

Erstelle einen API-Schlüssel auf der Seite API Keys im Dashboard.

Push

bash

lingo push

Die 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)