現行のCLIに移行する
承認済みの翻訳とアプリケーションの動作を維持しながら、従来のバケットとソースのフィンガープリントを置き換えます。
現行の@lingo.dev/cliは、サーバー側でのプッシュ/プル処理と、.lingoによるプロジェクト状態の管理を使用します。旧lingo.devパッケージは、ローカルでのバケット処理、i18n.json、i18n.lockを使用します。移行では、単にコマンド名を変えるのではなく、プロジェクトに必要な動作を維持することが重要です。
正常に動作する状態を保存する #
インストール済みのバージョンを記録し、ソース、承認済みの翻訳先ファイル、設定、旧Lockfileをバージョン管理に保存します。アプリケーションがそれらの翻訳先ファイルを読み込むことを確認してください。既存のローカライゼーション環境のルーター、プロバイダー、言語切り替え機能、カタログローダーは、範囲を絞った置き換えが正常に動作するまで維持してください。
フレームワークとランタイムのバージョン、および必要なソースロケール、ターゲットロケール、既定のロケールを記録します。ロケールを接頭辞に持つ代表的なルート、初回のロケール検出、フォールバック、言語切り替えをテストしてください。これらのアプリケーションの動作確認は、ファイル翻訳の移行とは分けて行います。
ファイル選択の設定を作り直す #
ソースとターゲットのロケール、個々のファイルエントリを明示して.lingo/config.jsonを作成し、利用権限のある組織とローカライゼーションエンジンに関連付けます。従来のバケットやフィンガープリントは、名前を変えるだけではこのスキーマに移行できません。
現在のCLI設定は、HTML(.htmlと.htm)、プレーンテキスト(.txt、v0と同じく1行につき1ユニット)、1つのファイルでロケールごとに列を分けるCSVテーブル、Javaの.propertiesファイル(v0と同じく1キーにつき1ユニット。lockedKeys、preservedKeys、ignoredKeysのマッチングもv0と同じ。lockedPatternsには、先読み・後読みや後方参照に対応していないRE2構文を使用)など、22種類の形式に対応しています。v0のcsvバケットファイルは、移行前にCSVレイアウトと照合してください。v0のpropertiesバケットのパスは、Javaプロパティと照合してください。[locale]のファイル名がmessages_[locale].propertiesの場合、ソースパターンはmessages_en.propertiesのようになります。ロケール別のCSV、MJML、その他の旧形式でのみ使えるバケットには、検証済みの変換方法、または別の翻訳手段が必要です。列挙値、マッチャー、出力テンプレートの正確な仕様は、設定を参照してください。v0でプロバイダーに直接接続するために使用していたモデル、プロンプト、ベースURLの設定は、このプロジェクトスキーマには含めないでください。
設定の対象を広げる前に、選択したソース1つと、そこから決まる翻訳先のパスを確認してください。Markdown系のプロパティにはtranslateComponentPropsを使用します。
既存の翻訳を引き継いで更新する #
現行版のスコープ指定や初期化の計画処理では、既存の翻訳先ファイルを引き継げます。ベースラインを確立する前に、代表的なファイルと手作業での編集内容を確認してください。ファイルが存在するだけでは、その値が最新のソースに対応しているとは判断できません。
バックフィルは不足している通常のファイルを補います。一方、v0は通常、既存のカタログ内で不足しているキーを補います。後者の作業には、現行版のソース差分更新か、サポートされているキーの更新機能を使用してください。JSONキーの名前を変更すると、テキストが元のキーと同じでも、パスに基づく新たな処理の対象になります。v0のコンテンツフィンガープリントによる、名前変更時の翻訳の再利用には依存しないでください。
キーが変わっていなければ、翻訳先の編集内容は差分処理でも保持できます。保持対象のキーを明示するルールを使うと、それとは別に管理主体を選択できます。ファイルが分かれている形式では、ファイル全体を強制処理すると現在の翻訳先のコンテキストが失われ、承認済みの表現が置き換わることがあります。既存の翻訳を引き継ぐための近道としては使えません。
現行版での初回実行を完了する #
現行版のクイックスタートに従い、バックフィルからファイルの取得まで進めてください。ベースラインを設定せずに初回プッシュだけを行うと、初回翻訳はリクエストされず、ソースのバイト列が保存されます。待機するかプルを実行してから、ファイルのワークフローが完了したと判断してください。
採用した翻訳元、翻訳先、設定、現在のLockfileは、まとめてコミットしてください。最新の実行を指すポインターはローカルのホームディレクトリ内にのみ保存され、Git経由では引き継がれません。その後のプルではハッシュが比較されるため、内容が分岐した編集だけをコミットしても、競合は解消されません。lingo checkは、従来のロック固定チェックに代わり、ファイル単位で検証します。.lingo/lock.json以降に翻訳元が変更されている場合や、翻訳先ファイルが存在しない場合は失敗します。また、Lockfileが存在しなくても、新たに作成することはありません。コミット済みのLockfileがなければ、翻訳元の変更は検出できず、翻訳先ファイルが存在するかどうかだけを確認します。
Reactの移行 #
現行のReactワークフローでは、ソースやコンテキストをリテラルで指定した呼び出しをJSONCと宣言に抽出し、選択したカタログを翻訳してから、実行時に文字列マップを読み込みます。変更範囲を広げる前に、1つのコンポーネントでフォールバック、変数、ロケール切り替え、承認済みの表現を確認してください。
パッケージ固有の移行作業については、既存のReactメッセージを移行するとReactを参照してください。同梱のlingo guide migrateはインストール済みのバージョンを反映したものであり、過去に生成されたすべての設定と同等であることを保証するものではありません。