CLI v0の設定

世代の異なる設定を混在させずに、従来のバケット、ロケールのパス、翻訳バックエンドを設定します。

lingo.dev@0.138.10は作業ディレクトリ内のi18n.jsonを読み込みます。バケットでは使用するパーサーを指定し、ファイルを検出します。ロケール設定ではソースとターゲットを指定します。これは現在の.lingo/config.jsonとは別の仕様です。

ロケールとバケットを宣言する #

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name"],
      "ignoredKeys": ["internal/*"],
      "preservedKeys": ["legal/terms"]
    },
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

パスは設定ファイルからの相対パスとして解決されます。パーサーを決めるのは、ファイル拡張子ではなくバケットのキーです。複数のロケールを1つのファイルに格納する形式を使う場合は、従来の形式と出力の対応表を確認してください。

versionフィールドにはスキーマの世代が記録されます。従来のスキーマの移行では、現在のCLIに移行せずにそのファイルを更新できます。以前の設定を保存し、生成された変更をすべて確認してください。

パスの照合を意図どおりに設定する #

[locale]はソースまたはターゲットのコードに展開されます。パスごとに区切り文字を指定すれば、アンダースコアを使ったファイル名にも対応できます。

json
{
  "include": [
    "standard/[locale].json",
    { "path": "legacy/[locale].json", "delimiter": "_" }
  ]
}

en-USの場合、2つ目のパスではlegacy/en_US.jsonを使用します。ファイル名での表記は、バックエンドに送信される正規化済みのロケール値とは別です。

**の再帰的な検出は0.135.0以降で利用できます。それ以前のリリースでは、パスを明示的に指定する必要があります。再帰的な検出では、既定でnode_modules、.git、dist、build、.next、.turboが除外されます。ほかにも自動生成されるディレクトリツリーがある場合は、除外設定を追加してください。

キーの動作を指定する #

従来のキー制御では、スラッシュ区切りで階層をたどり、ワイルドカードで照合します。modules/ai.translationは、modules内でドットを文字として含むキーを選択します。ロックはソースの値をコピーし、無視は出力から除外します。保持は、欠けている値をソースから補完し、その後の管理を人に委ねます。injectLocaleは、ターゲットのロケールコードに対応する出力キーを選択します。

各設定の正確な動作については、キー制御を参照してください。翻訳指示は構造を保護するものではありません。また、ソース言語のプレースホルダーは、使用前に人が翻訳する必要があります。

ローカライゼーションエンジンまたは直接利用するプロバイダーを選ぶ #

Lingo.devの認証情報を使う場合、engineIdでローカライゼーションエンジンの用語集、ルール、語り口、モデルを選択します。明示的な指定を推奨します。省略した場合は、固定の設定が指定されるのではなく、バックエンドのポリシーに従います。現在のサービスでは、識別子の指定が必要になる場合や、そのキーでアクセスできる有効なローカライゼーションエンジンのうち、最も古いものが選択される場合があります。

プロバイダーを直接利用する場合は、プロバイダーの識別子、モデル、プロンプトを指定します。これは過去の設定形式であり、記載されたモデルが現在も利用できることを前提に、その利用を推奨するものではありません。

json
{
  "provider": {
    "id": "openai",
    "model": "gpt-4o-mini",
    "prompt": "Translate the provided text from {source} to {target}."
  }
}

プロンプトでは、{source}と{target}がロケールコードに置き換えられます。lingo.dev@0.138.10のrunリクエストの送信先を変更する際は、provider.baseUrlに頼らないでください。OpenAI向けの処理ではbaseUrlを渡しますが、バージョンが固定されたプロバイダーの依存ライブラリはbaseURLを読み取るため、その設定値は無視されます。この依存ライブラリは、代わりにOPENAI_BASE_URLに対応しています。コンテンツや認証情報を送信する前に、意図した送信先になっているか確認してください。Ollama向けの処理もprovider.baseUrlを無視し、既定値でプロバイダーを作成します。このサービスには、実行環境から接続できる必要があります。リモートの実行環境では、ノートパソコンのローカルホストアドレスは使えません。

バックエンド認証情報
Lingo.devLINGO_API_KEY
OpenAIOPENAI_API_KEY
AnthropicANTHROPIC_API_KEY
GoogleGOOGLE_API_KEY
MistralMISTRAL_API_KEY
OpenRouterOPENROUTER_API_KEY
ローカルのOllamaローカル環境での設定には、プロバイダーのAPIキーは不要です。

LINGO_API_URLはLingo.devサービスの接続先を変更します。変更後も互換性と信頼性の確認は必要です。認証情報を設定ファイルやログに含めないでください。バックエンドや検出設定を変更した後は、最初のファイルでの実行を小規模に再現してください。モデルやプロンプトを変更しても、ソースのフィンガープリントは変わりません。既存のテキストも更新したい場合は、明示的に更新する必要があります。