Linee guida per la formattazione CSV dei glossari

Struttura del file

Un file CSV (Comma-Separated Values) è un semplice file di testo che contiene una voce per riga.
Ogni riga rappresenta una riga di una tabella e ogni valore in quella riga è separato da un carattere delimitatore.

Esempio:

en-US,it-IT
Hello, Ciao.
Good morning, Buongiorno.
Thank you, Grazie.

La prima riga deve contenere le intestazioni che definiscono le lingue del tuo glossario (ad esempio en-US, it-IT, fr-FR, de-DE).

Intestazioni supportate

Utilizza i codici ISO delle lingue con un trattino (-), non con una barra bassa (_):

en-US, it-IT, fr-FR, de-DE

Regole di formattazione

Utilizza le virgole (,) o i punti e virgola (;) come separatori di colonna. Sono supportati entrambi. Assicurati di utilizzare lo stesso separatore in modo coerente in tutto il file: non mescolarli.
Tutte le righe devono avere lo stesso numero di colonne: ad esempio, se l'intestazione ha 2 lingue, ogni riga deve contenere 2 valori.
- Se manca una traduzione, lascia la cella vuota ma mantieni il separatore:
  Ciao,
Se un valore contiene una virgola, racchiudi l'intero valore tra virgolette doppie (" "):
"12,5 km","12,5 km"
Se un valore contiene virgolette, raddoppiale all'interno del campo:
"He said ""Hello""","Ha detto ""Ciao"""
Evita spazi aggiuntivi prima o dopo i separatori.
Salva sempre il file con la codifica UTF-8 per mantenere i caratteri accentati (é, è, ü, ñ, ç, ecc.).

Errori comuni da evitare

❌ Sbagliato	✅ Corretto
`it_IT,en_GB`	`it-IT,en-US`
`12,5 km, 12,5 km`	`"12,5 km","12,5 km"`
`Ciao`	`Ciao,`
`"test`	`"test"`

Codifica e salvataggio dei file

Quando salvi il tuo file CSV, seleziona CSV UTF-8 (delimitato da virgole) come formato di file.
Ciò garantisce che i caratteri speciali e i contenuti multilingue vengano conservati correttamente.

Questo articolo tratta di:

cos'è un file CSV e come è strutturato
quale formato di intestazione è supportato (ad esempio en-US, it-IT, fr-FR)
quali separatori di colonna sono supportati (virgole e punti e virgola)
come gestire separatori, virgolette e valori mancanti
errori di formattazione comuni che causano problemi di importazione
come salvare il file con codifica UTF-8 per un caricamento corretto