언어 추가 · Lingo.dev

i18n.json의 targets 배열을 업데이트한 뒤 CLI를 실행하면 새 대상 언어를 추가할 수 있습니다. 새 로캘에는 전체 번역 파일이 생성되고, 기존 번역은 그대로 유지됩니다.

언어 추가#

i18n.json 설정을 업데이트하세요:

json

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

CLI를 실행하세요:

bash

npx lingo.dev@latest run

CLI는 새 로캘마다 전체 번역 파일을 생성합니다:

text

locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

기존 언어와 새 언어의 차이#

CLI는 기존 언어와 새 언어를 서로 다르게 처리합니다:

	기존 언어	새 언어
동작	누락된 키만 번역	전체 파일을 처음부터 생성
기존 콘텐츠	유지됨	해당 없음

지역별 변형#

CLI는 BCP 47 태그를 사용하는 지역별 언어 변형을 지원합니다:

json

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

각 변형마다 해당 지역에 맞는 용어, 철자, 어조를 반영한 별도의 번역 파일이 생성됩니다.

선택적 생성#

모든 대상을 처리하지 않고 특정 언어에 대해서만 번역을 생성할 수 있습니다:

bash

npx lingo.dev@latest run --target-locale de

언어를 하나씩 추가하면서 품질을 검토한 뒤 점차 확대하고 싶을 때 유용합니다.

언어 제거#

targets 배열에서 로캘을 제거하면 CLI는 더 이상 해당 로캘을 처리하지 않습니다. 기존 파일은 삭제되지 않으므로 필요하면 직접 제거하세요.

다음 단계#