Résolution des langues

Découvrez quelle configuration enregistrée s’applique à la langue, à la région ou au système d’écriture demandé, et comment les instructions, la voix, les modèles et la terminologie l’utilisent.

Une requête utilise la configuration enregistrée pour sa propre langue, pour une langue plus générale qui l’englobe et pour *. La configuration enregistrée pour une langue plus spécifique ou pour une autre région de la même langue ne s’applique pas. Le traitement de la configuration applicable varie selon la ressource : les instructions se cumulent, une seule variante de voix est retenue, les modèles forment une chaîne ordonnée de tentatives et toute traduction personnalisée doit aussi utiliser le système d’écriture de la requête.

Pour savoir quelles balises de langue choisir, consultez d’abord Langues. Cette référence explique ce qui se passe une fois ces balises transmises au moteur de localisation.

Quelle configuration s’applique #

Le traitement des langues s’appuie sur les données CLDR pour reconnaître les notations équivalentes comme une seule et même langue : zh, zh-CN, zh-Hans et zh-Hans-CN désignent toutes le chinois simplifié utilisé en Chine. Une langue sans région désigne sa région par défaut. Une requête pour es correspond à une requête pour l’espagnol utilisé en Espagne (es-ES), pt désigne pt-BR et de désigne de-DE.

Une configuration s’applique à une requête lorsque la langue de cette configuration correspond à l’un des cas suivants :

  • *, qui s’applique à toutes les langues.
  • La langue demandée, quelle que soit la notation équivalente utilisée.
  • Une langue plus générale qui englobe la langue demandée. de s’applique à de-CH et zh-Hant s’applique à zh-TW.

Toute autre langue est exclue. C’est notamment le cas d’une région plus spécifique, comme de-CH pour une requête de, ou d’une autre région de la même langue, comme de-DE pour une requête de-CH.

RequêteS’appliqueNe s’applique pas
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 groupe de régions tel que es-419 constitue un identifiant de langue à part entière. Il s’applique uniquement aux requêtes es-419, et non aux requêtes es-MX ou es-AR.

La même règle s’applique aux langues sources des ressources qui en possèdent une, à savoir les configurations de modèles et les termes du glossaire. Un terme enregistré pour la langue source en-GB ne s’applique pas à un contenu dont la langue source est en, car en désigne en-US.

Pour partager des consignes entre toutes les régions d’une langue, enregistrez-les pour la langue seule, comme es. Ne les associez à une région que si elles s’adressent au public de cette région.

Les niveaux de correspondance déterminent l’ordre de la configuration applicable #

Le moteur de localisation classe la configuration applicable par niveaux de correspondance : d’abord la langue demandée, puis une langue plus générale, puis *. Au sein d’un même niveau, la notation la plus spécifique passe en premier. Ainsi, pour une requête de, une variante de-DE précède une variante de.

Précisez explicitement la région de la langue lorsqu’elle fait partie des exigences. Veillez aussi à ne pas confondre des identifiants de langue distincts : no et nb sont des codes différents, et la configuration enregistrée pour l’un ne s’applique pas à l’autre.

Chaque ressource utilise la configuration applicable à sa manière #

RessourceRésultat
RèglesLes instructions prédéfinies et personnalisées applicables se cumulent par ordre de pertinence pour la langue. Les règles spécifiques n’annulent pas les règles générales.
Voix de marqueLa variante qui correspond le mieux est retenue. Si une égalité subsiste, la date de création, puis l’ID, permettent de la départager de manière stable.
ModèlesLe niveau de correspondance de la cible, celui de la source, la spécificité de la cible, celle de la source et le rang configuré déterminent l’ordre des tentatives.
GlossaireLes traductions personnalisées utilisant un autre système d’écriture sont exclues. Après le classement par langue, les doublons parmi les traductions candidates restantes sont éliminés sur la base du texte source. La recherche sélectionne ensuite le contexte applicable.
Relecture humaineUne requête fait l’objet d’une relecture si l’une des langues de la politique de relecture s’y applique, ou si la politique n’en précise aucune.

Le rang d’un modèle ne peut pas faire passer une configuration générique devant une correspondance de langue plus précise. L’ordre de rattachement des glossaires ne détermine pas leur priorité. Gardez ces distinctions à l’esprit si la configuration enregistrée contient les éléments attendus, mais qu’une requête en sélectionne d’autres.

Diagnostiquer une incompatibilité de région ou de système d’écriture #

Les consignes enregistrées pour une région ne s’appliquent pas dans une autre #

Supposons que les termes espagnols d’un glossaire soient enregistrés pour es-419 et que les requêtes ciblent es ou es-MX. Aucune des deux requêtes ne reçoit ces termes : es désigne l’Espagne et es-419 s’applique uniquement aux requêtes es-419. Enregistrez les termes communs à tous les publics hispanophones pour es, ou enregistrez-les pour chaque région ciblée par vos requêtes. Le même principe s’applique au portugais : pt désigne le Brésil, donc les termes enregistrés pour pt-PT ne s’appliquent qu’aux requêtes pt-PT.

La voix est régionale, mais la requête indique la langue seule #

Supposons qu’une voix possède des variantes de-DE et de-CH et que la requête cible de. La requête reçoit la variante de-DE, car de désigne l’allemand utilisé en Allemagne. La variante de-CH s’applique uniquement aux requêtes de-CH. Pour un contenu destiné à la Suisse, demandez de-CH plutôt que de compter sur le moteur de localisation pour déduire le public à partir de la source.

Une règle régionale contredit une règle générale #

Une règle générique exigeant le vouvoiement et une règle régionale applicable demandant le tutoiement peuvent toutes deux figurer dans les instructions transmises au modèle. Une règle plus spécifique n’annule pas l’exigence générale. Éliminez la contradiction ou réduisez sa portée afin que les instructions sélectionnées définissent un seul comportement attendu.

Le terme privilégié utilise un autre système d’écriture #

Une traduction personnalisée ne s’applique que si les systèmes d’écriture associés à ses langues correspondent à ceux de la requête, tant pour la source que pour la cible. Chaque langue est associée à un système d’écriture selon les valeurs par défaut de CLDR : zh, zh-CN et zh-SG correspondent au chinois simplifié, zh-TW et zh-HK au chinois traditionnel, sr au cyrillique et sr-ME au latin.

Ainsi, un terme enregistré pour zh s’applique aux requêtes zh, zh-CN et zh-SG, mais jamais à une requête zh-TW, même si les règles et la voix enregistrées pour zh s’appliquent à zh-TW. Un terme enregistré pour zh-Hans s’applique à une requête zh, et un terme enregistré pour zh-TW s’applique à une requête zh-Hant. Enregistrez pour zh-Hant un terme en chinois traditionnel commun à Taïwan et à Hong Kong. Un nom non traduisible fait exception, puisqu’il reste inchangé.

La traduction personnalisée cible toutes les langues #

Une traduction personnalisée dont la cible est * ne peut pas contenir un texte cible différent du texte source. Utilisez une langue cible précise pour une traduction privilégiée, ou une entrée non traduisible pour un texte qui doit rester identique partout.

Vérifiez chaque aspect lors de l’ajout d’une langue #

La configuration des langues ne prend pas en charge la mise en page de droite à gauche ni la mise en forme des données de l’application selon la langue. Vérifiez le rendu de l’interface en parallèle de la traduction. Un échantillon pertinent permet d’établir le comportement dans ce cas précis, mais pas la qualité globale pour la nouvelle langue.