verbatra export
Exportiere unübersetzte Strings in eine Übergabe für Übersetzerinnen, als formatierte Excel-Arbeitsmappe oder als CSV- bzw. TSV-Datei pro Locale.
Maschinell übersetzte Seite
Schreibe die zu übersetzenden Strings in eine formatierte Excel-Arbeitsmappe, die ein Mensch ausfüllen und für verbatra import zurückschicken kann. Standardmäßig enthält die Arbeitsmappe nur die fehlenden und geänderten Strings: dieselben Keys, die ein automatischer Lauf an einen Provider schicken würde. export ruft nie einen Provider auf und braucht keinen API-Key.
Synopsis
verbatra export [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 |
--out | <path> | verbatra-translations.xlsx, bei csv und tsv verbatra-translations | die Übergabe hierhin schreiben: ein Dateipfad bei xlsx, ein Verzeichnis bei csv und tsv |
--format | <format> | xlsx | eine Excel-Arbeitsmappe (xlsx) oder eine Datei pro Locale (csv, tsv) schreiben |
--locales | <list> | alle konfigurierten Ziele | kommagetrennte Teilmenge der Ziel-Locales, die exportiert wird |
--include-unchanged | keins | aus | auch bereits aktuelle Strings exportieren |
--json | keins | aus | einen JSON-Envelope auf stdout ausgeben, der das Export-Ergebnis (Pfad und Zeilenzahlen pro Locale) unter result trägt, oder bei einem fehlgeschlagenen Lauf den Fehlercode; die menschenlesbare Fehlerzeile geht weiter auf stderr |
Ein leerer oder unbekannter --locales-Wert wird mit Exit 2 abgelehnt, statt stillschweigend nichts zu exportieren.
Beispiele
# write the workbook with missing and changed strings
verbatra export
# only the German and French sheets, to a specific path
verbatra export --locales de,fr --out handoff/round-2.xlsx
# one de.csv and fr.csv under handoff/
verbatra export --format csv --out handoffCSV und TSV
--format csv und --format tsv schreiben reinen Text statt einer Arbeitsmappe: eine <locale>.csv oder <locale>.tsv pro exportierter Locale, mit denselben Spalten in derselben Reihenfolge wie ein Arbeitsmappen-Blatt. --out benennt dann das Verzeichnis, in das die Dateien geschrieben werden, und legt es an, falls es fehlt.
Eine Textdatei ist diffbar und lässt sich überall öffnen, hat aber keinen Zellschutz: jede Spalte ist editierbar und die Spalte Source hash ist sichtbar. Ein geänderter Hash wird nie vertraut, der Import vergleicht ihn mit der aktuellen Quelle und hält die Zeile zurück.
Jeder Text-Export schreibt zusätzlich ein verstecktes Manifest in das Verzeichnis, .verbatra-export-csv.json oder .verbatra-export-tsv.json, das die soeben geschriebenen Locales benennt. Nur dadurch kann ein erneuter Export mit einer engeren --locales-Auswahl die weggefallenen Locales außer Dienst stellen: deren Dateien bleiben auf der Platte, und verbatra import weist sie als Überbleibsel zurück, statt eine veraltete Übersetzung anzuwenden. Der Export löscht nichts aus dem Ausgabeverzeichnis, eine eigene Datei darin ist also nie in Gefahr.
Exit-Codes
| Code | Bedeutung |
|---|---|
0 | die Übergabe wurde geschrieben |
2 | konnte nicht laufen: ein Fehler des gesamten Laufs oder ein Verwendungsfehler (einschließlich eines leeren oder unbekannten --locales-Werts) |
export hat keinen Fehlermodus pro Locale und endet deshalb nie mit 1.
Siehe auch
- Menschliche Übersetzung behandelt den Aufbau der Arbeitsmappe, die CSV- und TSV-Variante, die Review-Spalten und den vollständigen Roundtrip.
verbatra importliest die ausgefüllte Übergabe zurück.