Ausgewählte Inhalte mit CLI v0 neu übersetzen
Aktualisiere ältere Übersetzungen nach Änderungen an Quellinhalten oder Vorgaben, grenze den Umfang gezielt ein und schütze akzeptierte Bearbeitungen.
Verwende einen regulären Durchlauf, wenn sich die Quellinhalte ändern. Erzwinge eine Neuübersetzung, wenn die Quelle unverändert bleibt, die Übersetzung aber neue Anweisungen berücksichtigen oder einen unbefriedigenden Wert ersetzen soll. Beide Varianten können gewöhnliche manuelle Bearbeitungen überschreiben.
Quelländerungen bestimmen den Umfang regulärer Durchläufe #
lingo run| Zustand von Quelle und Ziel | Ergebnis eines regulären v0-Durchlaufs |
|---|---|
| Der Quellwert hat sich gegenüber seiner bisherigen Prüfsumme geändert | Den geänderten Wert übersetzen. |
| Ein Quellschlüssel fehlt im Ziel | Den fehlenden Inhalt übersetzen. |
| Ein Quellschlüssel wurde entfernt | Den zugehörigen verwalteten Zieleintrag entfernen. |
| Ein neuer Schlüssel hat dieselbe Quellwert-Prüfsumme wie ein entfernter Schlüssel | Die Übersetzung innerhalb des verarbeiteten Kontexts wiederverwenden. |
| Ziel vorhanden, Quelle unverändert | Den Zielwert beibehalten. |
Eine gewöhnliche manuelle Korrektur bleibt bei unveränderter Quelle erhalten, aber nicht bei jeder späteren Aktualisierung. Geschützte Schlüssel reservieren einen separaten Wert, der unter menschlicher Kontrolle bleibt.
Eine betroffene Übersetzung aktualisieren #
Beginne nach einer Änderung an einem Modell, Prompt, Glossar oder einer Regel mit der betroffenen Sprache und dem betroffenen Schlüssel:
lingo run --force --target-locale es --key welcome/titleHier spricht welcome/title den Schlüssel title innerhalb von welcome an. In 0.138.10 akzeptiert der run-Befehl exakte Schlüssel, Präfixe, die Schlüsselgrenzen berücksichtigen, und Glob-Muster. Setze --key 'welcome/**' in Anführungszeichen, um untergeordnete Einträge auszuwählen, ohne dass die Shell das Muster expandiert.
Sieh dir das übersetzte Ergebnis neben dem Quellinhalt an und lade es anschließend über die Anwendung. Ein auf bestimmte Sprachen oder Schlüssel begrenzter Durchlauf aktualisiert keine bestehende gemeinsame Ausgangsbasis. Befolge die Regeln zum Abgleich des Lockfile, damit ein späterer regulärer Durchlauf dieselbe Quelländerung nicht unerwartet erneut verarbeitet.
Den Umfang in großen Projekten überschaubar halten #
--target-locale, --bucket, --file und --key sind Selektoren, die du mehrfach angeben kannst. --source-locale ändert die Quelle für den Durchlauf. Gehe von den konfigurierten Buckets und Pfaden aus und grenze diese Auswahl ein, statt eine beliebige, nicht konfigurierte Datei anzugeben.
lingo run --target-locale es --bucket json --file 'apps/web/**'Der Dateiabgleich des run-Befehls unterstützt Teilzeichenfolgen und minimatch-Muster für die ermittelten konfigurierten Pfade. Der Dateiabgleich des purge-Befehls unterstützt nur Teilzeichenfolgen; auch der Schlüsselabgleich funktioniert dort anders. Übertrage Selektoren nicht von einem Befehl auf den anderen, ohne die ausgewählten Einträge zu kontrollieren.
Für eine gezielt umfassendere Aktualisierung:
lingo run --force --bucket json --target-locale esDamit lassen sich alle ausgewählten spanischen JSON-Inhalte neu erzeugen. lingo run --force ohne weitere Selektoren umfasst das konfigurierte Projekt. Sichere akzeptierte Ergebnisse, bevor du den Umfang erweiterst, und erstelle eine Schätzung für denselben erzwungenen Umfang, wenn du das Lingo.dev-Backend verwendest.
Bei großen Änderungen erleichtert eine getrennte Eingrenzung nach Dateien und Sprachen die Prüfung von Diffs. Behalte nach einem Fehler die erfolgreich erzeugten Teilergebnisse und wiederhole den betroffenen Teil, bevor du für alles eine Neuübersetzung erzwingst. Parallele Verarbeitung steuert den Durchsatz, nicht die Auswahl oder das Zurücksetzen.
Verwalte UI-Kataloge und Dokumente in eigenen Format-Buckets und schließe generierte Inhalte und Entwürfe aus. Verwende getrennte Paketkonfigurationen, wenn sich Ziele oder Lokalisierungs-Engines unterscheiden. In CI validiert lingo run --frozen eine vertrauenswürdige Ausgangsbasis, ohne zu übersetzen. Untersuche Fehler, statt Prüfsummen neu zu erstellen, um sie zu unterdrücken. Die aktuelle Runner-Anleitung verwendet ein anderes Paket und eine andere Konfiguration. Führe daher eine Migration durch, bevor du sie übernimmst.
Purge nur verwenden, wenn Inhalte gelöscht werden sollen #
Beim früheren Vorgehen, zuerst purge und dann run auszuführen, werden Zielschlüssel entfernt, damit sie beim regulären Auffüllen von Lücken verarbeitet werden. Dabei werden Ergebnisse gelöscht, bevor die Neuerzeugung erfolgreich abgeschlossen ist. Eine Leistungsverbesserung ist für dieses Vorgehen nicht nachgewiesen. Nutze die Purge-Referenz, um dich über die abweichenden Selektoren und das Risiko für die Quellsprache zu vergewissern. Bewahre eine wiederherstellbare Kopie auf, bis Neuerzeugung und Prüfung erfolgreich abgeschlossen sind.