Lingo.dev CLIをインストールし、プロジェクトを設定して、最初の翻訳を生成しましょう。
前提条件
Node.js 18以上が必要です。バージョンを確認するには node -v を実行してください。
ステップ1. プロジェクトを初期化する#
プロジェクトへ移動する
cd your-project-directoryinitコマンドを実行する
npx lingo.dev@latest initWindowsユーザー: npx lingo.dev が動作しない場合は、まず npm install lingo.dev@latest でパッケージをインストールし、代わりに npx lingo を使用してください。
表示される案内に従って進めてください。CLIがプロジェクトルートに i18n.json の設定ファイルを作成します。
ステップ2. バケットを設定する#
i18n.json で、少なくとも1つのバケットを設定します。バケットとは、ファイル形式とincludeパターンを組み合わせたもので、翻訳対象のコンテンツがどこにあるかをCLIに伝えます。
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}[locale] プレースホルダーは、実行時に設定済みのロケールコードへ展開されます。たとえば、ソース言語には locales/en.json、スペイン語には locales/es.json が使われます。
サポートされているファイル形式と各バケット設定の一覧は、Supported Formats を参照してください。
ステップ3. 翻訳バックエンドに接続する#
翻訳を生成するには、CLIに翻訳バックエンドが必要です。方法は2つあります。
Lingo.dev上の ローカライゼーションエンジン は、すべての翻訳リクエストに ブランドボイス、glossary、instructions、model configuration を自動で適用します。
export LINGO_API_KEY="your-api-key"追加設定は不要です。CLIは組織のデフォルトのローカライゼーションエンジンを使用します。特定のエンジンを指定するには、i18n.json に engineId を追加してください。
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}ステップ4. 翻訳を生成する#
npx lingo.dev@latest runCLIはソースファイルを検出し、翻訳可能なコンテンツを抽出して、設定済みの翻訳バックエンドへ送信し、その結果をディスクに書き戻します。翻訳済みの内容を追跡するために i18n.lock ファイルが作成されるので、ロケールファイルとあわせてコミットしてください。
