File di localizzazione (Strings)

I file di localizzazione sono file di testo che possono essere aperti e modificati in un editor di testo come Notepad o TextEdit o uno dei miriadi di Strumenti avanzati di modifica del testo utilizzati dai programmatori. Questi file seguono generalmente il principio chiave-valore. Ciò significa che contengono un elenco di frammenti di testo (Strings) che sono associati a ID univoci (chiavi). Ogni stringa è quindi un valore di una chiave (Questo semplice esempio è il formato dei file di localizzazione utilizzati nella programmazione Java):

Creazione di file di localizzazione

I file di localizzazione sono file di testo semplice con una struttura semplice. Possono essere creati manualmente ma di solito sono generati automaticamente da utility o script di internazionalizzazione disponibili per diversi ambienti di sviluppo. La creazione automatica dei file di localizzazione assicura che le strutture dei file siano valide.

Per creare un file di localizzazione, tutte le parti di testo visualizzabili vengono sostituite con ID univoci nei file di codice. Le Strings di testo vengono quindi aggiunte al file di localizzazione con i loro ID.

Uso di file di localizzazione

Invece delle Strings di testo vere e proprie, il codice ora contiene solo chiavi. Quando il software genera una visualizzazione per l'utente, queste chiavi vengono utilizzate per cercare le Strings associate nel file di localizzazione.

Se un'applicazione è configurata per essere utilizzata in inglese e spagnolo, tutto il testo inglese può essere conservato in un file chiamato English.txt ed è la posizione predefinita del testo. Se un utente non seleziona una lingua, tutto il testo verrà estratto da questo file per generare una visualizzazione. Se l'utente seleziona lo spagnolo, il software viene reindirizzato a Spanish.txt. Molte lingue possono essere utilizzate con un sistema come questo.

Il vantaggio è che la scelta della lingua per la visualizzazione non influisce sul codice. Se il software deve visualizzare un pulsante di accesso, può richiedere la stringa associata al pulsante login_chiave e deve solo sapere in quale file cercare per recuperare la stringa appropriata per la lingua specificata.

Gestione stringhe

In quanto piattaforma di traduzione basata su chiavi, Phrase supporta molti diversi tipi di file di risorse. Dopo il caricamento dei file vengono estratte le chiavi e i valori delle stringhe associati. Le chiavi e Strings vengono quindi presentate al traduttore in un formato standardizzato. I traduttori si concentrano sulla loro attività senza doversi preoccupare del formato esatto del file di localizzazione. Possono ispezionare le chiavi, perché la chiave stessa può fornire un contesto cruciale e guidarle a correggere le scelte di parole.

Quando tutte le Strings vengono tradotte, i file vengono scaricati. Nel processo vengono creati i formati di file di localizzazione necessari in corrispondenza del file di origine originale.

Formati file di risorsa

Sono supportati quattro grandi tipi di risorse e sono tutte essenzialmente basate su testo e possono essere aperte e ispezionate in un editor di testo.

Fogli di calcolo

Sono supportati i file .XLSX e .CSV. Questi formati sono equivalenti ai fini della localizzazione e contengono righe di coppie chiave-valore. Le chiavi sono in una riga, mentre i valori corrispondenti sono in una riga adiacente. Quale colonna esatta viene usata per quale scopo dipende dall'applicazione e un localizzatore deve configurare Phrase per interpretare correttamente le colonne. I file ZenDesk .CSV hanno una struttura fissa, quindi questo tipo di file non richiede ulteriori modifiche:

"Titolo", "Lingua predefinita", "Testo predefinito", "Testo inglese", "Stato variante"
"simple_key","German","Einfacher Schlüssel.","Simple key.","Current"

XML

XML è un formato che offre metainformazioni sotto forma di <tag>. La struttura dei tag viene utilizzata per determinare dove si trovano le chiavi e i loro valori corrispondenti, come mostrato qui da un file XML Android:

 <stringa name="simple_key">Solo una chiave con un messaggio.</stringa>

Due formati standard di traduzione XML sono .TMX e .XLIFF. Questi non solo contengono chiavi e valori in una lingua, ma associano anche coppie di valori di una lingua di origine con i valori corrispondenti di una lingua di destinazione. Tali file sono in genere bilingue, come mostra questa unità di traduzione in un file Symfony Xliff:

<trans-unit ID="simple_key" resname="simple_key">
 <origine xml:lang="de-DE">Nur ein einfacher Schlüssel mit einer einfachen Nachricht.</origine
<Destinazione xml:lang="en-GB">Solo una semplice chiave con un semplice messaggio.</Destinazione>
</trans-unit>

I programmi QT usano file di risorse con una struttura molto simile a questi formati standardizzati, ma per motivi storici hanno un layout diverso.

Lisci elenchi di valori chiave

Esistono file di risorse che contengono semplici elenchi di chiavi e valori, come mostra questo frammento di YAML Ruby on Rails:

simple_key: Basta una semplice chiave con un semplice messaggio.

Molti diversi linguaggi di programmazione o piattaforme usano tali formati con Minori differenze di layout.

Trattandosi di file monolingue, un programma di localizzazione deve mantenere versioni parallele di tali file, una per la lingua di origine e altre per le lingue di destinazione.

Gettext produce file di valore chiave contenenti informazioni aggiuntive, come commenti descrittivi o varianti plurali:

# Questa è la descrizione incredibile per questa chiave!
msgid "key_with_description"
msgid_plural ""
msgstr[0] "Dai un'occhiata! Questa chiave ha una descrizione! (Almeno in alcuni formati)"
msgstr[1] "Guarda qua! Questa chiave ha %s descrizioni! (Almeno in alcuni formati)"

Esistono formati concorrenti con funzionalità e layout simili che variano in modi relativamente Minori.

Matrici associative

Mentre altri formati richiedono codice personalizzato (parser) per leggerli, alcuni formati sono più facili per sviluppatori e localizzatori. I formati basati su array .JSON (JavaScript) e PHP possono essere letti e mappati direttamente in strutture di codice comuni (array) facili da manipolare. Gli array possono essere complessi e diverse applicazioni generano strutture di array personalizzate.

Per esempio, go-i18n JSON si riferisce alle chiavi come ID:

{
    "ID": "simple_key",
    "traduzione": "chiave semplice, messaggio semplice, così semplice".
},

Angular usa le chiavi stesse come chiavi nei suoi array:

"simple_key": "Sono una chiave semplice con un messaggio semplice".

Poiché ci sono queste differenze Minore ma cruciali, sono supportate strutture .JSON e PHP Array ampiamente utilizzate.