Arquivos e formatos
Veja todos os formatos de arquivo aceitos pelo AI Glot, o limite de tamanho de cada um, qual estrutura é preservada no ciclo de tradução e como preparar uma exportação que possa ser reimportada sem problemas.
O AI Glot aceita doze famílias de formatos. Independentemente do que você enviar, a promessa é a mesma: as palavras mudam e a estrutura é mantida, para que o arquivo volte exatamente para o seu local de origem.
O que você pode enviar
Os limites de tamanho são por formato, não globais. Um limite adequado para uma planilha seria excessivo para um arquivo de localização, onde alguns megabytes já representam um catálogo enorme.
| Formato | Extensões | Limite |
|---|---|---|
| CSV | .csv | 60 MB |
| Excel | .xlsx | 50 MB |
| Arquivo compactado | .zip | 20 MB |
| XLIFF | .xlf, .xliff | 12 MB |
| Recursos do Android | .xml | 12 MB |
| Recursos do .NET | .resx | 12 MB |
| JSON | .json, .arb | 8 MB |
| YAML | .yaml, .yml | 4 MB |
| gettext | .po, .pot | 4 MB |
| Strings do iOS | .strings | 4 MB |
| Propriedades Java | .properties | 4 MB |
| Legendas | .srt | 4 MB |
Um arquivo que exceda o limite é recusado antes que qualquer byte seja armazenado; assim, o envio de um arquivo grande demais não custa nada além do tempo para perceber.
O que é preservado no ciclo de tradução
A estrutura não é mero detalhe; é o que torna o resultado utilizável. Cada família possui suas próprias regras sobre o que não deve ser alterado.
| Família | Preservado exatamente |
|---|---|
| CSV, Excel | Ordem das colunas, identificadores, preços, URLs, linhas em branco, espaços em branco |
| JSON, YAML | Todas as chaves, níveis de aninhamento, ordem dos arrays, indentação e variáveis interpoladas |
| XLIFF | Unidades de localização, placeholders e marcação inline |
| gettext | IDs de mensagem, contextos e formas plurais |
| Android, iOS, .NET, Java | Chaves de recursos e seus especificadores de formato |
| Legendas | Numeração de legendas e marcações de tempo (timecodes) |
| Arquivo compactado | A árvore de diretórios e cada nome de arquivo dentro dela |
As chaves fazem parte da estrutura, não do texto. Um arquivo JSON traduzido se encaixa perfeitamente de volta no repositório porque nada fora dos valores foi alterado.
Tamanho por célula
Cada valor de origem individual selecionado para tradução pode conter até 50.000 caracteres Unicode. Divida conteúdos editoriais ou HTML mais longos em várias linhas ou campos menores antes de fazer o upload.
Um valor traduzido costuma ser mais longo do que o original, por isso o AI Glot mantém uma margem de armazenamento acima do limite de entrada para o arquivo final.
Como preparar a exportação de uma planilha
CSV e Excel são os dois formatos que as pessoas costumam criar manualmente e 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 de fora do que você solicitar para traduzir.
Dê nomes exclusivos às colunas
Substitua cabeçalhos em branco ou duplicados antes do upload. É muito mais fácil trabalhar com description_en e description_fr do que com duas colunas chamadas description.
Exporte o CSV como UTF-8
Escolha a opção de CSV em UTF-8 no seu editor de planilhas. Renomear a extensão de um arquivo não converte seu conteúdo, mas você não precisa mais converter nada, já que arquivos .xlsx são aceitos diretamente.
Mantenha uma cópia do arquivo original
A estrutura é preservada, mas a exportação original ainda é a opção de restauração mais segura se o seu sistema de destino rejeitar uma importação por motivos próprios.
Especificidades do CSV
| Requisito | Comportamento suportado |
|---|---|
| Codificação | UTF-8 estrito |
| Delimitador | Vírgula ou ponto e vírgula, detectado automaticamente |
| Quebras de linha | LF, CRLF ou CR |
| Aspas | RFC 4180, incluindo vírgulas incorporadas e quebras de linha |
| Cabeçalhos | Cada coluna precisa de um cabeçalho exclusivo e não vazio |
| Linhas | Pelo menos uma linha de dados; todas as linhas devem corresponder ao número de colunas do cabeçalho |
Arquivos rejeitados
O navegador aplica as mesmas regras estruturais do mecanismo de tradução antes do início do upload, portanto, um arquivo malformado falha imediatamente em vez de vários minutos depois. Ele rejeita arquivos vazios, UTF-8 inválido, aspas não fechadas ou sem escape, cabeçalhos vazios ou duplicados, linhas de dados ausentes, linhas com número incorreto de colunas, extensões não suportadas e qualquer arquivo que ultrapasse o limite do seu formato.
Na API, essas mesmas recusas são retornadas como unsupported_format e file_too_large.