Zum Inhalt springen
Zum Inhalt springen

Dokumentation

Richte verbatra ein und halte jede Locale synchron.

Anleitungen und Referenz für die CLI, das SDK, Studio und den MCP-Server: Starte mit dem Schnellstart oder lass deinen Coding-Agenten verbatra einrichten.

Starte bei deinem Ziel

Wähle, was du vorhast; jede Karte öffnet die Seite, die genau das zeigt.

Wähle deinen Stack

Eine Karte mit Schnellstart öffnet eine Schritt-für-Schritt-Anleitung für diesen Stack; jede andere Karte öffnet den init-Befehl und das Dateilayout.

Jeder Lauf ist ein Diff, keine Neuübersetzung.

Was passiert, wenn du verbatra translate ausführst.

Eine Quell-Locale von Hand zu pflegen bedeutet, dass jede andere Locale-Datei abdriftet: Neue Keys fehlen in den Zielen, bearbeitete Strings hinterlassen veraltete Übersetzungen, und gelöschte Keys bleiben als Waisen zurück. verbatra schließt diese Lücke, indem es jedes Ziel gegen eine committete Lock-Datei, verbatra.lock.json, vergleicht und nur das Geänderte an den von dir konfigurierten Provider sendet; ein zweiter Lauf, bei dem es nichts Neues zu übersetzen gibt, ruft den Provider überhaupt nicht auf. Jedes Ergebnis wird vor dem Schreiben geprüft, sodass ein kaputter Platzhalter zurückgehalten und erneut versucht wird, statt ausgeliefert zu werden. Siehe Wie es funktioniert für die vollständige Pipeline.

  1. 1. Prüfen

    verbatra check vergleicht Quelle, Ziele und Lock-Datei. Es ruft keinen Provider auf und braucht keinen Key.

  2. 2. Übersetzen

    verbatra translate schickt nur fehlende und geänderte Keys und verwirft jedes Ergebnis mit abweichenden Platzhaltern, kaputtem Inline-Markup oder ungültiger ICU-Syntax.

  3. 3. In der CI absichern

    Die GitHub Action führt check bei jedem Pull Request aus und lässt ihn scheitern, solange eine Locale nicht synchron ist.

verbatra liest und schreibt die gängigen Formate für Locale-Dateien, von JSON und YAML bis XLIFF, gettext sowie Android- und Apple-Katalogen, und übersetzt über jeden unterstützten LLM- oder Maschinenübersetzungs-Provider hinter einer einzigen Schnittstelle (oder über keinen, für einen rein menschlichen Workflow); ein Format, das es nicht mitbringt, lässt sich als eigener Adapter ergänzen. Die vollständigen Listen findest du unter Formate und Provider.

Die Pakete

Ein Motor, vier Wege, ihn zu fahren.