verbatra translate
Übersetze jedes Ziel-Locale einmal; danach beendet sich der Befehl.
Maschinell übersetzte Seite
Führe einen Übersetzungsdurchlauf über jedes Ziel-Locale aus; danach beendet sich der Befehl. translate liest das Quell-Locale, vergleicht es mit der Lock-Datei, schickt nur die neuen oder geänderten Strings an den Provider, führt die Integritätsprüfungen aus, schreibt die Locale-Dateien und aktualisiert das Lock. Was noch aktuell ist, wird nie erneut gesendet; du zahlst also nie zweimal für einen unveränderten String.
Synopsis
verbatra translate [flags]Flags
| Flag | Argument | Standard | Wirkung |
|---|---|---|---|
--cwd | <path> | aktuelles Verzeichnis | Konfiguration und Locale-Dateien von diesem Verzeichnis aus auflösen |
--config | <path> | wird gesucht | diese Konfigurationsdatei laden, statt eine zu suchen |
--dry-run | keins | aus | Änderungen ansehen, ohne einen Provider aufzurufen oder Dateien zu schreiben |
--prune | keins | die prune-Option der Konfiguration, sonst aus | verwaiste Keys (in einer Zieldatei, aber nicht in der Quelle) aus der geschriebenen Datei und dem Lock entfernen |
--concurrency | <n> | 1 | bis zu n Ziel-Locales gleichzeitig übersetzen; muss eine positive Ganzzahl sein |
--no-cache | keins | aus (Cache an) | den lokalen Translation-Memory-Cache (verbatra.cache.json) für diesen Lauf umgehen |
--json | keins | aus | die Lauf-Zusammenfassung als ein JSON-Objekt auf stdout ausgeben (die RunSummary-Form); Fehler gehen weiter auf stderr |
Standardmäßig löscht ein Lauf nichts: verwaiste Keys werden gemeldet und bleiben stehen. --prune entfernt genau diese Keys und sonst nichts und übersteuert für diesen Lauf die prune-Option der Konfiguration. Vor dem Lauf lädt translate .env.local und dann .env aus dem Arbeitsverzeichnis; eine bereits in der echten Umgebung gesetzte Variable gewinnt.
--concurrency übersetzt mehrere Ziel-Locales parallel, um ein großes Projekt schneller abzuschließen. Es wird mit Exit 2 abgelehnt, wenn die Konfiguration ein maxTokens-Budget setzt, weil parallele Locales ein Token-Limit nicht deterministisch einhalten können (ein Dry-Run ist ausgenommen). Während ein Lauf fortschreitet, wird der Fortschritt auf stderr ausgegeben (eine Zeile pro Locale-Start, Provider-Sub-Batch und Locale-Ende), sodass der stdout eines --json-Laufs eine einzige saubere Zusammenfassung bleibt. --no-cache überspringt den Translation-Memory-Cache für den Lauf und macht genau die Provider-Aufrufe, die es ohne vorhandenen Cache machen würde.
Beispiele
# translate once using the config it finds
verbatra translate
# preview the keys that would be pruned, spending nothing
verbatra translate --prune --dry-runExit-Codes
| Code | Bedeutung |
|---|---|
0 | jedes Ziel-Locale war erfolgreich |
1 | der Lauf lief durch, aber ein oder mehrere Locales schlugen fehl |
2 | konnte nicht laufen: ein Fehler des gesamten Laufs (Konfiguration, Quelle, Format, Provider oder Lock) oder ein Verwendungsfehler |
Ein fehlschlagendes Locale ist nicht fatal: der Lauf läuft zu Ende, endet mit 1, und das Detail pro Locale steht in der Zusammenfassung.
Siehe auch
- Wie es funktioniert erklärt die Pipeline aus Lesen, Diffen, Übersetzen, Schreiben.
- Der Cache erklärt, was
--no-cacheumgeht und wie die Wiederverwendung eingegrenzt ist. - Übersetzungssicherheit behandelt die Integritätsprüfungen und die Review-Warteschlange.
verbatra diffzeigt dieselben ausstehenden Keys schreibgeschützt an.- CI und Exit-Codes zeigt, wie du auf diese Codes verzweigst.