È possibile utilizzare i parametri nella tabella di localizzazione quando: è necessario tradurre solo una parte della stringa visualizzata, ad esempio, occorre localizzare un'unità di misura dopo un valore numerico, il riferimento a un nome utente o la visualizzazione di ora e data.
I parametri sono costituiti da un valore di parametro e da un identificatore di formato opzionale racchiuso tra parentesi graffe.
Nell'esempio seguente, un'esperienza ha le seguenti voci nella propria tabella di localizzazione:
| Fonte | es |
|---|---|
| Hello {Player_Name}! | Hola {Player_Name}! |
| My name is {NPC_Name} | Me llamo {NPC_Name} |
Se un utente ha il locale impostato su es, l'output della traduzione sarà il seguente:
| Testo originale del gioco | Traduzione spagnola |
|---|---|
| Hello new_storm! | Hola new_storm! |
| My name is Diva Dragonslayer | Me llamo Diva Dragonslayer |
In alcuni casi, si possono usare gli identificatori di formato per controllare la formattazione del valore del parametro nella stringa localizzata.
Gli identificatori di formato disponibili sono i seguenti:
| Identificatore | Tipo | Descrizione | Output di esempio |
|---|---|---|---|
| int | numero | Numero intero con segno negativo opzionale; nessun separatore di migliaia. | 1234 |
| fixed | numero | Due decimali con indicatore decimale, segno negativo opzionale e nessun separatore delle migliaia. | 1234.50 1234,50 |
| num | numero | Due decimali con indicatore decimale, segno negativo opzionale e separatori delle migliaia. | 1,234.50 1234,50 |
| HEX | numero | Integro convertito in formato esadecimale; il negativo è convertito in complemento a due a 64 bit. | 3FF |
| hex | numero | Come HEX, ma in minuscolo. | 3ff |
| datetime | numero | Marca temporale UTC come numero in formato universale visualizzabile dall'utente. | 2017-10-10 13:38:10 |
| iso8601 | numero | Marca temporale UTC come numero in formato ISO-8601 ora UTC. | 2017-10-12T22:02:38Z |
| shorttime | numero | Marca temporale UTC in formato locale "ora:minuto". | 1:45 PM 13:45 |
| shortdatetime | numero | Marca temporale UTC a modello generale di data e ora con tempo breve. | 10/10/2017 1:45 PM |
| shortdate | numero | Marca temporale UTC con modello di data breve. | 10/10/2017 2017-10-10 |
| translate | stringa | Cerca una corrispondenza letterale della stringa Source nella tabella di localizzazione e utilizza la traduzione locale disponibile. |
Traduzione di sottostringhe
L'identificatore translate viene usato per richiedere una traduzione diretta dalla tabella di localizzazione. La localizzazione cercherà una corrispondenza esatta del parametro nella colonna Source della tabella di localizzazione.
Nell'esempio seguente, un'esperienza presenta le seguenti righe nella tabella di localizzazione:
| Fonte | es |
|---|---|
| I am from {Place_Name:translate}. | Soy de {Place_Name:translate}. |
| Brazil | Brasil |
| London | Londres |
| Germany | Alemania |
Se un utente ha il locale impostato su "es", l'output di traduzione verrà visualizzato come segue:
| Testo originale del gioco | Traduzione spagnola |
|---|---|
| I am from Brazil. | Soy de Brasil. |
| I am from London. | Soy de Londres. |
| I am from Germany. | Soy de Alemania. |
Traduzione con numeri
È possibile utilizzare un identificatore per formattare i valori numerici in modo da adattarli al contesto dell'esperienza.
Nell'esempio di seguito, l'esperienza ha il seguente numero di voci nella propria tabella di localizzazione:
| Fonte | es |
|---|---|
| {race_time:fixed seconds | {race_time:fixed segundos |
| ${1:num} contanti e {2:int}gioielli | ${1:num} dinero y {2:int}joyas |
Se un utente ha il locale impostato su es, l'output di traduzione verrà visualizzato come segue:
| Testo originale del gioco | Traduzione spagnola |
|---|---|
| 75.202844 seconds | 75,20 segundos |
| $2.500,5 in contanti e 99,8 gioielli | $2.500,50 dinero y 100 joyas |
Quando si utilizzano più parametri in una singola voce, è necessario utilizzare tutte le stringhe o tutti i numeri per gli identificatori dei parametri.