Выбор конфигурации по локали

Узнайте, какая сохранённая конфигурация применяется к запрошенному языку, региону или письменности и как её используют инструкции, тональность бренда, модели и терминология.

Для запроса используется конфигурация, сохранённая для его локали, для более общей локали, которая её включает, и для *. Конфигурация для более конкретной локали или другого региона того же языка не применяется. Дальше всё зависит от ресурса: инструкции объединяются, выбирается один вариант тональности бренда, модели выстраиваются в цепочку последовательных попыток, а пользовательский перевод должен ещё и соответствовать письменности запроса.

О том, как выбрать языковые теги, читайте в разделе Языки. В этом справочнике описано, что происходит, когда эти теги поступают в движок локализации.

Какая конфигурация применяется #

При обработке локалей данные 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-CH для запроса de, и другого региона того же языка, например de-DE для запроса de-CH.

ЗапросПрименяетсяНе применяется
es*, es, es-ESes-MX, es-419
es-MX*, es, es-MXes-ES, es-419
de-CH*, de, de-CHde-DE, de-AT
zh-TW*, zh, zh-Hant, zh-TWzh-Hans, zh-CN
sr*, sr, sr-Cyrlsr-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. На непереводимое название это ограничение не распространяется: оно остаётся без изменений.

Пользовательский перевод задан для всех языков #

В пользовательском переводе с целевой локалью * текст перевода не может отличаться от исходного. Для предпочтительного перевода укажите конкретную целевую локаль, а для текста, который должен везде оставаться одинаковым, создайте непереводимую запись.

При добавлении локали проверьте каждый компонент #

Языковая конфигурация не обеспечивает вёрстку справа налево или форматирование данных в приложении с учётом локали. Вместе с переводом проверьте, как выглядит интерфейс. Удачный пример подтверждает поведение только в конкретном случае, а не общее качество для новой локали.