Migliori pratiche per la traduzione CSV<\/a><\/li>\n<\/ul>\n<\/div><\/div>\n\nCos’\u00e8 un file CSV per la traduzione?<\/h2>\n\n
CSV (Comma-Separated Values) \u00e8 un formato di testo semplice che organizza i dati in righe e colonne, con ogni valore separato da una virgola. \u00c8 uno dei formati pi\u00f9 utilizzati per la localizzazione software perch\u00e9 \u00e8 leggero, facile da modificare e supportato dalla maggior parte dei framework di sviluppo, delle piattaforme e-commerce e degli strumenti di traduzione. <\/p>\n\n
Come strutturare un file CSV per la traduzione<\/h2>\n\n
Per preparare un file CSV per la traduzione, hai bisogno di una riga di intestazione chiara, chiavi identificative univoche e una colonna di testo sorgente. Impostare correttamente questi elementi prima di caricare il file su uno strumento di traduzione previene errori di importazione, stringhe mancanti e output danneggiati. <\/p>\n\n
Rendi la prima riga del tuo file i nomi delle colonne, non il contenuto. Usa etichette semplici e descrittive come key<\/code>, source_text<\/code> e context<\/code>. Queste indicano al tuo strumento di traduzione e a eventuali revisori umani esattamente cosa contiene ciascuna colonna. <\/p>\n\nColonne obbligatorie<\/h3>\n\n
Ogni CSV pronto per la traduzione necessita come minimo di una colonna chiave e una colonna di testo sorgente.<\/p>\n\n
La colonna key<\/code> contiene un identificatore univoco per ogni stringa. La tua applicazione lo usa per abbinare la traduzione corretta in fase di esecuzione. Usa una convenzione di denominazione coerente, limitati a lettere minuscole, trattini bassi e punti. Questa colonna non viene tradotta. I formati comuni includono button.submit<\/code>, error.invalid_login<\/code> e onboarding.welcome_message<\/code>. <\/p>\n\nLa colonna source_text<\/code> contiene il testo originale nella tua lingua di base, pronto per la traduzione.<\/p>\n\n\n
\n\n| key<\/th> | source_text<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n| button.submit<\/td>\n | Submit<\/td>\n<\/tr>\n |
\n| error.invalid_login<\/td>\n | Invalid username or password.<\/td>\n<\/tr>\n |
\n| onboarding.welcome_message<\/td>\n | Welcome to our app!<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Non modificare mai una chiave dopo l’inizio della traduzione. Farlo crea una nuova stringa e rende orfana la traduzione esistente. <\/p>\n\n Colonne opzionali<\/h3>\n\nIncludi una colonna context<\/code> o description<\/code> quando possibile. Stringhe brevi come “Salva” o “Indietro” possono avere significati diversi a seconda di dove appaiono nell’interfaccia. Una breve nota ti permette di tenere traccia di dove appare ciascuna stringa. <\/p>\n\nPer file di grandi dimensioni, una colonna namespace<\/code> o group<\/code> ti aiuta a organizzare le stringhe per funzionalit\u00e0 o sezione, rendendo il file significativamente pi\u00f9 facile da gestire e revisionare.<\/p>\n\n\n \n\n| key<\/th> | source_text<\/th> | context<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n| button.save<\/td>\n | Save<\/td>\n | Document editor toolbar<\/td>\n<\/tr>\n | \n| checkout.button.save<\/td>\n | Save<\/td>\n | Checkout address form<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Colonne delle lingue<\/h3>\n\nSe il tuo flusso di lavoro richiede di mantenere le lingue sorgente e di destinazione nello stesso file, aggiungi una colonna per ciascuna lingua di destinazione usando i codici lingua BCP-47 come intestazione. Ad esempio, usa es_ES<\/code> per lo spagnolo (Spagna) o fr_FR<\/code> per il francese. <\/p>\n\nCome gestire i placeholder e le variabili nella traduzione CSV<\/h2>\n\nFramework diversi usano sintassi di placeholder diverse. Assicurati di sapere quale formato si aspetta la tua applicazione e usalo in modo coerente in tutto il file: <\/p>\n\n \n \n\n| Formato<\/th> | Esempio<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n{variable}<\/code><\/td>\n| Hello, {username}!<\/td>\n<\/tr>\n | \n%s<\/code><\/td>\n| Hello, %s!<\/td>\n<\/tr>\n | \n{0}<\/code><\/td>\n| You have {0} new messages.<\/td>\n<\/tr>\n | \n%1$s<\/code><\/td>\n%1$s added you as a contact.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Se il tuo testo sorgente include tag HTML come <strong><\/code>, <br><\/code> o <a href=\"\"><\/code>, trattali allo stesso modo dei placeholder. <\/p>\n\nNon tradurre mai i placeholder o i tag HTML. PTC rileva e preserva automaticamente i placeholder e i tag HTML in tutti i formati supportati. Non li traduce n\u00e9 li modifica mai, e li mantiene nella posizione corretta in ciascuna lingua di destinazione. <\/p>\n\n Per gestire correttamente i plurali nelle diverse lingue, devi memorizzare le forme singolari e plurali in righe separate con chiavi distinte. Se combini le forme plurali in una singola stringa, le traduzioni non si adatteranno alle regole grammaticali di altre lingue. <\/p>\n\n Ad esempio:<\/p>\n\n | | | | | | |
![\"\"](\"https:\/\/ptc.wpml.org\/wp-content\/uploads\/2025\/04\/Border-min-1024x2.png\" "\\"Border-min\\"")
<\/figure><\/div>\n\n\n\n