最初のファイルを翻訳する

ソースカタログを作成し、ドイツ語とフランス語の翻訳先ファイルを取得して、その後のソースの変更も翻訳します。

このチュートリアルでは、英語の JSON ファイルを1つ使い、セットアップから翻訳、翻訳ファイルの取得までを順に進めます。完了すると、翻訳先のファイルがディスクに保存され、その後の編集の土台が整います。コーディングエージェントにセットアップを任せる場合は、コーディングエージェントでセットアップするをご覧ください。

Node.jsとnpmが使える小規模なプロジェクトディレクトリを用意してください。Lingo.devのアカウントに加え、有効なローカライゼーションエンジンで翻訳する権限と、作業に十分なアカウント利用枠も必要です。

インストールしてログインする #

sh
npm install --global @lingo.dev/cli
lingo --version
lingo login

ログイン操作を行うとブラウザが開きます。非対話型のランナーでは、代わりにランナーのシークレットストア経由でLINGO_API_KEYを渡してください。環境変数で指定したキーは、保存済みのログイン情報より優先されます。別のユーザーとしてログインする前に、意図せず優先されているキーの設定を削除してください。

ソースを作成する #

localesディレクトリを作成し、次の内容をlocales/en.jsonとして保存してください。

json
{
  "checkout": {
    "title": "Review your order",
    "submit": "Place order"
  }
}

プロジェクトのルートで、次を実行します。

sh
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo link

init は .lingo/config.json を書き込み、AGENTS.md に Lingo.dev のブロックを追加して、コーディングエージェントに CLI のエージェントガイドを参照するよう指示します。この処理を省くには、--no-agents-md を指定してください。link では、組織とローカライゼーションエンジンを選択でき、権限があれば新規作成もできます。ローカライゼーションエンジンは、モデルと言語に関する指針を提供します。エンジンの ID はプロジェクト設定に保存され、認証情報は別に保管されます。

先に進む前に設定ファイルを開き、ソースがen、翻訳先がdeとfr、ソースファイルがlocales/en.jsonに設定されていることを確認してください。組織とローカライゼーションエンジンのIDも確認しましょう。特に、コピーしたプロジェクトやフォークでは注意が必要です。

翻訳して取得する #

sh
lingo push --backfill-missing --wait

バックフィルは、不足している翻訳先ファイルの翻訳をリクエストします。--waitは処理の完了を待ち、完成した出力をダウンロードします。Lockfileがない状態で通常の初回プッシュを行うと、この初回翻訳はリクエストされず、ソースの保存のみが行われます。

コマンドの待機中は、翻訳先ファイルを変更しないでください。この方法で直接取得する場合、個別のプルコマンドとは異なり、ローカルでの最新の編集と競合していないかを改めて比較する処理は行われません。実行がレビュー待ちになったり、失敗が報告されたりした場合は、完了と判断する前に状態を確認してください。

locales/de.jsonとlocales/fr.jsonを開いてください。チェックアウトに関する2つのキーがどちらも残っていることを確認し、翻訳された値を読んでください。翻訳先の言語を評価できない場合は、適任のレビュアーに依頼するか、適切な測定を利用してください。アプリケーションに組み込む場合は、そのアプリケーションで通常使うリソースローダーでもファイルを読み込んでください。

ソースと翻訳先の差分とともに、.lingo/lock.jsonをレビューしてください。確認して採用したファイル、設定、ベースラインは、まとめてコミットします。--waitを使わない場合は、後で同じチェックアウトとマシンからlingo pullを実行し、ローカルに記録された最新の実行結果を取得してください。

ソースを更新する #

locales/en.jsonの値を変更するか、キーを追加してから、次を実行します。

sh
lingo push --wait

通常の更新では、ソースの変更を保存済みのベースラインと比較します。バックフィルの対象は不足しているファイルであり、既存の翻訳先ファイルに追加された新しいキーではありません。

その他のリソース形式や構成については、設定と形式を参照してください。YAMLとAndroid XMLでは、形式を明示的に選択する必要があります。Reactのソースコード内の呼び出しを抽出する場合は、Reactクイックスタートに進んでください。このJSONサンプルを使えば自動的に選択されるわけではないため、設定でReact用のJSONCカタログを選択してください。