File e formati
Scopri tutti i formati di file accettati da AI Glot, il limite di dimensione per ciascuno, quale struttura viene preservata nel processo di traduzione e come preparare un export per un re-import pulito.
AI Glot accetta dodici famiglie di formati. Indipendentemente da ciò che carichi, la promessa è la stessa: le parole cambiano ma la struttura no, così il file può tornare esattamente dove proveniva.
Cosa puoi caricare
I limiti di dimensione sono per formato, non globali. Un limite adatto a un foglio di calcolo sarebbe fin troppo generoso per un file di localizzazione, dove pochi megabyte rappresentano già un catalogo enorme.
| Formato | Estensioni | Limite |
|---|---|---|
| CSV | .csv | 60 MB |
| Excel | .xlsx | 50 MB |
| Archive | .zip | 20 MB |
| XLIFF | .xlf, .xliff | 12 MB |
| Android resources | .xml | 12 MB |
| .NET resources | .resx | 12 MB |
| JSON | .json, .arb | 8 MB |
| YAML | .yaml, .yml | 4 MB |
| gettext | .po, .pot | 4 MB |
| iOS strings | .strings | 4 MB |
| Java properties | .properties | 4 MB |
| Subtitles | .srt | 4 MB |
Un file che supera il proprio limite viene rifiutato prima che i byte vengano memorizzati, quindi un caricamento eccessivo non ti costa nulla se non il tempo di accorgertene.
Cosa sopravvive al processo di traduzione
La struttura non è decorazione: è ciò che rende il risultato utilizzabile. Ogni famiglia ha la propria idea di cosa non debba cambiare.
| Famiglia | Preservato esattamente |
|---|---|
| CSV, Excel | Ordine delle colonne, identificatori, prezzi, URL, righe vuote, spazi bianchi |
| JSON, YAML | Ogni chiave, livello di nidificazione, ordine degli array, indentazione e variabile interpolata |
| XLIFF | Unità di localizzazione, placeholder e markup inline |
| gettext | ID dei messaggi, contesti e forme plurali |
| Android, iOS, .NET, Java | Chiavi delle risorse e i relativi specificatori di formato |
| Subtitles | Numerazione dei cue e timecode |
| Archive | L’albero delle cartelle e ogni nome di file al suo interno |
Le chiavi sono struttura, non parole. Un file JSON tradotto rientra direttamente nel repository perché nulla al di fuori dei valori si è spostato.
Lunghezza per cella
Ogni singolo valore sorgente selezionato per la traduzione può contenere fino a 50.000 caratteri Unicode. Dividi i contenuti HTML o editoriali più lunghi in diverse righe o campi più piccoli prima del caricamento.
Un valore tradotto è spesso più lungo dell’originale, quindi AI Glot mantiene un margine di archiviazione oltre il limite di input per il file finale.
Un archivio viene valutato anche in base al numero totale di valori dei suoi membri, non solo in base al limite di 20 MB: una traduzione che rientra ampiamente in tale limite di dimensione può comunque essere rifiutata se i suoi file, combinati, contengono troppi valori da tradurre. Se accade, dividi un archivio grande in archivi più piccoli.
Preparare un export di un foglio di calcolo
CSV ed Excel sono i due formati che le persone solitamente creano a mano, e i due in cui un export superficiale causa più problemi in seguito.
Mantieni identificatori stabili
Includi la chiave che il tuo sistema di destinazione usa per abbinare le righe, come un ID prodotto o un ID record, ed escludila da ciò che chiedi di tradurre.
Assegna nomi univoci alle colonne
Sostituisci le intestazioni vuote o duplicate prima del caricamento. description_en e description_fr sono molto più semplici da gestire rispetto a due colonne chiamate entrambe description.
Exporta CSV come UTF-8
Scegli l’opzione CSV UTF-8 nel tuo strumento di foglio di calcolo. Rinomina l’estensione di un file non ne converte i contenuti, ma non è più necessario convertire affatto, poiché .xlsx è accettato direttamente.
Conserva una copia della sorgente
La struttura viene preservata, ma l’export originale rimane il rollback più sicuro se il tuo sistema di destinazione rifiuta un import per motivi propri.
Specifiche CSV
| Requisito | Comportamento supportato |
|---|---|
| Codifica | UTF-8 rigoroso |
| Delimitatore | Virgola o punto e virgola, rilevato automaticamente |
| Fine riga | LF, CRLF o CR |
| Citazione | RFC 4180, incluse virgole e interruzioni di riga incorporate |
| Intestazioni | Ogni colonna necessita di un’intestazione univoca e non vuota |
| Righe | Almeno una riga di dati: ogni riga deve corrispondere alla larghezza dell’intestazione |
File rifiutati
Il browser applica le stesse regole strutturali del motore di traduzione prima che l’upload inizi, quindi un file malformato fallisce subito invece che dopo diversi minuti. Vengono rifiutati file vuoti, UTF-8 non valido, virgolette non chiuse o non escape, intestazioni vuote o duplicate, righe di dati mancanti, righe con un numero errato di colonne, estensioni non supportate e qualsiasi file che superi il limite del proprio formato.
Tramite API, gli stessi rifiuti arrivano come unsupported_format e file_too_large.