本文へスキップ
本文へスキップ

ドキュメント

verbatra をセットアップして、すべてのロケールを同期した状態に保つ

CLI、SDK、Studio、MCP サーバーのガイドとリファレンスです。クイックスタートから始めるか、コーディングエージェントに verbatra をセットアップさせます。

目的から始める

やりたいことを選びます。各カードは、それを実現するページを開きます。

技術スタックを選ぶ

「クイックスタート」の印が付いたカードは、そのスタック向けのステップごとのガイドを開きます。ほかのカードは、init コマンドとファイルのレイアウトを開きます。

すべての実行は差分であり、書き換えではない

verbatra translate を実行すると何が起きるかを説明します。

ソースロケールを 1 つ手作業で保守すると、ほかのすべてのロケールファイルがドリフトします。新しいキーがターゲットから欠落し、編集された文字列は古くなった訳文を残し、削除されたキーは孤立したキーとして残ります。verbatra は、コミットされたロックファイル verbatra.lock.json と各ターゲットを比較し、変更されたものだけを設定したプロバイダーに送ることで、この差を埋めます。翻訳するものがない 2 回目の実行では、プロバイダーをまったく呼び出しません。すべての結果は書き込む前にチェックされるため、壊れたプレースホルダーは保留されて再試行され、そのまま書き込まれることはありません。処理の流れ全体は実行の仕組みを参照してください。

  1. 1. チェック

    verbatra check はソース、ターゲット、ロックファイルを比較します。プロバイダーは呼び出さず、API キーも不要です。

  2. 2. 翻訳

    verbatra translate は欠落しているキーと変更されたキーだけを送り、プレースホルダーの不一致、壊れたインラインマークアップ、無効な ICU 構文を含む結果は拒否します。

  3. 3. CI にゲートを設ける

    GitHub Action が pull request ごとに check を実行し、ロケールが同期していない間は失敗させます。

verbatra は、JSON や YAML から XLIFF、gettext、Android や Apple のカタログまで、一般的なロケールファイルのフォーマットを読み書きします。対応する LLM や機械翻訳のプロバイダーを 1 つのインターフェースの背後で使って翻訳します(プロバイダーなしで使う場合は機械翻訳なしで実行するを参照)。同梱されていないフォーマットは、カスタムフォーマットアダプターを書くことで追加できます。一覧はフォーマットとプロバイダーにあります。

パッケージ

1 つのエンジンを、4 つの方法で操作します。