lingo init

ソース、ターゲット、カタログのパスを明示して、ローカライゼーション設定を作成します。

lingo initは、ローカライゼーション設定を.lingo/config.jsonに書き込みます。プロジェクトでソースロケール、ターゲットの一覧、ファイルパターンを初めて設定する際に使用します。ソースファイル、認証情報、ローカライゼーションエンジンとの紐付けは、それぞれ別途設定が必要です。初期化では、これらのリソースの作成や翻訳は行いません。

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

生成されたファイルを開き、意図したソースコンテンツだけが選択されることを確認してください。その後、必要に応じて対象のファイルを作成し、サインインして、リモート翻訳の前にlinkを実行してください。

オプション #

オプション既定値または動作
--source <locale>既定値を使用する場合はen。
--targets <list>カンマ区切りのロケール。--yesを指定した場合はde,fr,es。
--files <list>カンマ区切りのパターン:locales/<source>.jsonと--yesを使用します(例:locales/en.json)。
--messages-path <path>Reactカタログのi18n.messagesPathを設定。既定値はlocales。
--types-path <path>宣言のi18n.typesPathを設定。既定値はlingo.d.ts。
--force既存のローカライゼーション設定を置き換えます。
--no-agents-mdAGENTS.mdとCLAUDE.mdにあるLingo.devのブロックをスキップします。
--yes, -y入力を求めず、指定された値または既定値を使用します。

--yesを指定しない場合は、未指定の項目を対話形式で入力するよう求められます。リストはカンマとスペースで区切られるため、スペースを含むパターンは.lingo/config.jsonを編集して追加してください。重複するターゲットと、ソースロケールに完全に一致するターゲットは除外されます。除外後のターゲットリストが空になる場合はエラーになります。CLIが受け取る前にシェルがパターンを展開しないよう、パターンを引用符で囲んでください。

初期化時には、プロジェクトのAGENTS.mdにもLingo.devのブロックが書き込まれます。ファイルがなければ新たに作成されます。既存のCLAUDE.mdにも書き込まれますが、ブロックの書き込み先となるAGENTS.mdをインポートしている場合は除きます。このブロックは、ローカライズ作業の前にnpx @lingo.dev/cli agent-guideを実行するようコーディングエージェントに指示します。ブロックのマーカーの外側にあるテキストは保持され、次回以降の実行ではマーカー間のテキストだけが置き換えられます。

既存プロジェクトの再初期化 #

強制実行しない場合、既存のローカライゼーション設定は保持されます。設定が上書きされることはなく、初期化は失敗します。強制実行すると、パターンに基づいてfiles[]が再構築されます。この際、除外設定、明示的な形式指定、出力テンプレート、キー制御など、エントリの詳細オプションは失われます。強制実行の前にこれらの設定を保存しておくか、小規模な変更であれば既存の設定を編集してください。

組織やローカライゼーションエンジンとの紐付けを含め、ほかのルートセクションは保持されます。カタログパスの既定値は保存される設定から省略されるため、強制実行で既定値に戻すと、以前のi18nの上書き設定が削除されることがあります。カタログパスを変更しても、翻訳ファイルのパターンは自動では変更されません。

最初のファイルの手順ガイドでは、設定から、既存コンテンツの初回翻訳、ターゲットファイルの取得までを説明しています。ファイルエントリの詳細設定については、設定を参照してください。