lingo init
ソース、ターゲット、カタログのパスを明示して、ローカライゼーション設定を作成します。
lingo initは、ローカライゼーション設定を.lingo/config.jsonに書き込みます。プロジェクトでソースロケール、ターゲットの一覧、ファイルパターンを初めて設定する際に使用します。ソースファイル、認証情報、ローカライゼーションエンジンとの紐付けは、それぞれ別途設定が必要です。初期化では、これらのリソースの作成や翻訳は行いません。
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-md | AGENTS.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の上書き設定が削除されることがあります。カタログパスを変更しても、翻訳ファイルのパターンは自動では変更されません。
最初のファイルの手順ガイドでは、設定から、既存コンテンツの初回翻訳、ターゲットファイルの取得までを説明しています。ファイルエントリの詳細設定については、設定を参照してください。