Puedes usar parámetros en tu tabla de localización cuando solo parte de la cadena mostrada requiere traducción, como la localización de una unidad de medida después de un valor numérico, hacer referencia a un nombre de usuario, o mostrar la hora y la fecha.
Los parámetros consisten en un valor de parámetro y un especificador de formato opcional encerrado entre llaves.
En el siguiente ejemplo, un juego tiene las siguientes entradas en su tabla de localización:
| Fuente | es |
|---|---|
| ¡Hola {Player_Name}! | ¡Hola {Player_Name}! |
| Me llamo {NPC_Name} | Me llamo {NPC_Name} |
Si un usuario tiene su configuración regional establecida en es, la salida de traducción sería la siguiente:
| Texto original en el juego | Traducción al español |
|---|---|
| ¡Hola new_storm! | ¡Hola new_storm! |
| Me llamo Diva Dragonslayer | Me llamo Diva Dragonslayer |
En algunos casos, es posible que desees usar especificadores de formato para controlar cómo se formatea el valor del parámetro en la cadena localizada.
Los especificadores de formato disponibles son los siguientes:
| Especificador | Tipo | Descripción | Salida de ejemplo |
|---|---|---|---|
| int | número | Entero con signo negativo opcional; sin separadores de miles. | 1234 |
| fixed | número | Dos decimales con indicador decimal, signo negativo opcional y sin separadores de miles. | 1234.50 1234,50 |
| num | número | Dos decimales con indicador decimal, signo negativo opcional y separadores de miles. | 1,234.50 1234,50 |
| HEX | número | Entero convertido a hexadecimal; el negativo se convierte en complemento a dos de 64 bits. | 3FF |
| hex | número | Igual que HEX, pero en minúsculas. | 3ff |
| datetime | número | Sello temporal UTC como número a formato universal legible por el usuario. | 2017-10-10 13:38:10 |
| iso8601 | número | Sello temporal UTC como número a formato ISO-8601 de tiempo UTC. | 2017-10-12T22:02:38Z |
| shorttime | número | Sello temporal UTC a formato local "hora:minuto". | 1:45 PM 13:45 |
| shortdatetime | número | Sello temporal UTC a patrón general de fecha+hora con tiempo corto. | 10/10/2017 1:45 PM |
| shortdate | número | Sello temporal UTC a patrón de fecha corta. | 10/10/2017 2017-10-10 |
| translate | cadena | Busca una coincidencia de cadena literal Fuente en la tabla de localización y usa la traducción disponible del idioma. |
Traducir subcadenas
Usa el especificador translate cuando necesites una traducción directa de tu tabla de localización. La localización buscará una coincidencia exacta del parámetro en la columna de Fuente de tu tabla de localización.
En el siguiente ejemplo, un juego tiene las siguientes filas en su tabla de localización:
| Fuente | es |
|---|---|
| Soy de {Place_Name:translate}. | Soy de {Place_Name:translate}. |
| Brasil | Brasil |
| London | Londres |
| Germany | Alemania |
Si un usuario tiene su configuración regional establecida en 'es', la salida de traducción se muestra de la siguiente manera:
| Texto original en el juego | Traducción al español |
|---|---|
| Vengo de Brasil. | Soy de Brasil. |
| Vengo de Londres. | Soy de Londres. |
| Vengo de Alemania. | Soy de Alemania. |
Traducir con números
Puedes usar un especificador para formatear tus valores numéricos para que coincidan con el contexto dentro de tu juego.
En el siguiente ejemplo, un juego tiene las siguientes entradas relacionadas con números en su tabla de localización:
| Fuente | es |
|---|---|
| {race_time:fixed} segundos | {race_time:fixed} segundos |
| ${1:num} efectivo y {2:int} joyas | ${1:num} dinero y {2:int} joyas |
Si un usuario tiene su configuración regional establecida en es, la salida de traducción se muestra de la siguiente manera:
| Texto original en el juego | Traducción al español |
|---|---|
| 75.202844 seconds | 75,20 segundos |
| $2500.5 efectivo y 99.8 joyas | $2.500,50 dinero y 100 joyas |
Al usar múltiples parámetros en una sola entrada, debes usar todos los strings o todos los números para los especificadores de parámetros.