Arquivos e formatos
Veja todos os formatos de arquivo que o AI Glot aceita, o limite de tamanho para cada um, qual estrutura é preservada no processo e como preparar uma exportação que seja reimportada sem erros.
O AI Glot aceita doze famílias de formatos. Independentemente do que você enviar, a promessa é a mesma: as palavras mudam, mas a estrutura não, para que o arquivo retorne exatamente para onde veio.
O que você pode enviar
Os limites de tamanho são por formato, e não globais. Um limite que funciona para uma planilha seria generoso demais para um arquivo de locale, onde alguns megabytes já representam um catálogo enorme.
| Formato | Extensões | 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 |
Um arquivo que exceda o limite é recusado antes que qualquer byte seja armazenado, portanto, um upload excessivo não custa nada além do tempo de perceber o erro.
O que sobrevive ao processo
A estrutura não é decoração: é o que torna o resultado utilizável. Cada família tem sua própria definição do que não deve ser alterado.
| Família | Preservado exatamente |
|---|---|
| CSV, Excel | Ordem das colunas, identificadores, preços, URLs, linhas em branco, espaços |
| JSON, YAML | Cada chave, nível de aninhamento, ordem de arrays, indentação e variável interpolada |
| XLIFF | Unidades de localização, placeholders e marcação inline |
| gettext | IDs de mensagem, contextos e formas plurais |
| Android, iOS, .NET, Java | Chaves de recurso e seus especificadores de formato |
| Subtitles | Numeração de legendas e timecodes |
| Archive | A árvore de pastas e cada nome de arquivo dentro dela |
As chaves são estrutura, não palavras. Um arquivo JSON traduzido volta direto para o repositório porque nada fora dos valores foi movido.
Comprimento por célula
Cada valor de origem individual selecionado para tradução pode conter até 50.000 caracteres Unicode. Divida conteúdos HTML longos ou editoriais em várias linhas ou campos menores antes de enviar.
Um valor traduzido costuma ser mais longo que o original, por isso o AI Glot mantém uma margem de armazenamento acima do limite de entrada para o arquivo final.
Um arquivo compactado (archive) também é avaliado pela soma de valores de seus membros, e não apenas pelo limite de 20 MB: uma tradução que esteja bem abaixo desse limite de tamanho ainda pode ser recusada se seus arquivos, combinados, possuírem valores demais para traduzir. Divida um arquivo compactado grande em arquivos menores se isso acontecer.
Preparando a exportação de uma planilha
CSV e Excel são os dois formatos que as pessoas geralmente criam manualmente, e os dois onde uma exportação descuidada causa mais problemas posteriormente.
Mantenha identificadores estáveis
Inclua a chave que seu sistema de destino usa para corresponder as linhas, como um ID de produto ou ID de registro, e deixe-a fora do que você solicita traduzir.
Dê nomes únicos às colunas
Substitua cabeçalhos em branco ou duplicados antes do upload. description_en e description_fr são muito mais fáceis de analisar do que duas colunas chamadas description.
Exporte CSV como UTF-8
Escolha a opção CSV UTF-8 na sua ferramenta de planilha. Renomear a extensão de um arquivo não converte seu conteúdo, mas você não precisa mais converter, já que .xlsx é aceito diretamente.
Mantenha uma cópia da origem
A estrutura é preservada, mas a exportação original ainda é o rollback mais seguro se o seu sistema de destino rejeitar uma importação por motivos próprios.
Especificações de CSV
| Requisito | Comportamento suportado |
|---|---|
| Codificação | UTF-8 Estrito |
| Delimitador | Vírgula ou ponto e vírgula, detectados automaticamente |
| Fim de linha | LF, CRLF ou CR |
| Aspas | RFC 4180, incluindo vírgulas e quebras de linha incorporadas |
| Cabeçalhos | Cada coluna precisa de um cabeçalho único e não vazio |
| Linhas | Pelo menos uma linha de dados: cada linha deve corresponder à largura do cabeçalho |
Arquivos recusados
O navegador aplica as mesmas regras estruturais que o motor de tradução antes do início do upload, portanto, um arquivo malformado falha diante de você, e não vários minutos depois. Ele recusa arquivos vazios, UTF-8 inválido, aspas não fechadas ou não escapadas, cabeçalhos vazios ou duplicados, linhas de dados ausentes, linhas com o número errado de colunas, extensões não suportadas e qualquer arquivo acima do limite de seu formato.
Via API, as mesmas recusas chegam como unsupported_format e file_too_large.