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. Prüfen
verbatra checkvergleicht Quelle, Ziele und Lock-Datei. Es ruft keinen Provider auf und braucht keinen Key.2. Übersetzen
verbatra translateschickt nur fehlende und geänderte Keys und verwirft jedes Ergebnis mit abweichenden Platzhaltern, kaputtem Inline-Markup oder ungültiger ICU-Syntax.3. In der CI absichern
Die GitHub Action führt
checkbei 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.
Das verbatra-Binary: jeder Befehl, von init und extract bis translate, check, export und studio, als dünner Wrapper über dem SDK. Starte hier.
Der Motor darunter: translate, watch, check, diff, doctor, extract, Pseudolokalisierung, Typgenerierung sowie der Excel- und TMX-Roundtrip, alles aus Code.
Ein lokales Dashboard mit direkter Bearbeitung, Review-Warteschlange, einer Overview zu Abdeckung und Läufen und Browser-Agent-Tools. Provider-Ausgaben bleiben aus, bis du sie ausdrücklich aktivierst.
Ein stdio-MCP-Server, der Übersetzungsstatus, Glossar und Bearbeitungs-Tools für Claude Code, Cursor oder einen beliebigen MCP-Client bereitstellt.