CLI 버전 0 로캘 추가 및 관리
필요한 언어 변형을 선택하고 레거시 번역 대상을 추가한 뒤, 파일과 애플리케이션이 올바르게 동작하는지 확인하세요.
버전 0에서 locale.source은 원본 언어를 지정하고, locale.targets는 반복 실행 시 번역할 대상을 선택합니다. 독자에게 필요한 언어 변형을 선택한 다음, 설정, 파일 이름, 백엔드, 애플리케이션에서 모두 일관되게 사용하는지 확인하세요.
번역 대상 하나 추가 #
기존에 지원하는 스페인어와 프랑스어에 독일어를 추가하려면 i18n.json을 수정하세요.
{
"locale": { "source": "en", "targets": ["es", "fr", "de"] }
}해당 대상을 지정해 설치된 버전 0 바이너리를 실행하세요.
lingo run --target-locale de이 플래그는 이번 실행에 한해 대상 목록을 재정의하며, 설정에 없는 로캘도 선택할 수 있습니다. 이후 실행에서도 사용하려면 설정에 추가하세요. 별도 파일 패턴 locales/[locale].json을 사용하면 locales/de.json 파일에 기록됩니다. 독자에게 독일어를 제공하기 전에 값을 살펴보고 애플리케이션에서 해당 파일을 불러오세요.
대상이 아직 없으면 선택한 모든 키를 채워야 합니다. 대상이 이미 있으면 일반적으로 기존 값을 유지하고 누락된 키만 채우지만, 원문이 바뀌었다면 다시 번역해야 할 수도 있습니다. 이미 승인된 다른 로캘을 그대로 유지해야 한다면, 새 언어를 처음 추가할 때 광범위한 강제 처리를 함께 적용하지 마세요.
실행 범위를 특정 대상 로캘로 제한해도 기존 원문 체크섬 기준값은 갱신되지 않습니다. 이후 일반 실행에서 변경된 원문을 다시 처리할 수 있으므로, 범위를 제한한 검토만으로 처리가 영구히 확정된다고 판단하기 전에 확정 규칙을 확인하세요.
필요한 경우 지역과 문자 체계 구분 #
{
"locale": {
"source": "en-US",
"targets": ["en-GB", "es-MX", "pt-BR", "fr-CA"]
}
}지역을 지정한 로캘은 필요한 지역별 언어 관례를 구분합니다. 영어에서 색상을 뜻하는 단어의 미국식·영국식 철자 차이, 스페인어에서 컴퓨터를 뜻하는 오르데나도르·콤푸타도라, 포르투갈어에서 기차를 뜻하는 트렝·콤보이우는 언어만 선택해서는 충분하지 않을 수 있음을 보여 줍니다. 실제 용법은 문맥에 따라 달라지므로, 태그가 있다고 해서 생성된 모든 표현이 독자에게 적합하다는 보장은 없습니다. 중국어도 zh-Hans 또는 zh-TW처럼 문자 체계나 지역을 구분해야 할 수 있습니다.
설치된 버전에서 제공하는 목록을 확인하세요.
lingo show locale sources
lingo show locale targets이 목록이 모든 백엔드에서의 지원이나 품질을 보장하지는 않습니다. 과거의 지원 언어 수에 의존하기보다는, 선택한 언어 쌍으로 소규모 실행을 해 보고 검증한 뒤 범위를 넓히세요.
언어 식별과 파일 구조 분리 #
레거시 처리에서는 API 요청에 사용할 여러 플랫폼별 표기를 정규화합니다. 하지만 파일에는 여전히 밑줄이나 안드로이드 리소스 명명 규칙이 필요할 수 있습니다. 구분자 설정과 형식별 파일 구조를 활용하고, 실제 출력 위치를 확인하세요.
번역만으로 dir이 설정되거나, 컨트롤이 좌우 반전되거나, 라우팅이 추가되지는 않습니다. 아랍어, 히브리어, 페르시아어, 우르두어는 일반적으로 오른쪽에서 왼쪽으로 표시해야 합니다. 콘텐츠를 표시하는 인터페이스에서 삽입된 숫자와 식별자까지 확인하세요. 애플리케이션은 새 로캘의 콘텐츠를 불러오는 것은 물론, 해당 로캘 자체도 인식해야 합니다.
번역 대상 제거 #
locale.targets에서 코드를 제거하면 이후 실행에서는 해당 대상이 선택되지 않습니다. 기존 파일은 그대로 남습니다. 파일을 보관할지, 제공을 중단할지, 삭제할지는 별도로 결정하세요. 전체 삭제는 데이터를 파괴하는 작업이며 원본 콘텐츠도 선택 대상이 될 수 있습니다. 설정된 로캘을 제거하는 것과는 다른 작업입니다.