Você pode usar parâmetros em sua tabela de localização quando apenas parte da string exibida requer tradução, como a localização de uma unidade de medida após um valor numérico, referenciando um nome de usuário ou exibindo hora e data.
Os parâmetros consistem em um valor de parâmetro e um especificador de formato opcional encerrado em chaves.
No exemplo a seguir, um jogo tem as seguintes entradas em sua tabela de localização:
| Fonte | es |
|---|---|
| Olá {Player_Name}! | Hola {Player_Name}! |
| Meu nome é {NPC_Name} | Me llamo {NPC_Name} |
Se um usuário tiver seu local definido como es, a saída da tradução seria a seguinte:
| Texto original no jogo | Tradução em espanhol |
|---|---|
| Olá new_storm! | Hola new_storm! |
| Meu nome é Diva Dragonslayer | Me llamo Diva Dragonslayer |
Em alguns casos, pode ser necessário usar especificadores de formato para controlar como o valor do parâmetro é formatado na string localizada.
Os especificadores de formato disponíveis são os seguintes:
| Especificador | Tipo | Descrição | Exemplo de saída |
|---|---|---|---|
| int | número | Inteiro com sinal negativo opcional; sem separadores de milhar. | 1234 |
| fixed | número | Duas casas decimais com indicador decimal, sinal negativo opcional e sem separadores de milhar. | 1234.50 1234,50 |
| num | número | Duas casas decimais com indicador decimal, sinal negativo opcional e separadores de milhar. | 1.234,50 1234,50 |
| HEX | número | Inteiro convertido para hex; negativo é convertido para complemento de 64 bits. | 3FF |
| hex | número | Mesma coisa que HEX, mas em letras minúsculas. | 3ff |
| datetime | número | Timestamp UTC como um número para formato universal legível por usuários. | 2017-10-10 13:38:10 |
| iso8601 | número | Timestamp UTC como um número para formato de hora UTC ISO-8601. | 2017-10-12T22:02:38Z |
| shorttime | número | Timestamp UTC para formato local "hora:minuto". | 1:45 PM 13:45 |
| shortdatetime | número | Timestamp UTC para padrão geral de data+hora com hora curta. | 10/10/2017 1:45 PM |
| shortdate | número | Timestamp UTC para padrão de data curta. | 10/10/2017 2017-10-10 |
| translate | string | Procura uma correspondência literal na string Fonte na tabela de localização e usa a tradução disponível para o local. |
Traduzir substrings
Use o especificador translate quando precisar de uma tradução direta da sua tabela de localização. A localização irá procurar uma correspondência exata do parâmetro na coluna Fonte da sua tabela de localização.
No exemplo a seguir, um jogo tem as seguintes linhas em sua tabela de localização:
| Fonte | es |
|---|---|
| Eu sou de {Place_Name:translate}. | Soy de {Place_Name:translate}. |
| Brasil | Brasil |
| London | Londres |
| Germany | Alemania |
Se um usuário tiver seu local definido como 'es', a saída da tradução é exibida como segue:
| Texto original no jogo | Tradução em espanhol |
|---|---|
| Eu sou do Brasil. | Soy de Brasil. |
| Eu sou de Londres. | Soy de Londres. |
| Eu sou da Alemanha. | Soy de Alemania. |
Traduzir com números
Você pode usar um especificador para formatar seus valores numéricos para corresponder ao contexto dentro do seu jogo.
No exemplo a seguir, um jogo tem as seguintes entradas relacionadas a números em sua tabela de localização:
| Fonte | es |
|---|---|
| {race_time:fixed} segundos | {race_time:fixed} segundos |
| ${1:num} dinheiro e {2:int} joias | ${1:num} dinero y {2:int} joyas |
Se um usuário tiver seu local definido como es, a saída da tradução é exibida como segue:
| Texto original no jogo | Tradução em espanhol |
|---|---|
| 75.202844 segundos | 75,20 segundos |
| $2500.5 em dinheiro e 99.8 joias | $2.500,50 dinero y 100 joyas |
Ao usar múltiplos parâmetros em uma única entrada, você deve usar ou todas as strings ou todos os números para especificadores de parâmetro.