ドキュメント
verbatra を セットアップして、すべての ロケールを 同期した 状態に 保つ
CLI、SDK、Studio、MCP サーバーのガイドとリファレンスです。クイックスタートから始めるか、コーディングエージェントに verbatra をセットアップさせます。
目的から 始める
やりたいことを選びます。各カードは、それを実現するページを開きます。
技術 スタックを 選ぶ
「クイックスタート」の印が付いたカードは、そのスタック向けのステップごとのガイドを開きます。ほかのカードは、init コマンドとファイルのレイアウトを開きます。
すべての 実行は 差分であり、書き換えではない
verbatra translate を実行すると何が起きるかを説明します。
ソースロケールを 1 つ手作業で保守すると、ほかのすべてのロケールファイルがドリフトします。新しいキーがターゲットから欠落し、編集された文字列は古くなった訳文を残し、削除されたキーは孤立したキーとして残ります。verbatra は、コミットされたロックファイル verbatra.lock.json と各ターゲットを比較し、変更されたものだけを設定したプロバイダーに送ることで、この差を埋めます。翻訳するものがない 2 回目の実行では、プロバイダーをまったく呼び出しません。すべての結果は書き込む前にチェックされるため、壊れたプレースホルダーは保留されて再試行され、そのまま書き込まれることはありません。処理の流れ全体は実行の仕組みを参照してください。
1. チェック
verbatra checkはソース、ターゲット、ロックファイルを比較します。プロバイダーは呼び出さず、API キーも不要です。2. 翻訳
verbatra translateは欠落しているキーと変更されたキーだけを送り、プレースホルダーの不一致、壊れたインラインマークアップ、無効な ICU 構文を含む結果は拒否します。3. CI にゲートを設ける
GitHub Action が pull request ごとに
checkを実行し、ロケールが同期していない間は失敗させます。
verbatra は、JSON や YAML から XLIFF、gettext、Android や Apple のカタログまで、一般的なロケールファイルのフォーマットを読み書きします。対応する LLM や機械翻訳のプロバイダーを 1 つのインターフェースの背後で使って翻訳します(プロバイダーなしで使う場合は機械翻訳なしで実行するを参照)。同梱されていないフォーマットは、カスタムフォーマットアダプターを書くことで追加できます。一覧はフォーマットとプロバイダーにあります。
パッケージ
1 つのエンジンを、4 つの方法で操作します。
verbatra バイナリです。init や extract から translate、check、export、studio まで、すべてのコマンドを SDK の薄いラッパーとして提供します。まずはここから始めます。
内部のエンジンです。translate、watch、check、diff、doctor、extract、疑似ローカライズ、型の生成、Excel と TMX の往復を、すべてコードから使えます。
ローカルのダッシュボードです。その場での編集、レビューキュー、対応率と実行を示す Overview、ブラウザーエージェントのツールを備えます。プロバイダーの課金は、明示的に有効にしない限りオフのままです。
stdio の MCP サーバーです。翻訳の状態、用語集、編集ツールを、Claude Code、Cursor、そのほかの MCP クライアントに公開します。