CLI v0でファイルを翻訳する

バージョンを固定したパッケージで小規模な旧版カタログの処理を再現し、出力とLockfileを確認します。

この手順は、i18n.jsonをインストール済みのプロジェクト、または旧版の動作を検証する独立した環境で使用してください。対象はlingo.dev@0.138.10で、マニフェストではNode.js 18以降が必須とされています。まずnode --versionとインストール済みのlingo --versionを確認してください。新規プロジェクトでは最新のクイックスタートを使用してください。

記録されているパッケージを使用する #

既存のプロジェクトでは、依存パッケージの固定バージョンをそのまま維持してください。別の検証用環境を作成する場合は、使用するパッケージマネージャーを選んでください。

sh
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10

インストールコマンドは、いずれか一つだけ実行してください。npm exec -- lingo、pnpm exec lingo、yarn lingo、またはbun run lingoを使って、ローカルの実行ファイルを呼び出してください。以下の例では、これをlingoと略記します。Windowsでも、バージョンを固定してローカルにインストールし、パッケージマネージャー経由で実行ファイルを呼び出せば、パッケージ名によるコマンド解決に依存せずに済みます。

カタログと設定を作成する #

プロジェクトの配置先となるディレクトリでlingo initを実行してください。これによりi18n.jsonが作成されます。既存のファイルがある場合は、再初期化せず、そのまま保持してください。続いてlocales/en.jsonを作成してください。

json
{
  "welcome": "Welcome back",
  "button.save": "Save changes"
}

対応するJSONバケットを使用してください。

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es"] },
  "buckets": {
    "json": { "include": ["locales/[locale].json"] }
  }
}

versionは設定スキーマのバージョンであり、パッケージのバージョンではありません。このパターンでは、locales/en.jsonから英語を読み込み、locales/es.jsonにスペイン語を書き込みます。

翻訳バックエンドを指定する #

Lingo.devを使用する場合は、シェルのシークレット管理機能を使ってLINGO_API_KEYを渡してください。使用するengineIdを設定に追加し、そのキーで対象のローカライゼーションエンジンを使って翻訳できることを確認してください。省略した場合は、バックエンド側で暗黙的に選択されます。ただし、現在のサービスポリシーでは、識別子の明示的な指定が必要になることがあります。

プロバイダーに直接接続するv0の設定を使う方法もあります。この場合は、プロバイダー固有の認証情報、または接続可能なOllamaサービスが必要です。各フィールドについては、設定リファレンスを参照してください。これらのフィールドは、現行CLIのJSON設定には記述しないでください。

実行して確認する #

sh
lingo run

locales/es.jsonでキーと実際の翻訳値の両方を確認してください。保存メッセージが、翻訳後も意図した操作を示していることを確認してください。アプリケーションと連携する場合は、そのアプリケーションで実際に使用するカタログローダーで翻訳先のカタログを読み込んでください。確認を終えて採用した出力、設定、i18n.lockをまとめてコミットしてください。

原文に変更がない通常の実行では、既存の翻訳先の値が保持されるはずです。原文の変更や強制実行によって、これらの値が置き換えられることがあります。翻訳先ロケールやキーを限定した実行では、既存の原文ベースラインは更新されません。また、凍結モードでも、Lockfileが存在しない場合は初期化されることがあります。範囲を限定した出力だけでプロジェクト全体が更新済みと判断する前に、ベースラインの確定をお読みください。

開発時は、lingo run --watchが原文の変更を監視し、Ctrl+Cで停止するまで続きます。検証用環境を拡張する前に、既存の翻訳の取り込みと翻訳先の手動管理を確認してください。