CLI v0の設定
世代の異なる設定を混在させずに、従来のバケット、ロケールのパス、翻訳バックエンドを設定します。
lingo.dev@0.138.10は作業ディレクトリ内のi18n.jsonを読み込みます。バケットでは使用するパーサーを指定し、ファイルを検出します。ロケール設定ではソースとターゲットを指定します。これは現在の.lingo/config.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]はソースまたはターゲットのコードに展開されます。パスごとに区切り文字を指定すれば、アンダースコアを使ったファイル名にも対応できます。
{
"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でローカライゼーションエンジンの用語集、ルール、語り口、モデルを選択します。明示的な指定を推奨します。省略した場合は、固定の設定が指定されるのではなく、バックエンドのポリシーに従います。現在のサービスでは、識別子の指定が必要になる場合や、そのキーでアクセスできる有効なローカライゼーションエンジンのうち、最も古いものが選択される場合があります。
プロバイダーを直接利用する場合は、プロバイダーの識別子、モデル、プロンプトを指定します。これは過去の設定形式であり、記載されたモデルが現在も利用できることを前提に、その利用を推奨するものではありません。
{
"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.dev | LINGO_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Anthropic | ANTHROPIC_API_KEY |
GOOGLE_API_KEY | |
| Mistral | MISTRAL_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| ローカルのOllama | ローカル環境での設定には、プロバイダーのAPIキーは不要です。 |
LINGO_API_URLはLingo.devサービスの接続先を変更します。変更後も互換性と信頼性の確認は必要です。認証情報を設定ファイルやログに含めないでください。バックエンドや検出設定を変更した後は、最初のファイルでの実行を小規模に再現してください。モデルやプロンプトを変更しても、ソースのフィンガープリントは変わりません。既存のテキストも更新したい場合は、明示的に更新する必要があります。