Lingo.dev CLI

CLIは、内のi18n.jsonbucket configurationsに基づいて、プロジェクト内のソースファイルとターゲットファイルをスキャンします。各bucketでは、ファイル形式とinclude/excludeパターンのセットを定義し、翻訳可能なコンテンツがどこにあるかをCLIに伝えます。

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    },
    "markdown": {
      "include": ["docs/[locale]/*.md"]
    }
  }
}

[locale]プレースホルダーは、実行時に設定済みのソースおよびターゲットのロケールコードに展開されます。

すべてのコンテンツを翻訳する必要があるわけではありません。CLIは、言語が変わってもそのままでよい値、たとえば数値、真偽値、ISO日付、UUID、URL、空文字列を除外します。これにより翻訳バックエンドへ送るペイロードを減らし、トークン消費量と処理時間を抑えられます。

CLIは各ソース文字列に対してSHA-256フィンガープリントを計算し、i18n.lockに保存された前回の状態と比較します。翻訳パイプラインに入るのは、新規または変更されたコンテンツだけです。変更のない文字列は完全にスキップされます。

この増分アプローチにより、10,000個のキーがあるプロジェクトでも、変更されたのが12個だけなら翻訳されるのはその12個だけで、全件を処理する必要はありません。

差分は、設定された翻訳バックエンドに送信されます。CLIは2つのモードに対応しています。

CLIは失敗したリクエストを指数バックオフで再試行し、途中経過を保存しながら、複数のターゲット言語を並行して処理します。

翻訳された文字列は、ソースコンテンツがある正確な位置にディスクへ書き戻されます。CLIはファイル構造と書式を保つことで、最小限でレビューしやすい差分を生成します。プロジェクトでPrettierが設定されている場合は、出力もそのフォーマットルールに従います。