FAQ

Kurze Antworten mit einem Link auf die Seite, die die Details hat. Zu Fehlermeldungen siehe Fehlerbehebung und Fehlercodes.

Wie kontrolliere ich die Kosten?Link zu diesem Abschnitt kopieren

Läufe sind inkrementell, also erreichen nur fehlende oder geänderte Keys den Provider, und ein unverändertes Projekt kostet beim erneuten Lauf nichts. verbatra translate --estimate bemisst einen Lauf, ohne einen Provider aufzurufen, und --max-tokens oder maxTokens in der Konfiguration deckeln ihn. Siehe Kosten abschätzen.

Was kostet ein Lauf tatsächlich?Link zu diesem Abschnitt kopieren

Wenig: 400 Keys in 3 Locales mit gemini-2.5-flash ergeben etwa 72.000 Tokens, die du mit dem aktuellen Tarif deines Providers bepreist, und spätere Läufe zahlen nur für die Strings, die du geändert hast. Wie du einen Lauf abschätzt, wo jeder Provider seine Tarife veröffentlicht und wie du an deinem eigenen Projekt kalibrierst, steht in Kosten abschätzen.

Mit welchem Provider soll ich anfangen?Link zu diesem Abschnitt kopieren

Mit Gemini, denn mit seiner kostenlosen API-Stufe übersetzt du ein ganzes Projekt ohne Kosten, und ein späterer Wechsel heißt, eine id zu ändern. Halte vertrauliche Strings von der kostenlosen Stufe fern: siehe Datenverarbeitung und Datenschutz. Alle Provider im Vergleich findest du unter Provider.

Kann ich ein lokales Modell verwenden?Link zu diesem Abschnitt kopieren

Ja: Der Provider openai-compatible richtet verbatra auf jeden Server, der die OpenAI-Chat-API spricht, etwa LM Studio, Ollama oder vLLM, meist ohne Schlüssel. Ganz ohne Sprachmodell nutzt libretranslate einen selbst gehosteten LibreTranslate-Server. Siehe Provider.

Welche Sprachen unterstützt verbatra?Link zu diesem Abschnitt kopieren

Jede Sprache, die dein Provider unterstützt, geschrieben als gültiger BCP-47-Code wie pt-BR oder zh-Hant. DeepL und Google Cloud Translation haben feste Listen, die LLM-Provider keine. Siehe Sprachunterstützung.

Wie behalten Keys ihre Reihenfolge?Link zu diesem Abschnitt kopieren

Bestehende Keys behalten ihre Position, und neue Keys werden in der Reihenfolge der Quelle angehängt, sodass sich eine übersetzte Datei sauber diffen lässt. Siehe Formate.

Warum wurde eine Übersetzung zum Review markiert?Link zu diesem Abschnitt kopieren

Eine Review-Heuristik hat etwas gefunden, das einen zweiten Blick wert ist, etwa eine Übersetzung, die ihrer Quelle gleicht, und sie markiert, ohne sie zurückzuhalten. Jeder Grund-Code steht unter Review-Gründe.

Funktioniert verbatra in einem Monorepo?Link zu diesem Abschnitt kopieren

Ja. Die Suche nach der Konfiguration geht vom Arbeitsverzeichnis nach oben und hält beim nächsten .git an, sodass ein Paket seine eigene Konfiguration findet und die Wurzel die der Wurzel; --cwd und --config zeigen auf jeden anderen Ort. Siehe Die Konfigurationsdatei.

Was soll ich committen?Link zu diesem Abschnitt kopieren

Committe deine Locale-Dateien, verbatra.lock.json und verbatra.provenance.json; nie .env, .env.local, .verbatra-local/ oder verbatra.cache.json, die verbatra init in die .gitignore einträgt. Siehe Die Lock-Datei.

Wie übersetze ich alles neu?Link zu diesem Abschnitt kopieren

Lösch die Locale-Datei und führe verbatra translate aus: Dann fehlt jeder Key und wird frisch übersetzt. Die Lock-Datei zu löschen reicht nicht, denn ohne Baseline gelten vorhandene Übersetzungen als aktuell. Für einen einzelnen Key nimm die Neuübersetzen-Aktion in Studio oder retranslateEntry.

Muss ich das SDK installieren, wenn ich die CLI nutze?Link zu diesem Abschnitt kopieren

Kein zusätzlicher Schritt: @verbatra/cli hängt von @verbatra/sdk ab, also kommt es mit. Nur @verbatra/studio und @verbatra/mcp sind eigene, optionale Installationen.

Wo leben API-Schlüssel?Link zu diesem Abschnitt kopieren

Nur in Umgebungsvariablen, die die CLI auch aus .env.local und .env liest. Die Konfiguration lehnt unbekannte Keys ab, damit kein Secret in einer committeten Datei landet. Siehe Provider.

Schickt verbatra meine Strings irgendwohin?Link zu diesem Abschnitt kopieren

Nur an den Provider, den du konfigurierst, und nur, wenn ein Befehl übersetzt; es gibt keine Telemetrie. Mit provider: { id: "none" } verlässt nichts den Rechner. Siehe Datenverarbeitung und Datenschutz.

Was prüft verbatra doctor eigentlich?Link zu diesem Abschnitt kopieren

Die Einrichtung in einem Durchgang, ohne Übersetzungsaufruf und ohne den Wert eines Schlüssels zu lesen, außer du übergibst --live, das ihn sendet, um die Sprachliste des Providers abzurufen: Konfiguration, Format, Provider, die Variable des API-Schlüssels, die Netzwerkrichtlinie, die Quelldatei und die Sprachunterstützung, dazu informative Berichte zu Pluralen, Locale-Codes und zurückgebliebenem Locale-Stand. verbatra doctor hat die vollständige Tabelle der Prüfungen.

Kann ein KI-Agent verbatra für mich einrichten oder bedienen?Link zu diesem Abschnitt kopieren

Ja, über vier Oberflächen: einen Einrichtungs-Prompt für Coding-Agenten (Mit einem KI-Agenten einrichten), die --json-Ausgabe für deine eigenen Schleifen (Rezepte für Agenten und Skripte), WebMCP-Tools in einem offenen Studio-Tab (Studio mit einem Browser-Agenten steuern) und einen stdio-MCP-Server (verbatra mcp). Studio und der MCP-Server geben beim Provider nur hinter einem --allow-spend-Flag Geld aus; in der --json-Schleife gibt ein echtes translate sofort Geld aus, also muss dein Skript oder Agent vorher das Okay eines Menschen einholen.

Veröffentlicht diese Seite etwas für KI-Agenten und Crawler?Link zu diesem Abschnitt kopieren

Ja, drei statische Dateien, zur Build-Zeit generiert und immer auf Englisch, egal welche Locale du gerade ansiehst:

• /llms.txt: ein kuratierter Index mit Titel und Beschreibung jeder Doc-Seite, gruppiert wie die Sidebar, als Markdown-Links.
• /llms-full.txt: die komplette Dokumentation in einer Datei, der gerenderte Inhalt jeder Seite der Reihe nach aneinandergehängt, für einen Agenten, der Inhalte direkt einliest, statt Links zu folgen.
• /.well-known/ai.txt: eine Nutzungsrichtlinie, die KI-Crawlern sagt, dass dieses Projekt MIT-lizenziert ist und Crawlen, Indexieren und Zitieren dieser Inhalte willkommen ist.

Alle drei sind aus der Footer-Spalte "Für KI-Agenten" verlinkt.

Ist der Inhalt dieser Seite KI-übersetzt?Link zu diesem Abschnitt kopieren

Größtenteils, auf zwei verschiedenen Wegen. Der UI-Rahmen (Navigationsbeschriftungen, Buttons, der Footer, der Landingpage-Text, die Landing-FAQ) lebt in messages/en.json und seinen de-, es- und fr-Geschwistern; die werden mit verbatra selbst maschinell übersetzt, gegen das Format next-intl-json, über den Gemini-Provider, indem nach einer Änderung der englischen Quelle pnpm i18n ausgeführt wird. Das Projekt nutzt hier sein eigenes Tool (Dogfooding), und der Workflow docs-i18n-check lässt einen Pull Request scheitern, dessen Locale-Dateien von der englischen Quelle abweichen. Die Doku-Prosa, die du gerade liest, jeder Guide und jede Referenzseite einschließlich dieser hier, ist locale-suffigiertes MDX (page.mdx, page.de.mdx, page.es.mdx, page.fr.mdx) und ebenfalls KI-übersetzt, nur außerhalb dieser automatisierten Pipeline: pnpm i18n übersetzt nur die strukturierten Locale-Dateiformate, nie Markdown, es rührt diese Seiten also nie an. Stattdessen übersetzt ein KI-Agent eine Doku-Seite in derselben Änderung, die ihre englische Quelle bearbeitet, sodass alle vier Sprachen gemeinsam landen; deshalb trägt jede nicht-englische Seite den Hinweis auf die maschinelle Übersetzung.

Nicht alles kommt unverändert aus diesen beiden Schritten: Einige Texte, darunter Teile der rechtlichen Seiten, wurden stattdessen direkt in den Locale-Dateien verfasst oder korrigiert. Übersetzungen werden nach bestem Bemühen geprüft, und nicht jeder übersetzte Text wird vor der Veröffentlichung von einem Menschen durchgesehen, daher kann eine Übersetzung Fehler enthalten. Die Datenschutzerklärung beschreibt denselben Ablauf.

Wenn dir im Deutschen, Spanischen oder Französischen etwas seltsam vorkommt, eröffne in beiden Fällen ein Issue: Bei UI-Texten landet die Korrektur in der englischen Quelle und wird neu übersetzt, oder direkt in der betroffenen Locale-Datei; bei Doku-Prosa bearbeite die MDX-Datei direkt und schicke einen Pull Request.