Referenz / CLI
Maschinell übersetzte Seite
verbatra report
Gib einen nur lesenden Projektbericht aus. Der Herkunftsbericht listet, woher jede Übersetzung stammt und ob eine Person sie geprüft hat.
verbatra report provenance liest verbatra.provenance.json, die Lock-Datei und die Locale-Dateien und gibt pro Ziel-Locale aus, wie viele Werte eine Maschine geschrieben hat, wie viele eine Person geprüft hat und wie viele Menschen geschrieben oder importiert haben. Er ruft keinen Provider auf, braucht keinen API-Key und schreibt nichts. Der Bericht ist ein unterstützender Nachweis, keine Rechtsberatung.
Synopsis
verbatra report <report> [flags]<report>: der Bericht, der ausgegeben wird.provenanceist derzeit der einzige; jeder andere Name ist ein Bedienfehler.
Beispiele
# Zähler pro Locale: maschinell und ungeprüft, maschinell und geprüft, menschlich, importiert und der Rest
verbatra report provenance
# Herkunft und Review-Status jedes Keys, für eine Audit-Datei
verbatra report provenance --json > provenance-report.json
# nur die deutsche Locale
verbatra report provenance --locales deFlags
| Flag | Argument | Standard | Wirkung |
|---|---|---|---|
--locales | <list> | alle konfigurierten Ziele | nur über diese kommagetrennte Teilmenge berichten; eine nicht konfigurierte Locale scheitert mit UNKNOWN_, eine leere Liste mit INVALID_, beide mit Exit 2 |
Nimmt außerdem die globalen Flags --cwd, --config und --json.
Verhalten
Ausgabe
verbatra report provenance (source en, verbatra 0.12.0, 2026-09-29T08:00:00.000Z)
locale machine, unreviewed machine, reviewed human import external unrecorded unknown total
de 12 40 3 85 1 0 0 141
Supporting evidence from verbatra.provenance.json, not legal advice. --json lists every key.Die erste Zeile nennt die Quell-Locale, die verbatra-Version und wann der Bericht erstellt wurde. Jede Zeile zählt die Keys, die sowohl in der Quelle als auch in dieser Locale einen Wert haben. Nachweis maschineller Übersetzungen beschreibt die Kategorien, was der Bericht zeigen kann und was nicht, und das vollständige JSON-Schema.
Es gibt kein --out: Der Bericht geht wie bei check und diff auf stdout, also leite ihn um, wenn du ihn aufbewahren willst.
JSON-Ausgabe
Schema: report-envelope.json validiert den ganzen Envelope; Schemas listet die übrigen auf.
--json gibt einen Envelope aus, dessen result für jeden Key Herkunft, Review-Status, Provider, Modell und Reviewer auflistet, für eine Audit-Datei. Lässt sich die Provenienz-Datei nicht lesen, ist das Ergebnis { "available": false, "reason": "provenance-unreadable" }.
Unlesbare Provenienz-Datei
Ein Bericht ohne lesbare Provenienz-Datei würde jeden Wert als unrecorded listen, und das ist nicht dasselbe wie gar keine Aufzeichnung. Der Befehl schlägt deshalb sicher mit Exit 1 fehl, wie check --require-reviewed, damit ein CI-Job keine leere Audit-Datei archiviert.
Rückmeldung im Terminal
Der Befehl zeigt eine Zeile, während er die Dateien liest. Warten maschinelle Übersetzungen auf ein Review, schlägt er Studio vor:
verbatra: reading the provenance record... done (0.1s)
next: verbatra studio (approve or reject the 12 machine translations no person has reviewed yet)Diese Zeilen gehen auf stderr, und --quiet blendet sie aus. Siehe Terminalausgabe.
Exit-Codes
| Code | Bedeutung |
|---|---|
0 | der Bericht wurde ausgegeben |
1 | kein Bericht: verbatra.provenance.json ist beschädigt oder stammt von einer neueren verbatra-Version |
2 | konnte nicht laufen: ein Konfigurationsfehler, eine unlesbare Quell- oder Lock-Datei, ein nicht konfigurierter oder leerer --locales-Wert (UNKNOWN_, INVALID_) oder ein unbekannter Berichtsname |
Siehe den Exit-Code-Vertrag.
Siehe auch
- Nachweis maschineller Übersetzungen behandelt den Bericht, sein Schema und die Markierungen maschineller Übersetzung in XLIFF- und TMX-Exporten.
- Die Lock-Datei erklärt die Provenienz-Datei, die der Bericht liest.
verbatra check --require-reviewedlässt CI fehlschlagen, solange eine maschinelle Übersetzung nicht freigegeben ist.