CLI
Übersetze Projektdateien, rufe die Ergebnisse ab und pflege die Quellkataloge für React-Anwendungen.
Die Lingo.dev CLI verbindet Dateien in deinem Projekt mit einer Lokalisierungs-Engine. Du legst Quellpfade und Zielsprachen fest, sendest die ausgewählten Inhalte und rufst die übersetzten Dateien ab. Bei späteren Ausführungen werden Änderungen anhand des gespeicherten Ausgangsstands der Quelldaten verarbeitet.
@lingo.dev/cli installiert die ausführbare Datei lingo. Starte mit deiner ersten Datei: Dort findest du den vollständigen Ablauf von der Einrichtung bis zum Abruf der Ergebnisse.
Installiere die aktuelle Version von @lingo.dev/cli und halte mit lingo --version fest, welche Version dein Projekt verwendet. Für lingo.dev@0.138.10 und die zugehörigen i18n.json-Projekte nutze die Referenz zu CLI v0.
So installieren, wie du arbeitest #
Als Projektabhängigkeit, die in der Versionsverwaltung erfasst wird:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionAls ausführbare Datei, die überall in der Shell verfügbar ist:
npm install --global @lingo.dev/cli
lingo --helpDieses Handbuch verwendet lingo direkt. Bei einer lokalen Installation erfolgt der Aufruf über deinen Paketmanager. npx @lingo.dev/cli@latest und pnpm dlx @lingo.dev/cli@latest führen die neueste Version ohne dauerhafte Installation aus. Lege eine feste Version fest, wenn das Verhalten lokal und in der CI übereinstimmen muss; die CI-Beispiele verwenden Node.js 22.
lingo update nutzt die erkannte Installationsmethode. Verwende den Paketmanager, wenn du eine bestimmte Version benötigst, die Installation nicht erkannt wird oder nur temporär besteht.
Dateien übersetzen oder Meldungen extrahieren #
Für vorhandene Ressourcen konfigurierst du die Dateien, authentifizierst dich und verknüpfst eine Lokalisierungs-Engine. Die Übersetzung läuft auf dem Server. push --wait wartet auf die Ergebnisse und lädt sie herunter; mit den separaten Befehlen push und pull kannst du sie später abrufen.
Für Aufrufe im React-Quellcode erstellt die Extraktion lokal JSONC-Dateien und TypeScript-Deklarationen. Dabei werden weder Inhalte übersetzt noch eine Laufzeitumgebung installiert. Nimm den extrahierten Katalog zur Übersetzung in die Dateikonfiguration auf und lade ihn anschließend über den Katalog-Workflow von React.
Den nötigen Stand für Aktualisierungen bewahren #
Ein erster einfacher Push speichert die Quellbytes. Backfill erstellt fehlende Zieldateien; spätere einfache Pushes übersetzen Änderungen an den Quelldaten. Halte .lingo/config.json, .lingo/lock.json und akzeptierte Übersetzungen gemeinsam in der Versionsverwaltung. Zugangsdaten und der Verweis auf die letzte Ausführung bleiben in deinem Home-Verzeichnis.
Push, Pull und Lockfile und Cache erläutern die verfügbaren Modi und Wiederherstellungsoptionen. Unter Befehle findest du die Befehle für Einrichtung, Übersetzung und Katalogpflege.