CLI v0 リファレンス

承認済みの翻訳とソースのベースラインを維持しながら、導入済みの i18n.json プロジェクトを保守します。

このマニュアルでは、旧バージョンの lingo.dev パッケージと、その i18n.json/i18n.lock ワークフローを扱います。例は 0.138.10 を対象としています。移行を計画する際は、既存プロジェクトの Lockfile に記録されているバージョンを維持してください。随時更新される最新版のインストールでは、再現性のある復旧はできません。

新しいプロジェクトでは、現行の CLI から始めてください。サーバー側でプッシュとプルを行うワークフローでは、状態管理と対象選択のルールが異なります。

導入済みの v0 が動作する仕組み #

バケット設定に基づいてパーサーが選択され、必要に応じて [locale] を展開しながら、ソースファイルと翻訳先ファイルが検出されます。パーサーはコンテンツを抽出し、翻訳不要と認識した値を分離します。差分処理では、ソースの値、既存の翻訳、以前のソースのチェックサムを比較し、追加、変更、削除、名前変更された項目を検出します。

選択されたテキストは、Lingo.dev のローカライゼーションエンジン、または直接利用するよう設定されたプロバイダーで処理されます。返された翻訳は、翻訳先ファイルや共有ファイル内のロケール別セクションに組み直されます。あるタスクが失敗する前に、別のタスクが処理に成功した出力を書き込む場合があります。プロジェクト全体が、すべて成功するか、何も反映されないかのいずれかとなる単一のトランザクションとして処理されるわけではありません。

ベースラインをコンテンツと一緒に保持する #

i18n.json、承認済みのロケール別出力、i18n.lock を一緒にコミットしてください。Lockfile が記録するのはソースの状態であり、翻訳先の編集内容や言語ごとの承認をすべて記録するわけではありません。通常の実行ではソースのチェックサムが更新されます。一方、翻訳先ロケールやキーを限定した実行では、既存のベースラインを更新せずに出力を書き込む場合があります。

Lockfile リファレンスでは、対象を限定した実行の後に通常の処理を行うと、同じソースの変更が再び処理対象になることがある理由を説明しています。既存の翻訳では、現在の値をすべて置き換えることなく導入する方法を紹介しています。

次に行う操作を見つける #

最初のファイルの処理手順に従って、旧バージョンでの小規模な実行を再現してください。設定と形式では、導入済みのバージョンが何を読み書きするかを確認できます。

継続的な作業については、ロケールで翻訳先の追加方法を、キーの制御で通常の編集と人が管理する値の区別を、再翻訳で意図的に翻訳を更新する際の対象範囲の指定方法を説明しています。モノレポと並列処理では、ワーカーを増やしてもプロバイダーの制限はなくならないことを踏まえ、管理責任と処理能力を扱います。