Vous pouvez utiliser les paramètres dans votre tableau de localisation lorsque seule une partie de la chaîne affichée doit être traduite, par exemple pour localiser une unité de mesure après une valeur numérique, pour référencer un nom d'utilisateur ou pour afficher l'heure et la date.
Les paramètres sont constitués d'une valeur de paramètre et d'un spécificateur de format facultatif entre accolades.
Dans l'exemple suivant, le tableau de localisation d'une expérience contient les entrées suivantes :
| Source | es |
|---|---|
| Bonjour {Player_Name}! | Hola {Player_Name}! |
| Je m'appelle {NPC_Name} | Me llamo {NPC_Name} |
Si les paramètres linguistiques d'un utilisateur sont définis sur es, la traduction sera la suivante :
| Texte original dans le jeu | Traduction en espagnol |
|---|---|
| Bonjour new_storm ! | ¡Hola new_storm! |
| Je m'appelle Diva Dragonslayer | Me llamo Diva Dragonslayer |
Dans certains cas, vous pouvez utiliser des spécificateurs de format pour contrôler la manière dont la valeur du paramètre est formatée dans la chaîne localisée.
Les spécificateurs de format disponibles sont les suivants :
| Spécificateur | Type | Description | Exemple de résultat |
|---|---|---|---|
| int | nombre | Entier avec signe négatif facultatif ; pas de séparateur de milliers. | 1234 |
| fixe | nombre | Deux décimales avec indicateur décimal, signe négatif facultatif et pas de séparateur de milliers. | 1234.50 1234,50 |
| num | nombre | Deux décimales avec indicateur décimal, signe négatif facultatif et séparateurs de milliers. | 1,234.50 1234,50 |
| HEX | nombre | Entier converti en hexadécimal ; valeur négative convertie en complément à deux sur 64 bits. | 3FF |
| hex | nombre | Identique à HEX, mais en minuscules. | 3ff |
| dateheure | nombre | Horodatage UTC sous forme de nombre dans un format universel lisible par l'utilisateur. | 2017-10-10 13:38:10 |
| iso8601 | nombre | Horodatage UTC sous forme de nombre au format ISO-8601 heure UTC. | 2017-10-12T22:02:38Z |
| heurecourte | nombre | Horodatage UTC au format local « heure:minute ». | 1:45 PM 13:45 |
| dateheurecourtes | nombre | Horodatage UTC au format général de date et d'heure avec heure courte. | 10/10/2017 1:45 PM |
| datecourte | nombre | Horodatage UTC au format date courte. | 10/10/2017 2017-10-10 |
| traduire | chaîne | Recherche une correspondance littérale de la chaîne Source dans le tableau de localisation et utilise la traduction locale disponible. |
Traduire les sous-chaînes
Utilisez le spécificateur traduire pour obtenir une traduction directe à partir de votre tableau de localisation. La localisation recherchera une correspondance exacte du paramètre dans la colonne Source de votre tableau de localisation.
Le tableau de localisation d'une expérience comporte ces lignes dans l'exemple suivant :
| Source | es |
|---|---|
| Je viens de {Place_Name:translate}. | Soy de {Place_Name:translate}. |
| Brésil | Brasil |
| London | Londres |
| Allemagne | Alemania |
Si les paramètres linguistiques d'un utilisateur sont définis sur es, la sortie de la traduction s'affiche comme suit :
| Texte original dans le jeu | Traduction en espagnol |
|---|---|
| Je viens du Brésil. | Soy de Brasil. |
| Je viens de Londres. | Soy de Londres. |
| Je viens d'Allemagne. | Soy de Alemania. |
Traduire avec des chiffres
Vous pouvez utiliser un spécificateur pour formater vos valeurs numériques afin qu'elles correspondent au contexte de votre expérience.
Dans l'exemple suivant, le nombre d'entrées liées à une expérience dans son tableau de localisation est le suivant :
| Source | es |
|---|---|
| {race_time:fixed} secondes | {race_time:fixed}segundos |
| ${1:num} en espèces et {2:int} bijoux | ${1:num} dinero y {2:int} joyas |
Si les paramètres linguistiques d'un utilisateur sont définis sur es, la sortie de la traduction s'affiche comme suit :
| Texte original dans le jeu | Traduction en espagnol |
|---|---|
| 75,202844 secondes | 75,20 segundos |
| 2500,5 $ en espèces et 99,8 bijoux | $2.500,50 dinero y 100 joyas |
Lorsque vous utilisez plusieurs paramètres pour une seule entrée, vous devez utiliser toutes les chaînes ou tous les nombres pour les spécificateurs de paramètres.