Guida i18n

Cos'è l'internazionalizzazione (i18n)?

L'internazionalizzazione è la base per creare software destinato a pubblici globali. Scopri come progettare le tue applicazioni per supportare più lingue, regioni e culture fin dall'inizio.

Capire l'internazionalizzazione

L'internazionalizzazione (i18n) è il processo di progettazione e sviluppo di applicazioni software affinché possano essere adattate a lingue e regioni diverse senza richiedere modifiche ingegneristiche al codice sorgente.

L'obiettivo è creare un'architettura flessibile che separi i contenuti visibili all'utente dalla logica di business, rendendo semplice aggiungere nuove lingue e varianti regionali senza modificare l'applicazione core.

Se fatta correttamente, l'internazionalizzazione consente al tuo prodotto di raggiungere i mercati globali in modo efficiente, riducendo il time-to-market per nuove locale e garantendo un'esperienza utente coerente in tutte le lingue supportate.

Perché "i18n"?

Il termine "i18n" è un numeronimo in cui 18 rappresenta il numero di lettere tra la prima "i" e l'ultima "n" di "internationalization". Questa abbreviazione è ampiamente usata nell'industria software.

i18n = i + (18 letters) + n

Principi chiave dell'internazionalizzazione

Segui questi principi chiave per costruire software davvero internazionale

Separa il contenuto dal codice

Salva tutte le stringhe visibili all'utente in file di risorse esterni. Non hardcodare mai testo direttamente nel codice sorgente.

Gestisci formati di data, ora e numeri

Usa formattazione locale-aware per date, orari, numeri e valute. Regioni diverse hanno convenzioni diverse.

Progetta per la flessibilità

Progetta componenti UI che possano gestire espansione del testo, layout RTL e set di caratteri diversi senza rompersi.

Vantaggi dell'internazionalizzazione

Investire in i18n fin dall'inizio porta benefici mentre il tuo prodotto cresce globalmente.

Scala verso nuovi mercati senza riscrivere codice
Manutenzione più semplice con traduzioni centralizzate
Raggiungi il 95% degli utenti internet nella loro lingua madre
Esperienza utente migliore con contenuti culturalmente appropriati
Rispetta i requisiti normativi e di accessibilità locali
Riduci in modo significativo i costi di localizzazione nel lungo periodo

Best practice i18n

Segui queste linee guida per un'internazionalizzazione di successo

Usa Unicode (UTF-8) ovunque

La codifica UTF-8 supporta tutte le lingue e i caratteri speciali. Configura database, API e file per usare UTF-8.

Esternalizza tutte le stringhe

Sposta tutto il testo visibile all'utente nei file di traduzione. Usa chiavi significative che descrivano lo scopo del contenuto.

Evita la concatenazione di stringhe

Non costruire frasi concatenando stringhe. Usa il formato messaggi ICU con placeholder per contenuti dinamici.

Pianifica il supporto per lingue RTL

Progetta layout che possano invertirsi per lingue RTL come arabo ed ebraico. Usa proprietà CSS logiche.

i18n vs l10n

Internazionalizzazione e localizzazione lavorano insieme, ma hanno scopi diversi nel processo di globalizzazione.

Internazionalizzazione (i18n)

Il processo ingegneristico per rendere il software adattabile. Viene fatto una volta dagli sviluppatori durante lo sviluppo iniziale.

Localizzazione (l10n)

Il processo di adattamento dei contenuti per mercati specifici. Un lavoro continuo per ogni nuova lingua o regione.