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 in uno dei tanti Strumenti di modifica del testo avanzati usati dai programmatori. Questi file seguono generalmente il principio chiave-valore. Ciò significa che contengono un elenco di frammenti di testo (stringhe) associati a ID univoci (chiavi). Ogni stringa è quindi un valore di una chiave (questo semplice esempio è il formato dei file di localizzazione usati nella programmazione Java):

Crea file di localizzazione

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

Per creare un file di localizzazione, tutti i pezzi di testo visualizzabile vengono sostituiti con chiavi univoche nei file di codice. Le stringhe di testo vengono quindi aggiunte al file di localizzazione con le relative chiavi.

Usare i file di localizzazione

Invece delle stringhe di testo effettive, il codice ora contiene solo chiavi. Quando il software genera una vista per l'utente, queste chiavi vengono usate per cercare le stringhe associate nel file di localizzazione.

Se un'applicazione è configurata per essere usata in inglese e spagnolo, tutto il testo in 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 qualsiasi 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, potrebbe richiedere la stringa associata alla chiave login_button e deve solo sapere in quale file cercare per recuperare la stringa appropriata per la lingua data.

Gestione delle Strings

Come piattaforma di traduzione basata su chiave, Phrase supporta molti tipi di file di risorse diversi. Dopo che i file sono stati caricati, le chiavi e i loro valori di stringa associati vengono estratti. Le chiavi e le 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 guidarli verso scelte lessicali corrette.

Quando tutte le Strings sono tradotte, i file vengono scaricati. Nel processo, vengono creati i formati di file di localizzazione necessari che corrispondono al file di origine originale.

Formati di file di risorse

Sono supportati quattro ampi tipi di risorse, tutti essenzialmente basati su testo e apribili e ispezionabili in un editor di testo.

Fogli di calcolo

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

"Titolo","Lingua predefinita","Testo predefinito","Testo inglese","Stato variante"
"simple_key","Tedesco","Chiave semplice.","Chiave semplice.","Attuale"

XML

XML è un formato che offre meta informazioni sotto forma di <tags>. La struttura dei tag viene usata per determinare dove si trovano le chiavi e i relativi valori, come mostrato qui da un file XML Android:

 <string name="simple_key">Just a  key with a message.</string>

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

<trans-unit id="simple_key" resname="simple_key">
 <source xml:lang="de-DE">Nur ein einfacher Schlüssel mit einer einfachen Nachricht.</source
<target xml:lang=\"en-GB\">Just a simple key with a simple message.</target>
</trans-unit>

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

Elenchi semplici di chiave-valore

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

simple_key: Just a simple key with a simple message.

Molti linguaggi di programmazione o piattaforme diverse usano tali formati con Minore differenze di layout.

Poiché si tratta di file monolingua, 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 chiave-valore contenenti informazioni aggiuntive, come commenti descrittivi o varianti plurali:

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

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

Array associativi

Mentre altri formati richiedono codice Personalizzato (parser) per essere letti, alcuni formati sono più semplici per sviluppatori e localizzatori. I formati basati su .JSON (JavaScript) e array .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.

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

{
    "id": "simple_key",
    "translation": "simple key, simple message, so simple."
},

Angular utilizza le chiavi stesse come chiavi nei suoi array:

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

Poiché esistono queste differenze Minori ma cruciali, le strutture .JSON e .PHP Array ampiamente utilizzate sono supportate.