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 una virgola. (,).

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 es. en-US, it-IT, fr-FR, de-DE).

Intestazioni supportate

Utilizza i codici lingua ISO con un trattino (-), non con un underscore (_):

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

Regole di formattazione

Utilizza le virgole (,) come separatori di colonna, non i punti e virgola (;).
Tutte le righe devono avere lo stesso numero di colonne. Ad esempio, se l'intestazione è in 2 lingue, ogni riga deve contenere 2 valori.
- Se manca una traduzione, lascia la cella vuota ma mantieni la virgola:
  Hello,
Se un valore contiene una virgola, racchiudere l'intero valore tra virgolette doppie (" "):

"12,5 km", "12,5 km"

Se un valore contiene virgolette, inseriscile doppie all'interno del campo:

"He said ""Hello""", "Ha detto ""Ciao"""
Evita spazi extra prima o dopo le virgole.
Salva sempre il file con la codifica UTF-8 per preservare i caratteri accentati. (é, è, ü, ñ, ç, etc.).

Errori comuni da evitare

❌ Errato	✅ Corretto
`it_IT,en_GB`	`it-IT,en-US`
`Animal skills (riding);Besterie (équitation)`	`Animal skills (riding),Besterie (équitation)`
`12,5 km,12,5 km`	`"12,5 km","12,5 km"`
`Hello`	`Hello,`
`“test`	`"test"`

Codifica e salvataggio dei file

Quando salvi il file CSV, seleziona CSV UTF-8 (delimitato da virgole) come formato del file.
Questo garantisce che i caratteri speciali e i contenuti multilingue vengano preservati correttamente.

Questo articolo tratta di:

cos'è un file CSV e come è strutturato
quale formato di intestazione è supportato (es. en-US, it-IT, fr-FR)
come gestire virgole, virgolette e valori mancanti
errori di formattazione comuni che causano errori di importazione
come salvare il file in codifica UTF-8 per un caricamento corretto