지원되는 로케일

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    (소스)
  en-GB.json    (영국 영어)
  es-ES.json    (스페인 스페인어)
  es-419.json   (라틴 아메리카 스페인어)
  pt-BR.json    (브라질 포르투갈어)
  pt-PT.json    (유럽 포르투갈어)

각 지역 변형은 해당 특정 시장의 용어와 문화적 맥락에 최적화된 번역을 받습니다.

**라틴 아메리카 스페인어(es-419)**는 개별 국가에 특화되기보다는 지역 전체에 적용되는 용어와 표현을 사용하여 라틴 아메리카의 스페인어 사용 국가들을 포괄합니다.

플랫폼별 형식

일부 플랫폼은 다른 로케일 코드 규칙을 사용합니다. Lingo.dev CLI는 다음 형식을 지원합니다:

안드로이드 리소스 디렉토리:

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