로캘 결정
요청한 언어, 지역, 문자 체계에 어떤 저장된 설정이 적용되는지, 지침, 보이스, 모델, 용어가 해당 설정을 어떻게 사용하는지 알아보세요.
요청에는 요청한 로캘, 이를 포함하는 더 넓은 범위의 로캘, *에 저장된 설정이 사용됩니다. 더 구체적인 로캘이나 같은 언어의 다른 지역에 저장된 설정은 적용되지 않습니다. 적용되는 설정을 처리하는 방식은 리소스마다 다릅니다. 지침은 누적되고, 보이스 변형은 하나만 선택되며, 모델은 순서대로 시도할 목록을 구성합니다. 사용자 지정 번역은 요청과 문자 체계도 같아야 합니다.
언어 태그를 선택하는 방법은 언어를 참조하세요. 이 레퍼런스에서는 해당 태그가 로컬라이제이션 엔진에 전달된 이후의 처리 방식을 설명합니다.
어떤 설정이 적용되나요 #
로캘을 처리할 때는 CLDR 데이터를 바탕으로 같은 의미의 표기를 하나의 로캘로 취급합니다. zh, zh-CN, zh-Hans, zh-Hans-CN는 모두 중국에서 사용하는 중국어 간체를 가리킵니다. 지역이 명시되지 않은 로캘은 기본 지역을 나타냅니다. es 요청은 스페인에서 사용하는 스페인어(es-ES) 요청이며, pt는 pt-BR를, de는 de-DE를 나타냅니다.
설정의 로캘이 다음 중 하나에 해당하면 그 설정이 요청에 적용됩니다.
- 모든 로캘에 적용되는
*. - 요청한 로캘. 같은 의미의 다른 표기도 포함됩니다.
- 요청한 로캘을 포함하는 더 넓은 범위의 로캘.
de는de-CH에,zh-Hant는zh-TW에 적용됩니다.
그 밖의 로캘은 제외됩니다. de 요청에 대한 de-CH처럼 더 구체적인 지역이나, de-CH 요청에 대한 de-DE처럼 같은 언어의 다른 지역도 여기에 해당합니다.
| 요청 | 적용됨 | 적용되지 않음 |
|---|---|---|
es | *, es, es-ES | es-MX, es-419 |
es-MX | *, es, es-MX | es-ES, es-419 |
de-CH | *, de, de-CH | de-DE, de-AT |
zh-TW | *, zh, zh-Hant, zh-TW | zh-Hans, zh-CN |
sr | *, sr, sr-Cyrl | sr-Latn |
es-419 같은 지역 그룹은 그 자체로 하나의 로캘입니다. es-419 요청에만 적용되며, es-MX 또는 es-AR 요청에는 적용되지 않습니다.
소스 로캘을 갖는 리소스인 모델 설정과 용어집 용어에서는 소스 로캘에도 같은 규칙이 적용됩니다. 소스 로캘이 en-GB인 용어는 소스 로캘이 en인 콘텐츠에 적용되지 않습니다. en는 en-US를 나타내기 때문입니다.
한 언어의 모든 지역에서 지침을 공유하려면 es처럼 지역 없이 언어만 지정해 저장하세요. 특정 지역의 대상 사용자에게만 해당하는 지침이라면 그 지역을 지정해 저장하세요.
일치 등급에 따라 적용할 설정의 순서가 정해집니다 #
로컬라이제이션 엔진은 적용 가능한 설정을 일치 등급별로 정렬합니다. 요청한 로캘이 먼저 오고, 더 넓은 범위의 로캘, * 순으로 이어집니다. 같은 등급 안에서는 더 구체적인 표기가 우선합니다. 따라서 de 요청에서는 de-DE 변형이 de 변형보다 앞섭니다.
특정 지역을 대상으로 해야 한다면 지역이 명시된 로캘을 사용하세요. 서로 다른 언어 식별자도 명확히 구분하세요. no와 nb는 서로 다른 코드이므로 한쪽에 저장된 설정은 다른 쪽에 적용되지 않습니다.
리소스마다 적용 가능한 설정을 사용하는 방식이 다릅니다 #
| 리소스 | 결과 |
|---|---|
| 규칙 | 적용 가능한 사전 정의 지침과 사용자 지정 지침이 로캘 관련성 순으로 누적됩니다. 구체적인 규칙이 더 넓은 범위의 규칙을 없애지는 않습니다. |
| 브랜드 보이스 | 가장 잘 일치하는 변형이 선택됩니다. 그래도 동률이면 생성 시각, 식별자 순으로 비교해 결과를 일관되게 결정합니다. |
| 모델 | 대상 로캘의 일치 등급, 소스 로캘의 일치 등급, 대상 로캘의 구체성, 소스 로캘의 구체성, 설정된 순위에 따라 시도 순서가 결정됩니다. |
| 용어집 | 문자 체계가 다른 사용자 지정 번역은 제외됩니다. 남은 후보는 로캘별 순위를 정한 뒤 소스 텍스트를 기준으로 중복을 제거합니다. 이후 검색 과정에서 적용할 문맥을 선택합니다. |
| 휴먼 리뷰 | 검토 정책에 지정된 언어 중 하나가 요청에 적용되거나 정책에 지정된 언어가 없으면 해당 요청을 검토합니다. |
모델 순위를 조정해도 와일드카드 설정이 더 가깝게 일치하는 로캘 설정보다 앞설 수는 없습니다. 용어집을 연결한 순서도 우선순위를 결정하지 않습니다. 저장된 설정에 원하는 내용이 있는데도 요청에서 다른 항목이 선택된다면 이러한 차이를 확인하세요.
지역 또는 문자 체계 불일치 진단 #
한 지역에 저장한 지침이 다른 지역에는 적용되지 않습니다 #
용어집의 스페인어 용어가 es-419에 저장되어 있고 요청 대상이 es 또는 es-MX라고 가정해 보겠습니다. 어느 요청에도 해당 용어가 적용되지 않습니다. es는 스페인을 나타내고, es-419는 es-419 요청에만 적용되기 때문입니다. 모든 스페인어 사용자가 공통으로 사용하는 용어는 es에 저장하거나 요청하는 각 지역에 따로 저장하세요. 포르투갈어도 마찬가지입니다. pt는 브라질을 나타내므로 pt-PT에 저장된 용어는 pt-PT 요청에만 적용됩니다.
보이스에는 지역이 지정되어 있지만 요청에는 없습니다 #
보이스에 de-DE와 de-CH 변형이 있고 요청 대상이 de라고 가정해 보겠습니다. 이 요청에는 de-DE 변형이 적용됩니다. de는 독일에서 사용하는 독일어를 나타내기 때문입니다. de-CH 변형은 de-CH 요청에만 적용됩니다. 스위스 사용자를 위한 콘텐츠라면 로컬라이제이션 엔진이 소스에서 대상 사용자를 추론하기를 기대하지 말고 de-CH로 요청하세요.
지역별 규칙이 더 넓은 범위의 규칙과 충돌합니다 #
격식체를 요구하는 와일드카드 규칙과 비격식체를 요구하는 지역별 규칙이 모두 요청에 적용되어 프롬프트에 함께 포함될 수 있습니다. 더 구체적인 규칙을 추가해도 더 넓은 범위의 요구 사항이 취소되지는 않습니다. 선택된 지침이 의도한 하나의 동작을 가리키도록 모순되는 내용을 없애거나 적용 범위를 좁히세요.
선호하는 용어의 문자 체계가 다릅니다 #
사용자 지정 번역은 소스와 대상 양쪽 모두에서 로캘이 나타내는 문자 체계가 요청의 문자 체계와 같을 때만 적용됩니다. 각 로캘의 문자 체계는 CLDR 기본값에 따라 정해집니다. zh, zh-CN, zh-SG는 간체를, zh-TW와 zh-HK는 번체를, sr는 키릴 문자를, sr-ME는 라틴 문자를 나타냅니다.
따라서 zh에 저장된 용어는 zh, zh-CN, zh-SG 요청에는 적용되지만 zh-TW 요청에는 적용되지 않습니다. zh에 저장된 규칙과 보이스가 zh-TW에 적용되더라도 용어는 그렇지 않습니다. zh-Hans에 저장된 용어는 zh 요청에, zh-TW에 저장된 용어는 zh-Hant 요청에 적용됩니다. 대만과 홍콩에서 공통으로 사용하는 번체 용어는 zh-Hant에 저장하세요. 번역하지 않는 이름은 그대로 유지되므로 예외입니다.
사용자 지정 번역이 모든 언어를 대상으로 합니다 #
대상이 *인 사용자 지정 번역에는 소스와 다른 대상 텍스트를 지정할 수 없습니다. 선호하는 번역을 지정하려면 구체적인 대상 로캘을 사용하세요. 어디서나 동일하게 유지해야 하는 텍스트는 번역하지 않는 항목으로 등록하세요.
로캘을 추가할 때 각 부분을 확인하세요 #
언어 설정만으로는 오른쪽에서 왼쪽으로 쓰는 레이아웃이나 로캘에 맞는 애플리케이션 서식이 구현되지 않습니다. 번역과 함께 실제로 렌더링된 인터페이스도 확인하세요. 샘플을 통해 확인할 수 있는 것은 해당 사례의 동작이며, 새 로캘 전반의 품질은 아닙니다.