모든 용어집 용어, 브랜드 보이스 텍스트, 규칙, 모델 구성은 각각 특정 로캘에 저장됩니다. 엔진이 번역 요청을 처리하면 요청 로캘에 어떤 저장 항목이 적용되는지 결정합니다. 여기에는 정확히 일치하는 코드 매칭, 지역 변형 간 상속, 그리고 정확한 일치 항목이 없을 때의 폴백이 포함됩니다. 이 해석 방식은 네 가지 구성 영역 전체에 동일하게 적용됩니다.
작동 방식#
로캘은 입력 시 표준 형식으로 정규화되며, 저장되고 반환될 때도 그 형식을 유지합니다. 대소문자와 구분자는 정리되고, 하위 태그는 그대로 보존됩니다.
| 입력값 | 저장 형식 |
|---|---|
EN | en |
en_US | en-US |
sr_Latn-RS | sr-Latn-RS |
zh-cn | zh-CN |
매칭은 하위 태그 경계를 기준으로 양방향으로 이루어집니다. 저장된 로캘은 둘 중 하나가 정확히 일치하거나, 한쪽이 다른 쪽의 상위 로캘인 경우 요청에 적용됩니다. 같은 로캘의 서로 다른 표기 역시, 어느 쪽도 다른 쪽의 상위 로캘이 아니어도 일치할 수 있습니다. 다만 이 경우에는 지역이 스크립트를 결정하므로, 지역만 지정한 형식과 스크립트를 명시한 형식은 동등하게 취급됩니다 (zh-CN ≡ zh-Hans-CN, zh-TW ≡ zh-Hant-TW).
| 저장된 값 | 적용 대상 | 적용되지 않는 대상 |
|---|---|---|
de | de, de-DE, de-AT, de-CH | - |
de-DE | de-DE, de | de-AT, de-CH (형제 관계) |
zh-CN | zh-CN, zh-Hans-CN, zh | zh-TW, zh-Hant-TW (서로 다른 스크립트) |
역방향 상속
저장된 de-DE가 기본 de 요청에 응답하는 패턴은 실제로 가장 흔합니다. 대부분의 엔진은 전체 지역 코드 기준으로 설정되지만, 들어오는 요청은 기본 코드인 경우가 많기 때문입니다. 두 방향 모두 지원됩니다.
여러 일치 항목이 있을 때의 결정 방식#
적용 가능한 저장 항목이 둘 이상이면, 엔진은 우선순위를 매겨 가장 적합한 항목을 선택합니다.
- 정확히 일치하거나 언어 기본값이 먼저입니다.
de요청의 경우de-DE(독일어의 CLDR 기본 지역)가 우선되고, 그다음은 기본de입니다. - 그다음은 가장 구체적인 항목이며, 동률을 가르는 기준으로 사용됩니다.
- 그 외 일치하는 다른 지역도 폴백으로 유지됩니다. 고객의 유일한 항목이
de-CH뿐이어도 더 적합한 항목이 없으면de요청에 그대로 적용되므로, 설정이 고아 상태로 남지 않습니다.
| 요청 | 우선 선택 | 추가 적용 가능(폴백) | 제외됨 |
|---|---|---|---|
de | de-DE, 그다음 de | de-CH, de-AT | - |
de-DE | de-DE, 그다음 de | - | de-AT, de-CH |
de-AT | de-AT, 그다음 de | - | de-DE, de-CH |
순위와 선택의 차이#
위 순위는 여러 항목을 함께 쓰는 영역에서는 정렬 순서를, 하나만 고르는 영역에서는 최종 선택 항목을 결정합니다:
| 영역 | 순위의 역할 |
|---|---|
| 용어집 | 일치하는 모든 용어를 가져올 수 있으며, 실제로 프롬프트에 들어갈 항목은 의미적 관련성에 따라 결정됩니다 |
| 규칙 | 일치하는 모든 규칙이 포함되며, 가장 잘 맞는 로캘이 먼저 적용됩니다 |
| 브랜드 보이스 | 가장 잘 맞는 단 하나의 텍스트가 선택되며, 요청마다 브랜드 보이스 텍스트는 하나만 적용됩니다 |
| 모델 구성 | 가장 잘 맞는 항목이 기본 모델이 되고, 나머지는 폴백 체인을 이룹니다 |
스크립트 안전성#
추가 규칙 하나는 텍스트가 특정 정서법에 연결되는 용어집 custom_translation 항목에만 적용됩니다. 사용 가능한 문자 체계가 모호한 기본 언어, 예를 들어 sr(키릴 문자 또는 라틴 문자), zh(간체 또는 번체)는 저장 시 반드시 문자 체계를 확정해야 합니다. 방법은 명시적으로 문자 체계를 지정하는 것(zh-Hans, sr-Cyrl)이거나, 문자 체계를 결정해 주는 지역을 지정하는 것(zh-CN → 간체, sr-RS → 키릴 문자, CLDR 기준)입니다. 문자 체계도 지역도 없는 완전히 기본 코드만 거부됩니다. 조회 시에는 이런 확정 형태가 서로 동등하게 취급됩니다. 즉 zh-Hans-CN로 저장된 용어는 zh-CN 요청에 적용되며, 그 반대도 마찬가지입니다. 하지만 문자 체계를 알 수 없는 기본 zh 요청은 문자 체계가 확정된 항목을 가져오지 않으므로, 일관된 결과를 원한다면 명시적인 문자 체계나 지역을 함께 보내야 합니다. de처럼 문자 체계가 하나뿐인 언어는 문자 체계를 따로 지정할 필요가 없고, de에서 de-DE으로 일반적으로 해석됩니다. non_translatable 항목은 문자 체계와 관계없이 그대로 통과합니다.
예시#
지역 코드(en-US에서 fr-FR, de-DE, nb-NO) 기준으로 설정된 엔진이 기본 코드 요청(fr, de, no)을 받는 경우:
fr대상은fr-FR에 저장된 용어집 용어, 브랜드 보이스 텍스트, 규칙을 가져옵니다. 이는 최후의 폴백이 아니라fr의 기본값으로 순위가 매겨지는데, 프랑스어의 CLDR 기본 지역이fr-FR이기 때문입니다.en소스는en-US항목과 매칭됩니다. 매칭은 양방향입니다.no대상은nb-NO를 가져오지 않습니다.no와nb는 지역 쌍이 아니라 서로 다른 언어 하위 태그이므로, 대상에는nb를 사용해야 합니다.
API에서 로캘 결정 방식 활용하기#
localize endpoint를 호출하면 이 해석은 자동으로 수행됩니다. 엔진은 요청의 sourceLocale와 targetLocale을 기준으로, 적용 가능한 용어집 용어, 브랜드 보이스 텍스트, 규칙, 모델 구성을 매칭합니다. 추가 파라미터는 필요하지 않습니다.
