Resolución de idiomas

Conoce qué configuración guardada se aplica al idioma, la región o el sistema de escritura solicitado, y cómo la usan las instrucciones, la voz, los modelos y la terminología.

Una solicitud usa la configuración guardada para su propio idioma, para un idioma más amplio que lo abarca y para *. No se aplica la configuración guardada para un idioma más específico ni para otra región del mismo idioma. La forma de usar la configuración aplicable depende del recurso: las instrucciones se acumulan, se elige una sola variante de voz, los modelos forman una secuencia ordenada de intentos y las traducciones personalizadas también deben usar el sistema de escritura de la solicitud.

Para elegir las etiquetas de idioma, consulta Idiomas. Esta referencia explica qué ocurre una vez que esas etiquetas llegan al motor de localización.

Qué configuración se aplica #

La gestión de idiomas usa datos de CLDR para tratar las notaciones equivalentes como un mismo idioma: zh, zh-CN, zh-Hans y zh-Hans-CN designan el chino simplificado que se usa en China. Un idioma sin región representa su región predeterminada. Una solicitud de es corresponde al español que se usa en España (es-ES), pt representa pt-BR y de representa de-DE.

Una configuración se aplica a una solicitud cuando su idioma es uno de los siguientes:

  • *, que se aplica a todos los idiomas.
  • El idioma solicitado, en cualquier notación equivalente.
  • Un idioma más amplio que abarca el solicitado. de se aplica a de-CH y zh-Hant se aplica a zh-TW.

Cualquier otro idioma queda excluido. Esto incluye una región más específica, como de-CH para una solicitud de de, y otra región del mismo idioma, como de-DE para una solicitud de de-CH.

SolicitudSe aplicaNo se aplica
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

Un grupo de regiones como es-419 se trata como un idioma independiente. Se aplica solo a solicitudes de es-419, por lo que las solicitudes de es-MX o es-AR no reciben esa configuración.

La misma regla se aplica a los idiomas de origen de los recursos que tienen uno: las configuraciones de modelos y los términos del glosario. Un término guardado para el idioma de origen en-GB no se aplica al contenido cuyo idioma de origen es en, porque en representa en-US.

Para compartir pautas entre todas las regiones de un idioma, guárdalas para el idioma sin región, como es. Guárdalas para una región solo cuando estén dirigidas al público de esa región.

Los niveles de coincidencia ordenan la configuración aplicable #

El motor de localización ordena la configuración aplicable por niveles de coincidencia: primero el idioma solicitado, luego un idioma más amplio y, por último, *. Dentro de cada nivel, la notación más específica va primero. Por eso, en una solicitud de de, una variante de de-DE tiene prioridad sobre una de de.

Especifica la región del idioma cuando sea un requisito. Además, trata los identificadores de idiomas distintos por separado: no y nb son códigos diferentes, y la configuración guardada para uno no se aplica al otro.

Cada recurso usa la configuración aplicable de forma diferente #

RecursoResultado
ReglasLas instrucciones predefinidas y personalizadas aplicables se acumulan en orden de relevancia para el idioma. Las reglas específicas no eliminan las generales.
Voz de marcaSe elige la variante que mejor coincide. Si persiste un empate, se resuelve de forma estable según la fecha de creación y, después, el ID.
ModelosEl nivel de coincidencia del destino, el nivel de coincidencia del origen, la especificidad del destino, la especificidad del origen y la posición configurada determinan el orden de los intentos.
GlosarioSe excluyen las traducciones personalizadas en otro sistema de escritura. Tras ordenar los candidatos restantes por idioma, se eliminan los duplicados según el texto de origen. Luego, el proceso de recuperación selecciona el contexto aplicable.
Revisión humanaUna solicitud se somete a revisión cuando se le aplica uno de los idiomas de la política de revisión o cuando la política no especifica ninguno.

La posición de un modelo no puede colocar una configuración con comodín por delante de una coincidencia de idioma más cercana. El orden en que se adjuntan los glosarios no establece la prioridad. Ten en cuenta estas diferencias cuando la configuración guardada contenga el material esperado, pero una solicitud elija otra cosa.

Diagnostica una discrepancia de región o sistema de escritura #

Las pautas guardadas para una región no aparecen en otra #

Supongamos que los términos en español de un glosario están guardados para es-419 y las solicitudes tienen como destino es o es-MX. Ninguna de las dos recibe los términos: es representa España y es-419 se aplica solo a solicitudes de es-419. Guarda los términos compartidos por todos los públicos de habla hispana para es, o guárdalos para cada región que solicites. Lo mismo ocurre con el portugués: pt representa Brasil, por lo que los términos guardados para pt-PT llegan solo a solicitudes de pt-PT.

La voz es regional, pero la solicitud no especifica una región #

Supongamos que una voz tiene variantes para de-DE y de-CH, y la solicitud tiene como destino de. La solicitud recibe la variante de de-DE, porque de representa el alemán que se usa en Alemania. La variante de de-CH se aplica solo a solicitudes de de-CH. Para contenido dirigido a Suiza, solicita de-CH en lugar de esperar que el motor de localización deduzca el público a partir del origen.

Una regla regional contradice una regla general #

Tanto una regla con comodín que exige un trato formal como una regla regional aplicable que pide un trato informal pueden incorporarse a las instrucciones enviadas al modelo. Agregar especificidad no anula el requisito general. Elimina la contradicción o limita su alcance para que las instrucciones seleccionadas expresen un único comportamiento deseado.

El término preferido usa un sistema de escritura diferente #

Una traducción personalizada solo se aplica cuando sus idiomas implican los mismos sistemas de escritura que los de la solicitud, tanto en el origen como en el destino. Cada idioma implica un sistema de escritura según los valores predeterminados de CLDR: zh, zh-CN y zh-SG implican chino simplificado; zh-TW y zh-HK implican chino tradicional; sr implica el alfabeto cirílico; y sr-ME implica el alfabeto latino.

Por eso, un término guardado para zh llega a solicitudes de zh, zh-CN y zh-SG, pero nunca a una solicitud de zh-TW, aunque las reglas y la voz guardadas para zh se apliquen a zh-TW. Un término guardado para zh-Hans llega a una solicitud de zh, y uno guardado para zh-TW llega a una solicitud de zh-Hant. Guarda para zh-Hant los términos en chino tradicional compartidos por Taiwán y Hong Kong. Un nombre no traducible queda exento porque permanece sin cambios.

La traducción personalizada tiene como destino todos los idiomas #

Una traducción personalizada con destino * no puede contener un texto de destino diferente del original. Usa un idioma de destino concreto para una traducción preferida, o una entrada no traducible para el texto que deba permanecer igual en todas partes.

Verifica cada parte al agregar un idioma #

La configuración de idioma no implementa el diseño de derecha a izquierda ni los formatos de la aplicación adaptados al idioma. Verifica tanto la interfaz renderizada como la traducción. Una muestra útil permite establecer el comportamiento de ese caso, no la calidad general en el nuevo idioma.