Menschliche Übersetzungen behalten

Nutze das, wenn manche Übersetzungen von einem Menschen stammen: Rechts-, Marketing- oder Markentexte, für die jemand bezahlt wurde. Ändert sich ihr Quelltext, wird der Key veraltet, und ein gewöhnlicher maschineller Lauf würde darüber übersetzen. verbatra behält ihn standardmäßig; diese Seite zeigt, wie du solche Keys findest, auflöst und die Regel strenger oder lockerer machst.

Du brauchst ein Projekt, in dem translate mindestens einmal gelaufen ist, damit verbatra.provenance.json existiert und festhält, wer welchen Wert geschrieben hat.

Was geschützt istLink zu diesem Abschnitt kopieren

Ändert sich der Quelltext eines Keys, lassen translate und watch seinen Wert in Ruhe, wenn ein Mensch ihn geschrieben hat:

Maschinelle Ausgaben (machine, memory, fuzzy), Änderungen durch Agenten (agent) und Werte ohne Eintrag (unrecorded) werden wie gewohnt neu übersetzt. Ein Wert, den ein Reviewer abgelehnt hat, ist nie geschützt. Unter Herkunft steht, wie jede Herkunft erfasst wird.

Finde die geschützten KeysLink zu diesem Abschnitt kopieren

Ein geschützter Key wird nicht an den Provider gesendet, behält seinen Wert und bleibt veraltet, also bleibt er sichtbar:

verbatra translate --dry-run

verbatra translate (dry run)
  de: 1 would translate, 12 unchanged, 1 protected
    protected:       checkout.terms (import)
1 succeeded, 0 partial, 0 failed (dry run: nothing written)

• verbatra translate übersetzt alles andere, führt den Key als geschützt und endet trotzdem mit 0.
• verbatra check zählt ihn als veraltet und endet mit 1, sodass ein CI-Gate zeigt, dass ein Mensch etwas zu tun hat.
• verbatra diff listet ihn unter protected.
• verbatra export gibt ihn wie jeden veralteten Key als changed an den Übersetzer.

Einen geschützten Key auflösenLink zu diesem Abschnitt kopieren

Ein geschützter Key ist nicht mehr veraltet, sobald ein Mensch entscheidet, was er sagen soll:

• Bearbeite ihn in Studio oder speichere ihn unverändert, um den Text zu behalten. In beiden Fällen wird der Wert als human gegen den neuen Quelltext erfasst.
• Exportiere ihn, lass den Übersetzer ihn aktualisieren und importiere die Übergabe. Siehe Menschliche Übersetzung.
• Übersetze ihn bewusst neu, für einen Lauf mit verbatra translate --include-human.

Vorschläge statt ÜberschreibenLink zu diesem Abschnitt kopieren

Um zu sehen, was eine Maschine schreiben würde, ohne den Text des Menschen zu ersetzen, setz humanEdits auf suggest:

export default defineConfig({
  // ...
  humanEdits: "suggest",
});

Ein geschützter Key wird dann trotzdem an den Provider gesendet, aber die Antwort ist nur ein Vorschlag. Sie erscheint neben dem Key in der Laufzusammenfassung, mit einem suggestionStatus, der sagt, ob sie angekommen ist oder warum nicht, und sie wird im Übersetzungsgedächtnis abgelegt; in die Locale-Datei wird sie nie geschrieben. Ein exakter Gedächtniseintrag für den neuen Text kann als Vorschlag dienen, und der nächste Lauf liefert ihn erneut, ohne noch einmal zu zahlen. translate --estimate zählt diese Keys mit, weil sie gesendet werden. In einem rein menschlichen Projekt gibt es keinen Provider, den man fragen könnte, also verhält sich suggest wie protect.

Um wieder alles neu zu übersetzen, setz humanEdits auf overwrite. Siehe humanEdits und pinnedKeys.

Keys pinnenLink zu diesem Abschnitt kopieren

Manche Keys darf überhaupt keine Maschine anfassen: eine Marke, ein rechtlicher Hinweis. Trag sie in pinnedKeys ein, wobei * auf eine beliebige Zeichenfolge passt:

export default defineConfig({
  // ...
  pinnedKeys: ["legal.*", "brand.name"],
});

Ein gepinnter Key wird nie übersetzt, vorgeschlagen oder neu übersetzt, auch wenn er fehlt und auch mit --include-human. Er wird als geschützt mit dem Grund pinned geführt, bis ein Mensch ihn füllt.

AgentenLink zu diesem Abschnitt kopieren

Ein KI-Agent kann die Arbeit eines Menschen nicht ersetzen. Das MCP-Tool translation.retranslateEntry lehnt einen geschützten Wert mit KEY_PROTECTED und einen gepinnten Key mit KEY_PINNED ab und bietet keine Übersteuerung an. translation.translatePending lässt geschützte Keys in Ruhe und listet sie auf. Ein Agent kann mit translation.editEntry weiterhin einen Wert schreiben, solange der Key nicht gepinnt ist; dieser Wert wird als agent erfasst und gilt deshalb nie als Arbeit eines Menschen.

In Studio Verfügbar ab @verbatra/studio 0.6.0Link zu diesem Abschnitt kopieren

Die Seite Translations markiert einen geschützten Key als Protected und führt ihn in einer eigenen Gruppe, mit der Herkunft seines aktuellen Werts. Öffne den Key, um ihn zu bearbeiten, oder speichere ihn unverändert, um den Text zu behalten. Wenn du einen geschützten Key aus der Key-Schublade neu übersetzt, fragt Studio vorher nach und bietet Replace anyway an. Siehe Übersetzungen in Studio prüfen.

SonderfälleLink zu diesem Abschnitt kopieren

• Eine Herkunftsdatei aus einer neueren verbatra-Version. Keine Herkunft lässt sich lesen, also schützt translate jeden veralteten Key mit Wert, bis du aktualisierst, während check und diff nur gepinnte Keys als geschützt auflisten.
• Eine beschädigte Herkunftsdatei. translate scheitert, auch als Dry Run, mit PROVENANCE_FILE_INVALID. check und diff funktionieren weiter und führen nur gepinnte Keys als geschützt.
• Rein menschliche Projekte. Geschützte Keys zählen zum Exit-Code 3, wie Keys, die das Übersetzungsgedächtnis nicht füllen konnte: Beide brauchen einen Menschen.

Siehe auchLink zu diesem Abschnitt kopieren

• Die Konfigurationsdatei: humanEdits und pinnedKeys.
• verbatra translate: --include-human.
• Die Lock-Datei: wie verbatra.provenance.json jede Herkunft erfasst.
• Rein menschlicher Workflow: Projekte, in denen jeder Wert von einem Menschen stammt.