Webアプリのローカライゼーション

Lingo.dev のCLIは、Web アプリのリソースファイル（JSON、YAML、XLIFF、PO、PHP）を、設定済みのローカライゼーションエンジン経由で翻訳します。フレームワークで i18n を設定し、CLI で翻訳ファイルを指定して実行するだけです。

仕組み#

どの Web フレームワークにも、リソースファイルから翻訳を読み込む i18n ライブラリがあります。たとえば React では JSON、Angular では XLIFF、Django では PO を使います。CLI はそれらのファイルを直接翻訳するため、コードを変更しなくてもフレームワーク側でそのまま翻訳を取り込めます。

前提条件#

CLI を実行するたびに、コンテンツはローカライゼーションエンジンを通ります。これは、どの LLM モデル、用語集、ブランドボイス、指示を適用するかを決める設定です。Lingo.dev のダッシュボードで作成し、APIキーを生成してください。

JavaScript フレームワーク#

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "json": {
      "include": ["public/locales/[locale]/translation.json"]
    }
  }
}

サーバーサイドフレームワーク#

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "php": {
      "include": ["lang/[locale]/messages.php"]
    }
  }
}

翻訳の実行#

i18n.jsonを設定すれば、1 つのコマンドですべてのリソースファイルを翻訳できます。

npx lingo.dev@latest run

CLI はソースロケールのファイルを読み込み、前回の実行以降の変更をlockfileで判定し、差分だけを翻訳して対象ロケールのファイルに書き込みます。既存の翻訳は保持され、CLI が補完するのは未翻訳または更新された文字列だけです。

一部だけ作業したい場合は、特定のロケールまたは bucket を対象にできます。

npx lingo.dev@latest run --target-locale es
npx lingo.dev@latest run --bucket json

次のステップ#