対応フォーマット

Lingo.dev CLI は、さまざまなファイル形式を解析・翻訳するためにバケットタイプを使用します。各バケットタイプは、特定の形式に対応した専用パーサーです。CLI が翻訳対象とするファイルを定義するには、i18n.json で 1 つ以上のバケットを設定します。

バケットタイプ#

出力モード#

バケットは、次の 2 つの出力モードのいずれかで動作します。

ロケールごとに別ファイル - CLI はターゲット言語ごとに個別のファイルを生成します。include パターンには [locale] プレースホルダーを含める必要があります。

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}

これにより、locales/en.json、locales/es.json、locales/fr.json などのファイルが生成されます。

ソースファイルを更新 - CLI は、ソースコンテンツを含む同じファイルに翻訳を書き戻します。[locale] プレースホルダーは使いません。

{
  "buckets": {
    "csv": {
      "include": ["translations.csv"]
    }
  }
}

CSV ファイルは通常、1 つのファイル内の列にすべてのロケールを格納します。Xcode .xcstrings カタログや、ルートキーを持つ YAML も同様です。

設定例#

JSON を使った Web アプリ#

{
  "buckets": {
    "json": {
      "include": ["src/locales/[locale].json"],
      "lockedKeys": ["brand/name"]
    }
  }
}

Markdown を使ったドキュメントサイト#

{
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

モバイルアプリ（iOS + Android）#

{
  "buckets": {
    "xcode-xcstrings": {
      "include": ["ios/Localizable.xcstrings"]
    },
    "android": {
      "include": ["android/app/src/main/res/values-[locale]/strings.xml"]
    }
  }
}

複数フォーマットを含むモノレポ#

{
  "buckets": {
    "json": {
      "include": ["apps/web/locales/[locale].json"]
    },
    "mdx": {
      "include": ["packages/docs/content/[locale]/*.mdx"]
    },
    "flutter": {
      "include": ["apps/mobile/lib/l10n/app_[locale].arb"]
    }
  }
}

バケット固有の機能#

一部のバケットでは、include / exclude パターンに加えて、追加機能も利用できます。

include パターンのルール#

• パターンは i18n.json ファイルの場所からの相対パスです
• ロケールコードのプレースホルダーとして [locale] を使います（「ロケールごとに別ファイル」バケットでは必須）
• アスタリスク（*）は任意のファイル名に一致します: locales/[locale]/*.json
• 再帰パターン（**）は、任意の深さにあるファイルに一致します: src/**/[locale].json、config/locales/**/[locale].yml。パターンで ** を使う場合、node_modules、.git、dist、build、.next、.turbo はデフォルトで除外されます。必要に応じて、独自の exclude エントリを追加してください（CLI 0.135.0+ が必要です）
• ファイル拡張子は解析に影響しません。どのパーサーを使うかはバケットタイプで決まります

次のステップ#