지원되는 로케일 - Lingo.dev CLI

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 저장소에서 이슈를 열어 요청할 수 있습니다. 대부분의 요청은 며칠 내에 구현되어 릴리스됩니다.