CLI

プロジェクトファイルを翻訳し、翻訳結果を取得して、Reactアプリケーションで使うソースカタログを管理します。

Lingo.dev CLIは、プロジェクト内のファイルをローカライゼーションエンジンに接続します。ソースのパスと翻訳先の言語を設定し、選択したコンテンツをプッシュして、翻訳済みファイルを取得します。次回以降の実行では、記録済みのソースを基準に変更を処理します。

@lingo.dev/cliでlingo実行ファイルをインストールします。設定から翻訳結果の取得までの一連の手順は、最初のファイルを参照してください。

最新の@lingo.dev/cliをインストールし、lingo --versionでプロジェクトが使用するバージョンを記録してください。lingo.dev@0.138.10とそのi18n.jsonプロジェクトについては、CLI v0リファレンスを参照してください。

作業スタイルに合わせてインストールする #

バージョン管理の対象となるプロジェクトの依存関係としてインストールする場合:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

シェル全体で使える実行ファイルとしてインストールする場合:

sh
npm install --global @lingo.dev/cli
lingo --help

このマニュアルではlingoを直接実行します。ローカルにインストールした場合は、パッケージマネージャー経由で呼び出してください。npx @lingo.dev/cli@latestとpnpm dlx @lingo.dev/cli@latestを使うと、常時インストールしておかなくても最新リリースを実行できます。ローカル環境とCI環境で動作をそろえる必要がある場合は、バージョンを固定してください。CIの例ではNode.js 22を使用しています。

lingo updateは、検出したインストール方法を使用します。バージョンを明示的に指定する場合や、インストール方法が認識されない場合、一時的にインストールしている場合は、パッケージマネージャーを使用してください。

ファイルを翻訳する、またはメッセージを抽出する #

既存のリソースを扱う場合は、ファイルを設定し、認証を済ませて、ローカライゼーションエンジンを紐付けます。翻訳はサーバー上で実行されます。push --waitは完了を待って翻訳結果をダウンロードします。pushとpullを個別に実行すれば、後から取得することもできます。

Reactソース内の呼び出しを扱う場合は、抽出によってJSONCとTypeScriptの宣言をローカルに作成します。翻訳やランタイムのインストールは行いません。抽出したカタログを翻訳対象のファイル設定に追加し、Reactのカタログワークフローで読み込んでください。

更新に必要な状態を保持する #

初回の通常のプッシュでは、ソースのバイト列が保存されます。バックフィルでは不足している翻訳先ファイルが作成され、その後の通常のプッシュではソースの変更が翻訳されます。.lingo/config.json、.lingo/lock.json、承認済みの翻訳は、まとめてバージョン管理してください。認証情報と直近の実行を示すポインターは、ホームディレクトリに保存されます。

プッシュ、プル、Lockfileとキャッシュでは、モードと復旧方法の選択肢を説明しています。コマンドには、設定、翻訳、カタログ管理に使うコマンドを掲載しています。