Resolução de idioma
Entenda qual configuração salva se aplica ao idioma, à região ou ao sistema de escrita solicitado e como instruções, voz, modelos e terminologia usam essa configuração.
Uma solicitação usa a configuração salva para seu próprio idioma, para um idioma mais abrangente que o engloba e para *. Configurações salvas para um idioma mais específico ou para outra região da mesma língua não se aplicam. O tratamento da configuração aplicável depende do recurso: as instruções se acumulam, uma variação de voz prevalece, os modelos formam uma sequência ordenada de tentativas e uma tradução personalizada também precisa usar o sistema de escrita da solicitação.
Para saber como escolher as tags de idioma, leia Idiomas. Esta referência explica o que acontece depois que essas tags chegam ao engine de localização.
Qual configuração se aplica #
O tratamento de idiomas usa dados do CLDR para reconhecer notações equivalentes como um único idioma: zh, zh-CN, zh-Hans e zh-Hans-CN identificam o chinês simplificado usado na China. Um idioma sem região representa sua região padrão. Uma solicitação para es corresponde ao espanhol usado na Espanha (es-ES), pt representa pt-BR e de representa de-DE.
Uma configuração se aplica à solicitação quando o idioma dessa configuração é um dos seguintes:
*, que se aplica a todos os idiomas.- O idioma solicitado, em qualquer notação equivalente.
- Um idioma mais abrangente que engloba o solicitado.
dese aplica ade-CHezh-Hantse aplica azh-TW.
Qualquer outro idioma fica de fora. Isso inclui uma região mais específica, como de-CH para uma solicitação de de, e outra região da mesma língua, como de-DE para uma solicitação de de-CH.
| Solicitação | Aplica-se | Não se aplica |
|---|---|---|
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 |
Um grupo de regiões como es-419 é tratado como um idioma distinto. Ele se aplica apenas a solicitações de es-419, portanto, solicitações de es-MX ou es-AR não recebem essa configuração.
A mesma regra vale para o idioma de origem nos recursos que o especificam: configurações de modelo e termos do glossário. Um termo salvo para o idioma de origem en-GB não se aplica a conteúdo com idioma de origem en, pois en representa en-US.
Para compartilhar orientações entre todas as regiões de uma língua, salve-as para o idioma sem região, como es. Salve-as para uma região apenas quando forem específicas do público dessa região.
Os níveis de correspondência ordenam a configuração aplicável #
O engine de localização organiza a configuração aplicável em níveis de correspondência: primeiro o idioma solicitado, depois um idioma mais abrangente e, por fim, *. Dentro de cada nível, a notação mais específica vem primeiro. Assim, para uma solicitação de de, uma variação de de-DE tem prioridade sobre uma variação de de.
Especifique a região no idioma quando isso fizer parte do requisito. Também preserve a distinção entre identificadores de idiomas: no e nb são códigos diferentes, e a configuração salva para um não se aplica ao outro.
Cada recurso usa a configuração aplicável de forma diferente #
| Recurso | Resultado |
|---|---|
| Regras | As instruções predefinidas e personalizadas aplicáveis se acumulam em ordem de relevância para o idioma. Regras específicas não anulam as mais abrangentes. |
| Voz da marca | A variação com a melhor correspondência prevalece. Se ainda houver empate, a data e a hora de criação e, depois, o ID garantem um desempate consistente. |
| Modelos | O nível de correspondência do destino, o nível de correspondência da origem, a especificidade do destino, a especificidade da origem e a classificação configurada determinam a ordem das tentativas. |
| Glossário | Traduções personalizadas em outro sistema de escrita ficam de fora. Após a classificação por idioma, as duplicatas entre os candidatos restantes são removidas com base no texto de origem. Em seguida, a recuperação seleciona o contexto aplicável. |
| Revisão humana | Uma solicitação passa por revisão quando um dos idiomas da política de revisão se aplica a ela ou quando a política não especifica nenhum idioma. |
A classificação do modelo não pode colocar uma configuração curinga à frente de uma correspondência de idioma mais próxima. A ordem de vinculação dos glossários não define a precedência. Lembre-se dessas diferenças quando a configuração salva contiver o material esperado, mas a solicitação selecionar outra opção.
Diagnostique uma incompatibilidade de região ou sistema de escrita #
As orientações salvas para uma região não aparecem em outra #
Suponha que os termos em espanhol de um glossário estejam salvos para es-419 e que as solicitações tenham como destino es ou es-MX. Nenhuma delas recebe os termos: es representa a Espanha e es-419 se aplica apenas a solicitações de es-419. Salve os termos comuns a todos os públicos de língua espanhola para es ou salve-os para cada região solicitada. O português funciona da mesma forma: pt representa o Brasil, então os termos salvos para pt-PT chegam apenas às solicitações de pt-PT.
A voz é regional, mas a solicitação não especifica região #
Suponha que uma voz tenha variações de de-DE e de-CH e que a solicitação tenha como destino de. A solicitação recebe a variação de de-DE, pois de representa o alemão usado na Alemanha. A variação de de-CH se aplica apenas a solicitações de de-CH. Para conteúdo destinado à Suíça, solicite de-CH em vez de esperar que o engine de localização deduza o público a partir da origem.
Uma regra regional contradiz uma regra abrangente #
Uma regra curinga que exige tratamento formal e uma regra regional aplicável que pede tratamento informal podem aparecer juntas no prompt. Adicionar especificidade não cancela o requisito mais abrangente. Elimine a contradição ou restrinja seu alcance para que as instruções selecionadas definam um único comportamento esperado.
O termo preferencial usa outro sistema de escrita #
Uma tradução personalizada só se aplica quando seus idiomas correspondem aos mesmos sistemas de escrita dos idiomas da solicitação, tanto na origem quanto no destino. O sistema de escrita de cada idioma é determinado pelos padrões do CLDR: zh, zh-CN e zh-SG correspondem ao chinês simplificado, zh-TW e zh-HK ao chinês tradicional, sr ao cirílico e sr-ME ao latino.
Assim, um termo salvo para zh chega às solicitações de zh, zh-CN e zh-SG, mas nunca a uma solicitação de zh-TW, embora as regras e a voz salvas para zh se apliquem a zh-TW. Um termo salvo para zh-Hans chega a uma solicitação de zh, e um termo salvo para zh-TW chega a uma solicitação de zh-Hant. Salve um termo em chinês tradicional compartilhado por Taiwan e Hong Kong para zh-Hant. Um nome não traduzível é uma exceção, pois permanece inalterado.
A tradução personalizada tem todos os idiomas como destino #
Uma tradução personalizada com destino * não pode ter texto de destino diferente do texto de origem. Use um idioma de destino específico para uma tradução preferencial ou uma entrada não traduzível para um texto que deve permanecer igual em todos os lugares.
Verifique cada parte ao adicionar um idioma #
A configuração de idioma não implementa um layout da direita para a esquerda nem adapta a formatação da aplicação ao idioma. Verifique a interface renderizada junto com a tradução. Uma amostra útil demonstra o comportamento naquele caso, não a qualidade geral no novo idioma.