Übersetze deine erste Datei

Erstelle einen Quellkatalog, rufe deutsche und französische Zieldateien ab und übersetze eine spätere Änderung am Quelltext.

Diese Anleitung begleitet dich von der Einrichtung über die Übersetzung bis zum Abruf einer englischen JSON-Datei. Am Ende liegen die Zieldateien auf deinem Datenträger vor, und du hast eine Ausgangsbasis für spätere Änderungen. Soll ein Coding-Agent die Einrichtung übernehmen, lies Einrichtung mit einem Coding-Agenten.

Verwende ein kleines Projektverzeichnis mit Zugriff auf Node.js und npm. Du brauchst außerdem ein Lingo.dev-Konto und die Berechtigung, mit einer aktivierten Lokalisierungs-Engine zu übersetzen. Dein Kontokontingent muss für die Arbeit ausreichen.

Installieren und anmelden #

sh
npm install --global @lingo.dev/cli
lingo --version
lingo login

Bei der Anmeldung öffnet sich der Browser. Für einen nichtinteraktiven Runner stellst du LINGO_API_KEY stattdessen über dessen Secret-Speicher bereit. Ein Schlüssel aus der Umgebung hat Vorrang vor der gespeicherten Anmeldung. Entferne daher einen unbeabsichtigt gesetzten Umgebungsschlüssel, bevor du dich als eine andere Person anmeldest.

Quelldatei erstellen #

Erstelle das Verzeichnis locales und speichere Folgendes als locales/en.json:

json
{
  "checkout": {
    "title": "Review your order",
    "submit": "Place order"
  }
}

Führe im Projektstammverzeichnis Folgendes aus:

sh
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo link

init schreibt .lingo/config.json und fügt AGENTS.md einen Lingo.dev-Block hinzu, damit Coding-Agenten wissen, dass sie die Agenten-Anleitungen der CLI lesen sollen; übergib --no-agents-md, um diesen Schritt zu überspringen. Mit link kannst du die Organisation und die Lokalisierungs-Engine auswählen oder erstellen, sofern deine Zugriffsrechte das erlauben. Eine Lokalisierungs-Engine stellt die Modelle und sprachlichen Vorgaben bereit. Ihre ID wird in der Projektkonfiguration gespeichert, deine Zugangsdaten bleiben davon getrennt.

Öffne die Konfiguration, bevor du fortfährst. Sie sollte en als Quellsprache, de und fr als Zielsprachen und locales/en.json als Quelldatei angeben. Kontrolliere auch die IDs der Organisation und der Lokalisierungs-Engine, insbesondere bei einem kopierten Projekt oder Fork.

Übersetzen und abrufen #

sh
lingo push --backfill-missing --wait

Backfill fordert fehlende Zieldateien an. --wait wartet und lädt die fertigen Ergebnisse herunter. Ein einfacher erster Push ohne Lockfile speichert dagegen zunächst die Quelldaten, statt diese erste Übersetzung anzufordern.

Lass die Zieldateien unverändert, während der Befehl wartet: Bei diesem direkten Abruf erfolgt kein erneuter Konfliktabgleich mit lokalen Änderungen, wie ihn der separate Pull-Befehl durchführt. Wenn der Lauf auf eine Prüfung wartet oder Fehler meldet, sieh dir diesen Status an, bevor du den Lauf als abgeschlossen betrachtest.

Öffne locales/de.json und locales/fr.json. Stelle sicher, dass beide checkout-Schlüssel weiterhin vorhanden sind, und lies die übersetzten Werte. Wenn du eine Zielsprache nicht beurteilen kannst, ziehe einen qualifizierten Prüfer hinzu oder nutze eine geeignete Messung. Lade die Dateien bei der Integration in eine Anwendung auch über deren regulären Ressourcenlader.

Führe eine Prüfung von .lingo/lock.json zusammen mit dem Diff der Quell- und Zieldateien durch. Erstelle einen gemeinsamen Commit mit den akzeptierten Dateien, der Konfiguration und dem Referenzstand. Ohne --wait führst du später lingo pull im selben checkout und auf demselben Rechner aus, um die Ergebnisse des zuletzt lokal aufgezeichneten Laufs abzurufen.

Quelldatei aktualisieren #

Ändere einen Wert in locales/en.json oder füge einen Schlüssel hinzu und führe dann Folgendes aus:

sh
lingo push --wait

Die reguläre Aktualisierung vergleicht Änderungen an der Quelle mit dem gespeicherten Referenzstand. Backfill ist für fehlende Dateien gedacht, nicht für neue Schlüssel in einer bereits vorhandenen Zieldatei.

Für andere Ressourcentypen oder Strukturen nutze Konfiguration und Formate. Für YAML und Android XML musst du das Format ausdrücklich auswählen. Für die Extraktion von Aufrufen aus React-Quellcode fahre mit dem React-Schnellstart fort. Wähle dessen JSONC-Katalog in der Konfiguration aus, statt davon auszugehen, dass diese JSON-Beispieldatei ihn auswählt.