Traduzir arquivos CSV de localização
Um CSV de localização de jogos tem uma coluna de chave e uma coluna por idioma. KAERIS lê a chave e a coluna de origem e adiciona uma coluna para cada idioma de destino.
KAERIS traduziu esta página e verificou cada linha traduzindo-a de volta. Um falante nativo ainda não revisou. Original em inglês
Como um CSV de localização é construído
A primeira coluna é a chave, a segunda o texto de origem; o cabeçalho nomeia as colunas (keys,en). Células com vírgulas ou quebras de linha são entre aspas. Linhas completamente vazias são ignoradas.
keys,en GREETING,"Welcome back, %s!" ITEMS,"You have {count} items, %d of them new" QUIT,Quit game
O que observar em traduções de CSV
Uma coluna por idioma
A saída tem a coluna de chave, a coluna de origem, depois
de,jae assim por diante. Seus nomes de coluna de chave e origem são mantidos.Fórmulas
Uma célula que começa com
=,+,-ou@é escrita com um apóstrofo inicial para que o Excel mostre o texto em vez de executar uma fórmula.Variáveis Printf e entre chaves
%s,%de{count}em uma célula são comparados com a origem. Na execução real abaixo, todos os três voltaram.Aspas
Vírgulas e aspas dentro de uma célula são colocadas entre aspas por um escritor de CSV, então uma célula traduzida não pode invadir a próxima coluna.
Uma execução real: traduzido para Alemão e verificado
Uma execução real, 27 de outubro de 2026, nada editado manualmente: kaeris translate translations.csv --langs de com kaeris 0.2.35, 2,5 segundos, modelo google/gemini-2.5-flash-lite, o padrão de nível gratuito. Abaixo, o arquivo alemão que ele escreveu e o que kaeris check diz sobre ele.
keys,en,de GREETING,"Welcome back, %s!","Willkommen zurück, %s!" ITEMS,"You have {count} items, %d of them new","Sie haben {count} Artikel, davon %d neu" QUIT,Quit game,Spiel beenden
$ kaeris check --source translations.csv --langs de ✓ de: complete & placeholder-safe ✓ all locales complete & placeholder-safe
O que o KAERIS faz com isso
Mesmas colunas, mais idiomas
As colunas de chave e origem são mantidas; cada idioma de destino é uma nova coluna. No terminal, o resultado é escrito em
translations/localization.csvao lado da origem, ekaeris checko lê de lá.Células seguras para planilhas
Células com aparência de fórmula são escritas como texto. Veja a página de Jogos para o lado do motor de jogo.
Verificação gratuita para este formato
A verificação gratuita em /check lê este formato e executa sem chave ou conta. O comando de terminal
kaeris checktambém o lê: ele aceita todos os 13 formatos desde kaeris 0.2.35, com as mesmas regras e nada enviado para lugar nenhum.
Execute em três etapas
Instale o CLI
Execute
pip install kaeris.Traduza a planilha
Execute
kaeris translate localization.csv --langs de,ja,fr.Verifique o resultado
Execute
kaeris check --source localization.csv --langs de,ja,frou envie o arquivo na página de verificação gratuita: ambos leem a coluna de cada idioma.
pip install kaeris kaeris translate localization.csv --langs de,ja,fr --verify
Perguntas
Funciona para Godot e Unity?
O formato é coluna de chave, coluna de origem, colunas de idioma, como esses motores esperam. Veja a página de Jogos.
Uma célula começando com = será executada como uma fórmula?
Não. Tais células são escritas de forma que uma planilha as exiba como texto.
É gratuito?
Sim, sem conta: 10.000 caracteres por arquivo e até 8 idiomas por execução. Uma chave API gratuita eleva o limite para 50.000 caracteres. A licença vitalícia custa $79 uma vez, usando sua própria chave OpenRouter; planos mensais começam em $19. Preços
Posso rodar pelo terminal ou em CI?
Sim. pip install kaeris, então kaeris translate localization.csv --langs de,ja. O GitHub Action executa a mesma tradução em um pull request. Docs do CLI · GitHub Action
Continue
Referência do CLI · Referência de verificação · Traduzir no navegador · Verificação gratuita · Converter formatos · Pseudo-localização
Outros formatos: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML