Puedes usar los parámetros de tu tabla de localización cuando solo se necesita traducir una parte de la cadena que se muestra, como la localización de una unidad de medida después de un valor numérico, la referencia a un nombre de usuario o la visualización de la fecha y la hora.
Los parámetros constan de un valor de parámetro y un especificador de formato opcional incluido entre llaves.
En el ejemplo a continuación, una experiencia tiene las siguientes entradas en su tabla de localización:
| Origen | es |
|---|---|
| Hello {Player_Name! | ¡Hola {Player_Name! |
| My name is {Player_NameNPC_Name} | Me llamo {Player_NameNPC_Name} |
Si un usuario tiene su configuración regional establecida en es, el resultado de la traducción sería el siguiente:
| Texto original del juego | Traducción al español |
|---|---|
| Hello new_storm! | Hola new_storm! |
| My name is Diva Dragonslayer | Me llamo Diva Dragonslayer |
En algunos casos, te resultará conveniente usar especificadores de formato para controlar el formato del valor del parámetro en la cadena localizada.
Los especificadores de formato disponibles son los siguientes:
| Especificador | Tipo | Descripción | Resultados de ejemplo |
|---|---|---|---|
| int | number | Número entero con signo negativo opcional y sin separadores de miles. | 1234 |
| fixed | number | Dos decimales con indicador decimal, signo negativo opcional y sin separadores de miles. | 1234.50 1234,50 |
| num | number | Dos decimales con indicador decimal, signo negativo opcional y separadores de miles. | 1,234.50 1234,50 |
| HEX | number | Número entero convertido a hexadecimal; el negativo se convierte en complemento a dos de 64 bits. | 3FF |
| hex | number | Igual que HEX, pero en minúsculas. | 3ff |
| datetime | number | Marca de tiempo UTC como número en un formato universal legible por el usuario. | 2017-10-10 13:38:10 |
| iso8601 | number | Marca de tiempo UTC como número en formato de hora UTC ISO-8601. | 2017-10-12T22:02:38Z |
| shorttime | number | Marca de tiempo UTC en el formato local de "hora:minuto". | 1:45 PM 13:45 |
| shortdatetime | number | Marca de tiempo UTC en patrón general de fecha y hora con hora corta. | 10/10/2017 1:45 PM |
| shortdate | number | Marca de tiempo UTC en patrón de fecha corta. | 10/10/2017 2017-10-10 |
| translate | string | Busca una coincidencia literal de la cadena Source en la tabla de localización y utiliza la traducción de la configuración regional disponible. |
Traducción de subcadenas
Usa el especificador translate cuando requieras una traducción directa de tu tabla de localización. La localización buscará una coincidencia exacta del parámetro en la columna Source de tu tabla de localización.
En el siguiente ejemplo, una experiencia tiene las siguientes filas en su tabla de localización:
| Origen | es |
|---|---|
| I am from {Place_Name:translate}. | Soy de {Place_Name:translate}. |
| Brazil | Brasil |
| London | Londres |
| Germany | Alemania |
Si un usuario tiene su configuración regional establecida en 'es', el resultado de la traducción se vería de la siguiente manera:
| Texto original del juego | Traducción al español |
|---|---|
| I am from Brazil. | Soy de Brasil. |
| I am from London. | Soy de Londres. |
| I am from Germany. | Soy de Alemania. |
Traducción con números
Puedes usar un especificador para dar formato a tus valores numéricos, de modo que coincidan con el contexto de tu experiencia.
En el siguiente ejemplo, una experiencia tiene las siguientes entradas relacionadas con números en su tabla de localización:
| Origen | es |
|---|---|
| {race_time:fixed} seconds | {race_time:fixed} segundos |
| ${1:num} cash and {2:int} jewels | ${1:num} dinero y {2:int} joyas |
Si un usuario tiene su configuración regional establecida en es, el resultado de la traducción se vería de la siguiente manera:
| Texto original del juego | Traducción al español |
|---|---|
| 75.202844 seconds | 75,20 segundos |
| $2500.5 cash and 99.8 jewels | $2.500,50 dinero y 100 joyas |
Cuando se usan varios parámetros en una sola entrada, debes usar todas las cadenas o todos los números para los especificadores de parámetros.