File e formati
Scopri tutti i formati di file supportati da AI Glot, i limiti di dimensione per ciascuno, quali elementi strutturali vengono preservati nella traduzione e come preparare un export pronto per essere reimportato.
AI Glot supporta dodici famiglie di formati. Qualunque sia il file caricato, la promessa non cambia: i testi cambiano, la struttura resta invariata, così che il file possa essere reinserito esattamente da dove proviene.
Cosa puoi caricare
I limiti di dimensione si applicano per singolo formato, non globalmente. Un limite adatto a un foglio di calcolo risulterebbe eccessivamente permissivo per un file di localizzazione, dove anche pochi megabyte rappresentano già un catalogo enorme.
| Formato | Estensioni | Limite |
|---|---|---|
| CSV | .csv | 60 MB |
| Excel | .xlsx | 50 MB |
| Archivio | .zip | 20 MB |
| XLIFF | .xlf, .xliff | 12 MB |
| Risorse Android | .xml | 12 MB |
| Risorse .NET | .resx | 12 MB |
| JSON | .json, .arb | 8 MB |
| YAML | .yaml, .yml | 4 MB |
| gettext | .po, .pot | 4 MB |
| iOS strings | .strings | 4 MB |
| Proprietà Java | .properties | 4 MB |
| Sottotitoli | .srt | 4 MB |
Un file che supera il limite viene rifiutato prima che venga salvato anche un solo byte: caricare un file troppo grande non costa nulla, se non il tempo di accorgersene.
Cosa viene preservato nel ciclo di elaborazione
La struttura non è un dettaglio secondario: è ciò che rende fruibile il risultato finale. Ogni famiglia di formati prevede regole precise su cosa debba rimanere inalterato.
| Famiglia | Elementi preservati fedelmente |
|---|---|
| CSV, Excel | Ordine delle colonne, identificatori, prezzi, URL, righe vuote, spazi bianchi |
| JSON, YAML | Ogni chiave, livello di nidificazione, ordine degli array, rientro (indentazione) e variabile interpolata |
| XLIFF | Unità di localizzazione, segnaposto (placeholder) e markup inline |
| gettext | ID messaggio, contesti e forme plurali |
| Android, iOS, .NET, Java | Chiavi di risorsa e relativi specificatori di formato |
| Sottotitoli | Numerazione delle battute e timecode |
| Archivio | Struttura delle cartelle e ogni nome file al suo interno |
Le chiavi costituiscono la struttura, non il testo. Un file JSON tradotto può essere reintrodotto direttamente nel repository perché nulla al di fuori dei valori è stato modificato.
Limite di caratteri per cella
Ogni singolo valore sorgente selezionato per la traduzione può contenere fino a 50.000 caratteri Unicode. Suddividi i contenuti HTML o redazionali più lunghi in più righe o campi più piccoli prima del caricamento.
Poiché un valore tradotto è spesso più lungo del testo di partenza, AI Glot riserva un margine di archiviazione superiore al limite di input per il file finale.
Preparare l’esportazione di un foglio di calcolo
CSV ed Excel sono i due formati solitamente creati a mano, nonché quelli in cui un’esportazione poco accurata rischia di creare i maggiori problemi in seguito.
Mantieni identificatori stabili
Includi la chiave utilizzata dal sistema di destinazione per abbinare le righe (ad esempio un ID prodotto o un ID record) ed escludila dalla richiesta di traduzione.
Assegna nomi univoci alle colonne
Sostituisci le intestazioni vuote o duplicate prima del caricamento. Gestire description_en e description_fr è molto più semplice rispetto ad avere due colonne chiamate entrambe description.
Esporta il CSV in formato UTF-8
Seleziona l’opzione CSV UTF-8 nel tuo software per fogli di calcolo. Rinominare l’estensione di un file non ne converte i contenuti; tuttavia, non è più necessario effettuare conversioni poiché i file .xlsx sono supportati direttamente.
Conserva una copia dell'originale
La struttura viene preservata, ma il file di esportazione originale resta il punto di ripristino più sicuro qualora il sistema di destinazione dovesse rifiutare l’importazione per vincoli specifici propri.
Specifiche per i file CSV
| Requisito | Comportamento supportato |
|---|---|
| Codifica | UTF-8 rigoroso |
| Delimitatore | Virgola o punto e virgola, rilevati automaticamente |
| Terminatori di riga | LF, CRLF o CR |
| Utilizzo delle virgolette | RFC 4180, inclusi virgole e ritorni a capo all’interno dei campi |
| Intestazioni | Ogni colonna deve avere un’intestazione univoca e non vuota |
| Righe | Almeno una riga di dati; ogni riga deve corrispondere al numero di colonne dell’intestazione |
File rifiutati
Il browser applica le stesse regole strutturali del motore di traduzione prima ancora che inizi l’upload; in questo modo, un file non conforme viene segnalato all’istante anziché dopo diversi minuti. Vengono rifiutati i file vuoti, con codifica UTF-8 non valida, con virgolette non chiuse o senza escape, con intestazioni vuote o duplicate, privi di righe di dati, con un numero di colonne non corrispondente, con estensione non supportata o che superano il limite dimensionale del formato.
Tramite API, questi stessi rifiuti vengono restituiti con i codici di errore unsupported_format e file_too_large.