lingo push

Quelländerungen übermitteln, fehlende Zieldateien ergänzen oder ausgewählte Übersetzungen gezielt aktualisieren.

Nach der Einrichtung der ersten Datei verwendest du lingo push --wait für reguläre Änderungen am Quelltext. Die CLI vergleicht die Bytes der Quelle mit ihrem Referenzstand, fordert die Übersetzung der Änderungen an und lädt fertige Zieldateien herunter. Quellen mit identischen Bytes werden übersprungen.

Die anderen Modi sind für unterschiedliche Aufgaben gedacht. Wähle sie danach aus, was sich ändern soll, statt jeden Push als vollständige Übersetzung zu behandeln.

Aufgabe auswählen #

AufrufVerhalten
Einfacher Push ohne gültigen ReferenzstandSpeichert die Bytes der Quelle; fordert nicht automatisch eine erste Übersetzung an.
Einfacher Push mit ReferenzstandÜbersetzt Quelländerungen inkrementell.
lingo push 'locales/en.json'Plant für den ausgewählten Umfang, ohne den üblichen Vergleich mit dem vorherigen Quellstand; vorhandene Zieldateien können übernommen werden.
lingo push --backfill-missingErstellt fehlende Zieldateien für die konfigurierten Quellen.
Push mit eingeschränktem Umfang und --forceErzeugt ausgewählte Ziele in separaten Dateien neu, ohne den vorhandenen Zielkontext beizubehalten.
Push mit --keyWählt Einheiten mit stabilen Schlüsseln in vorhandenen Zieldateien aus; ob unveränderte Werte wiederverwendet werden, hängt vom Format ab.

Das Auffüllen ergänzt keine neuen oder geänderten Schlüssel in einer bereits vorhandenen regulären Zieldatei. Es warnt vor Quelländerungen seit dem Referenzstand. Schließe diese regulären Aktualisierungen vor dem Auffüllen mit einem einfachen Push ab, damit vorhandene Sprachen aktuell bleiben. Ein Dokument, das nur einen Teil der konfigurierten Sprachen abdeckt, behält den vorhandenen Quellreferenzstand bei. So kann ein späterer regulärer Push ausstehende Änderungen für die übrigen Sprachen weiterhin verarbeiten. Gemeinsame XCStrings-Kataloge verwenden eine Planung pro Sprache. Dateimuster als Positionsargumente wählen nur Dateien aus, die auch in der Konfiguration enthalten sind, statt beliebige Dateien zuzulassen.

Optionen #

OptionWirkung
Dateimuster als PositionsargumenteWählt konfigurierte Dateien aus; setze Shell-Platzhalter in Anführungszeichen.
--force, -fErsetzt Übersetzungen ganzer Dateien; verwende explizite Dateimuster oder die Auffüllfunktion.
--backfill-missingLegt fehlende Zieldateien erstmalig an.
--key <pattern>Mehrfach verwendbare Auswahl von Einheiten mit stabilen Schlüsseln.
--yes, -yÜberspringt die Bestätigung für das erzwungene Ersetzen.
--wait, -wWartet und lädt Ergebnisse herunter, statt direkt nach der Übermittlung zurückzukehren.
--estimatePlant den Auftrag und ermittelt die Kosten, ohne zu übersetzen oder einen Job zu erstellen.
--with <stage>Eine Phase nur für diesen Push ausführen; mehrfach verwendbar.
--without <stage>Eine Phase nur für diesen Push überspringen; mehrfach verwendbar.
--review-*, --content-lengthPhaseneinstellungen nur für diesen Push anpassen.

Boolesche Flags sind standardmäßig auf false gesetzt. Die Ziele stammen aus der Konfiguration; push hat kein Flag für die Sprache. Das erzwungene Ersetzen ganzer Dateien erfordert eine Bestätigung, sofern yes, eine Schlüsselauswahl oder estimate diese nicht unterdrückt. Ohne Dateimuster als Positionsargumente wählt --force jede konfigurierte Quelldatei und Zielsprache aus. Verwende explizite Dateimuster und sieh dir den Umfang mit --estimate an, bevor du umfangreiche Ersetzungen vornimmst. Das erzwungene Ersetzen kann manuelle Änderungen an Zieldateien überschreiben, weil es bei Formaten mit separaten Dateien den aktuellen Zielkontext entfernt. XCStrings-Kataloge und CSV-Tabellen können weiterhin Übersetzungen wiederverwenden, die in der gemeinsamen Quelldatei eingebettet sind.

Ausgewählte Schlüssel aktualisieren #

Aktualisiere gezielt einzelne Schlüssel, wenn sich gespeicherte Vorgaben geändert haben, der Quelltext aber unverändert ist, oder wenn eine bekannte Teilmenge neu übersetzt werden muss:

sh
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --wait

Schlüssel sind Pfade in Punkt- und Klammerschreibweise. Die Auswahl eines Objekts umfasst alle darunterliegenden Zeichenfolgen: auth.login schließt auth.login.title ein, aber nicht auth.login_url. * steht für genau ein vollständiges Segment. Die Schrägstrichschreibweise der früheren CLI, etwa auth/login, funktioniert ebenfalls. JSON, JSONC, TypeScript und PHP erzeugen ausgewählte Zeichenfolgen neu, auch wenn ihre Quelle unverändert ist. YAML und YAML mit Schlüsseln auf oberster Ebene unterstützen die Schlüsselauswahl, können aber aktuelle Zielwerte wiederverwenden, wenn ihre Quelle dem gespeicherten Referenzstand entspricht. Für eine Formulierungskorrektur in YAML bearbeitest du das Ziel direkt. Für eine umfassendere Neuerzeugung nach Änderungen an den Vorgaben sicherst du die akzeptierten Zieldateien und verwendest --force für die gesamte Datei ohne --key.

Fehlende Zielsprachen und Formate ohne stabile Schlüssel werden mit entsprechenden Meldungen übersprungen; andere Formate brechen den Push mit einem Fehler ab. Lege fehlende Zieldateien separat an. Wenn du --force zu --key hinzufügst, bleibt die schlüsselbasierte Planung unverändert und YAML kann Werte weiterhin wiederverwenden.

Ein auf Schlüssel beschränkter Push lässt den Referenzstand der gesamten Quelle unverändert, unabhängig davon, ob push --wait oder ein späteres pull die Ergebnisse abholt. Ausstehende reguläre Quelländerungen werden daher weiterhin beim nächsten einfachen Push berücksichtigt. Umfang erläutert die Formatmatrix und die Schlüsselgrammatik.

Vor umfangreichen Ersetzungen die Kosten schätzen #

sh
lingo push 'locales/en.json' --force --estimate

Die Schätzung plant exakt die anstehenden Änderungen, ohne zu übersetzen oder einen Job zu erstellen. Sie lädt die Dateien hoch, die dem Server für diesen Plan fehlen. Es handelt sich also um einen Aufruf des Dienstes, nicht um einen Offline-Testlauf. Sie ersetzt weder den gespeicherten Pull-Verweis noch den abgeschlossenen Referenzstand. Ein erster Push speichert nur Quellen; seine Schätzung meldet daher, dass es nichts zu schätzen gibt, und verweist auf lingo push --estimate --backfill-missing.

Die Ausgabe zeigt die geplanten Kosten, die neu zu erstellenden und wiederzuverwendenden Übersetzungen, Ausgabe-Tokens und Zeilen pro Sprache. Eventuelle Kosten für nachfolgende Korrekturen und Ausgaben, die dein eigener KI-Anbieter abrechnet, erscheinen in separaten Zeilen und sind nicht in der geplanten Gesamtsumme enthalten. Anschließend weisen Warnungen darauf hin, was die Schätzung nicht berücksichtigt. Mit ~ markierte Beträge sind Näherungswerte. Sie beschreiben den Plan, nicht die gemessene Nutzung, und stellen kein Angebot dar. Ist ein Push zu groß für eine Schätzung, schlägt er mit der vom Server angegebenen Begründung fehl; übergib Dateimuster, um einen Teil davon zu schätzen.

Phasen für einen einzelnen Push ändern #

bash
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-edit

Phasen-Flags ändern die Pipeline der Engine nur für diesen Push. So kannst du eine Konfiguration ausprobieren, ohne die Engine zu bearbeiten oder neu zu erstellen. Alle Einstellungen, die du nicht per Flag angibst, werden von der Engine übernommen, einschließlich ihrer Pools für die Prüfung durch Menschen.

--with und --without akzeptieren pre-edit, rephrase, human-review, post-edit, content-length oder back-translation. Die Übersetzung wird immer ausgeführt. --without überspringt auch alle Phasen, die von der übersprungenen Phase abhängen: --without human-review überspringt die KI-Bewertung und die Nachbearbeitung.

EinstellungWerte
--review-leveleverything leitet jede Einheit an Bewerter weiter; strict, medium oder lax leitet nur Einheiten weiter, die bei der KI-Bewertung mit dem jeweiligen Schweregrad markiert werden.
--review-pool <name>Für Prüfungen wird dieser Pool statt der Pools der Engine verwendet.
--review-languages <locales>Kommagetrennte Liste der Sprachen, für die der Pool --review-pool Prüfungen durchführt; standardmäßig alle Sprachen.
--review-timeout <hours>Die Anzahl der Stunden, die Bewertern zur Verfügung stehen.
--content-length <rule>source, match:<percent> oder max:<columns>.

Eine Einstellung passt eine Phase an, aktiviert sie aber nicht. Der Push schlägt deshalb fehl, wenn die Phase nicht ausgeführt wird: Füge --with human-review oder --with content-length hinzu. Bei einer Engine ohne Pools für die Prüfung erfordert --with human-review die Angabe von --review-pool. Wenn du eine Phase anforderst, die dein Tarif nicht umfasst, schlägt der Push fehl, statt die Phase zu überspringen. Der Push schreibt seine Ergebnisse wie jeder andere Push; füge --force oder --key hinzu, damit auch unveränderte Einheiten erneut übersetzt werden, und --estimate, um vorab die Kosten der Konfiguration zu ermitteln. Bei einem erneuten Versuch musst du dieselben Phasen-Flags angeben.

Schließe vor dem Hinzufügen einer neuen Sprache zunächst die regulären Quellaktualisierungen für vorhandene Ziele ab. Füge die neue Sprache dann zu targetLocales hinzu, sieh dir lingo push --backfill-missing --estimate an und fordere das Auffüllen an, ohne die Quellrevision zu ändern. Eine Sprache hinzufügen führt diesen Ablauf bis zu den Anwendungstests fort. Das Entfernen einer Sprache schließt sie von künftigen Auswahlen aus, ohne Dateien zu löschen. Verwende die Bereinigungsfunktion für Sprachen nicht bei gemeinsamen XCStrings-Katalogen.

Ergebnisse abholen und Fehler beheben #

Ohne wait behältst du den checkout und den lokal auf dem Rechner gespeicherten Verweis bei, bis pull die Ausgabe abruft. Ein weiterer Push kann diesen Verweis ersetzen. Mit wait siehst du dir fehlgeschlagene oder teilweise fehlgeschlagene Ergebnisse sowie die tatsächlich heruntergeladenen Dateien an. Das Warten endet, sobald jedes noch nicht abgeschlossene Ziel auf eine menschliche Prüfung wartet; führe pull aus, nachdem die Prüfer fertig sind. Bearbeite keine Zieldateien, während wait die Ergebnisse direkt abholt: Dabei fehlt der erneute Vergleich mit lokalen Änderungen, den pull durchführt.

Um fehlgeschlagene Aufträge erneut auszuführen, behebst du die Ursache und folgst dem Verfahren zur Wiederherstellung fehlgeschlagener Ausführungen: Wiederhole den passenden Push unter Beibehaltung des Zustands, bestätige die ausgegebene Job-ID und sieh dir anschließend die Ausgabe an. Wenn die Ergebnisse des früheren Push noch nicht abgeholt wurden und die Anfrage unverändert ist, verwendet push diese Anfrage erneut, statt sie zu duplizieren: Die Verbindung zu einem laufenden Job wird wiederhergestellt, die Ergebnisse eines abgeschlossenen Jobs werden abgeholt und ein fehlgeschlagener Job wird durch einen neuen ersetzt.