サポートされているロケール

Lingo.dev CLIは、言語識別の国際標準に準拠したロケールコードをサポートしています。i18n.json設定では、シンプルな言語コード、地域バリアント、プラットフォーム固有のフォーマットを使用できます。

CLIは、さまざまなプロジェクト要件やプラットフォーム規則に対応するため、複数のフォーマットのロケールコードを受け入れます。

ロケールコードのフォーマット

Lingo.dev CLIは、複数のロケールコードフォーマットをサポートしています:

シンプルな言語コード（ISO 639-1）:

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja", "zh"]
  }
}

地域バリアント（BCP 47）:

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-419", "fr-FR", "fr-CA"]
  }
}

プラットフォーム固有のフォーマット:

{
  "locale": {
    "source": "en",
    "targets": ["en-rUS", "es-rES", "pt-rBR"]
  }
}

サポートされているロケールの確認

利用可能なすべてのロケールコードを確認するには、次のCLIコマンドを使用してください:

サポートされているソース言語の一覧:

npx lingo.dev@latest show locale sources

サポートされているターゲット言語の一覧:

npx lingo.dev@latest show locale targets

これらのコマンドは、設定で使用できるロケールコードの完全なリストを表示します。

一般的なロケールの例

主要言語:

en - 英語
es - スペイン語
fr - フランス語
de - ドイツ語
ja - 日本語
zh - 中国語
ko - 韓国語
pt - ポルトガル語
it - イタリア語
ru - ロシア語

地域バリアント:

en-US - 英語（米国）
en-GB - 英語（英国）
es-ES - スペイン語（スペイン）
es-419 - スペイン語（ラテンアメリカ）
fr-FR - フランス語（フランス）
fr-CA - フランス語（カナダ）
zh-CN - 中国語（簡体字）
zh-TW - 中国語（繁体字）

地域バリアント

地域バリアントを使用すると、同じ言語内の文化的および言語的な違いを考慮した、ローカライズされたコンテンツで特定の市場をターゲットにすることができます。

設定例：

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-419", "pt-BR", "pt-PT"]
  }
}

生成されるファイル構造：

locales/
  en-US.json    (source)
  en-GB.json    (British English)
  es-ES.json    (Spanish Spain)
  es-419.json   (Latin American Spanish)
  pt-BR.json    (Brazilian Portuguese)
  pt-PT.json    (European Portuguese)

各地域バリアントは、その特定の市場の用語と文化的コンテキストに最適化された翻訳を受け取ります。

**ラテンアメリカスペイン語（es-419）**は、個々の国に特化したものではなく、地域全体で機能する用語と表現を使用して、ラテンアメリカのスペイン語圏の国々をカバーします。

プラットフォーム固有のフォーマット

一部のプラットフォームは異なるロケールコード規則を使用します。Lingo.dev CLIはこれらのフォーマットをサポートしています：

Androidリソースディレクトリ：

{
  "locale": {
    "source": "en",
    "targets": ["es-rES", "pt-rBR", "zh-rCN"]
  },
  "buckets": {
    "android": {
      "include": ["android/values-[locale]/strings.xml"]
    }
  }
}

iOS Localizable.strings：

{
  "locale": {
    "source": "en",
    "targets": ["es", "pt-BR", "zh-Hans"]
  },
  "buckets": {
    "xcode-strings": {
      "include": ["ios/[locale].lproj/Localizable.strings"]
    }
  }
}

文字体系バリアント

複数の表記体系を持つ言語の場合、スクリプトコードを使用します：

zh-Hans - 中国語（簡体字）
zh-Hant - 中国語（繁体字）
sr-Cyrl - セルビア語（キリル文字）
sr-Latn - セルビア語（ラテン文字）

設定例：

{
  "locale": {
    "source": "en",
    "targets": ["zh-Hans", "zh-Hant", "sr-Cyrl", "sr-Latn"]
  }
}

新しいロケールの追加

Lingo.dev CLIは現在80以上のロケールをサポートしており、コミュニティからのリクエスト後、迅速に新しいロケールのサポートを追加しています。

必要なロケールコードがサポートされていない場合は、Lingo.dev CLIリポジトリでissueを開いてリクエストできます。ほとんどのリクエストは数日以内に実装およびリリースされます。