Kontinuierliche Lokalisierung

Lingo.dev hält Übersetzungen mit Ihrem Code synchron. Bei jeder Änderung erkennt es, welche Inhalte angepasst wurden, übersetzt sie mit Ihrer verbundenen Lokalisierungs-Engine – inklusive Glossarregeln, Markenstimme und sprachspezifischer Modellkonfiguration, die konsequent angewendet werden – und committet die Ergebnisse oder eröffnet einen Pull Request. Unvollständige Übersetzungen gelangen nie in die Produktion.

Wählen Sie Ihre Integration#

Für jede Integration gibt es eine eigene Anleitung. Wählen Sie die Variante, die zu Ihrem Setup passt:

Die GitHub App läuft auf den Servern von Lingo.dev. Alle anderen Integrationen führen die Lingo.dev CLI aus – damit kann jede CI/CD-Umgebung mit Node.js 22+ die Lokalisierung direkt ausführen, auch ohne native Integration.

So funktioniert die GitHub App#

Installieren Sie die App einmal und fügen Sie dem Repository eine .lingo/config.json hinzu. Danach übernimmt Lingo.dev die Lokalisierung für Sie – ohne Pipeline, ohne API-Key-Secret, ohne Lockfile:

1. Überwacht Änderungen – reagiert standardmäßig auf Pushes in den Standard-Branch und, sobald Sie onPullRequest aktivieren, auch auf Pull Requests, und prüft geänderte Dateien anhand der von Ihnen konfigurierten Quellmuster
2. Übersetzt das Delta – leitet geänderte Quellinhalte durch die Engine, die mit engineId angegeben ist
3. Schreibt Ergebnisse nach GitHub zurück – bei Pushes auf den Standard-Branch eröffnet oder aktualisiert sie einen Übersetzungs-Pull-Request; bei Pull Requests committet sie übersetzte Dateien in den PR-Branch und hinterlässt einen Statuskommentar
4. Holt Versäumtes nach und bündelt Änderungen – erkennt Änderungen, die in einem früheren Lauf übersehen wurden, und verteilt sehr große Updates auf mehrere Commits

Sie können Läufe durch einen Freigabeschritt absichern oder Übersetzungen per /lingo-Befehl in einem Pull Request manuell auslösen. Die vollständige Konfiguration finden Sie im Leitfaden zur GitHub App.

So funktionieren die CLI-Integrationen#

Die Integrationen für GitHub Actions, GitLab CI/CD und Bitbucket führen alle dieselbe Lingo.dev CLI als Schritt in Ihrer bestehenden Pipeline aus. Dafür brauchen sie zwei Dinge: Ihre .lingo/config.json-Konfiguration und ein LINGO_API_KEY zur Authentifizierung.

Bei jedem Lauf installiert der Job die CLI (npm install -g @lingo.dev/cli) und führt lingo push aus. Das bewirkt:

1. Ermittelt Quelldateien – liest Ihre Bucket-Konfiguration, um übersetzbare Inhalte zu finden
2. Erkennt Änderungen – vergleicht mit der .lingo/lock.json-Lockdatei, um neue oder geänderte Strings zu identifizieren, sodass nur die Differenz übersetzt wird
3. Übersetzt – leitet geänderte Inhalte durch Ihre konfigurierte Lokalisierungs-Engine, wobei alle Regeln angewendet werden – Glossar, Markenstimme, sprachspezifische Modelleinstellungen
4. Schreibt Ergebnisse – aktualisiert die Zieldateien für die Sprache direkt und erneuert .lingo/lock.json

Anschließend committet Ihre Pipeline die Ergebnisse oder öffnet mit den nativen Tools Ihrer Plattform einen Pull Request. Da nur geänderte Strings übersetzt werden, sind die Läufe schnell und kosteneffizient – selbst bei Dutzenden von Sprachen.

Workflow-Optionen#

GitHub App#

Das Verhalten der App wird in .lingo/config.json konfiguriert:

Die vollständige Konfiguration und Befehlsreferenz finden Sie im Leitfaden zur GitHub App.

CLI in CI/CD (GitHub Actions, GitLab CI, Bitbucket)#

Vier Workflow-Muster decken die meisten Team-Setups ab:

Die erste Option – Commit in main – ist die einfachste. Übersetzungen erscheinen automatisch, ganz ohne Eingriff durch Entwickler. Die PR-basierten Optionen ergänzen einen Prüfungsschritt, bevor Übersetzungen übernommen werden.

Mehr dazu, wie Sie zwischen diesen Optionen wählen, finden Sie unter Advanced Patterns.

Nächste Schritte#