Como traduzir um EPUB com o Calibre: instalação do plugin, modos de saída e verificação do arquivo

O Calibre não traduz livros sozinho. Você traduz um EPUB no Calibre com o Ebook Translator, um plugin de terceiros do bookfere que está listado no índice de plugins do Calibre. Instale-o em Preferências → Plug-ins → Obter novos plugins, escolha um mecanismo de tradução, decida se quer apenas a tradução ou ao lado do original e execute-o em um EPUB sem DRM. Você obtém um novo EPUB na sua biblioteca do Calibre.

A instalação é a parte rápida. O que a maioria dos guias omite é o que o plugin faz com o livro ao longo do caminho. Lemos o código-fonte da versão atual (v2.4.2) para descobrir, e três padrões importam mais do que o mecanismo que você escolhe:

1. A saída padrão é bilíngue. Cada parágrafo traduzido é colocado abaixo do original, a menos que você altere a configuração de posição.
2. A formatação embutida é achatada no texto traduzido. Itálico, negrito e links dentro de um parágrafo não são transportados para a tradução. Apenas uma lista fixa de tags, como imagens, quebras de linha e sobrescritos, é protegida e recolocada.
3. Cada execução é uma conversão do Calibre. Mesmo de EPUB para EPUB, o plugin entrega o livro ao pipeline de conversão do Calibre, que reconstrói o arquivo de saída.

Nada disso torna o plugin uma má escolha. Ele é gratuito, de código aberto (GPL-3.0) e muito configurável. Mas você deve saber o que verificar antes de ler o resultado ou compartilhá-lo.

Uma observação sobre o método: este guia baseia-se no código-fonte da v2.4.2 do plugin, na sua documentação oficial e no manual do Calibre. Não executamos uma tradução cronometrada para este artigo, portanto ele não faz afirmações sobre velocidade, qualidade da tradução ou qual mecanismo dá o melhor resultado.

O que você precisa antes de começar

O plugin também aceita outros formatos que o Calibre consegue ler, como MOBI ou AZW3. Como o livro passa pela conversão do Calibre de qualquer forma, começar de um EPUB limpo oferece a saída mais previsível.

Instale o plugin Ebook Translator

A documentação do plugin oferece duas maneiras de instalá-lo:

1. De dentro do Calibre (recomendado): abra Preferências → Plug-ins → Obter novos plugins, procure por Ebook Translator, clique em Instalar e reinicie o Calibre.
2. A partir de um arquivo: baixe o ZIP na página inicial do plugin, depois use Preferências → Plug-ins → Carregar plug-in de arquivo e reinicie.

Se o plugin não aparecer na barra de ferramentas, adicione-o em Preferências → Barras de ferramentas e menus → A barra de ferramentas principal.

O Calibre lista o autor do plugin como bookfere.com. A equipe do Calibre não o mantém. Relate problemas no repositório do plugin no GitHub, não ao Calibre.

Modo em lote ou Modo avançado

O plugin tem duas maneiras de executar uma tradução:

• Modo em lote: selecione um ou mais livros, defina o idioma de destino e o formato de saída, e clique em Traduzir. A tarefa é executada na fila de tarefas do Calibre. Use isso para um primeiro rascunho de um livro inteiro que você pretende ler uma vez.
• Modo avançado: extraia os parágrafos de um livro para uma tabela, traduza todos eles ou apenas os selecionados, edite qualquer tradução manualmente e clique em Saída. Use isso quando o livro for importante, por exemplo, quando alguns capítulos precisarem ser retraduzidos ou nomes precisarem ser corrigidos, pois você pode corrigir parágrafos antes de o EPUB ser gerado.

Se você for revisar a tradução de qualquer forma, o Modo avançado permite fazer correções no próprio plugin. Com o Modo em lote, você as faria depois no editor do Calibre.

Escolha um mecanismo de tradução

Um mecanismo Google gratuito é o padrão. A versão 2.4.2 oferece estes mecanismos (nomes como aparecem no plugin):

Padrões que afetam um livro longo:

• O Intervalo entre requisições depende do mecanismo. No código-fonte da v2.4.2, é de 20 segundos para o ChatGPT (OpenAI e Azure), 12 segundos para o Claude, 1 segundo para o Gemini e o DeepL (Free) e 0 para a maioria dos outros. A documentação sugere aumentá-lo se o serviço começar a recusar requisições.
• Tentativas é 3, e a execução aborta após 10 erros consecutivos. Defina a contagem de aborto como 0 para nunca parar automaticamente.
• O Timeout também depende do mecanismo: 60 segundos para o ChatGPT e o DeepSeek, 30 segundos para o Claude e o Gemini e 10 segundos para os demais.
• Mesclar para traduzir está desativado. Quando ativado, o plugin envia parágrafos em lotes de até 1.800 caracteres. Os lotes dão a um LLM mais contexto ao redor por requisição, mas uma resposta ruim passa a afetar vários parágrafos de uma vez.
• O Glossário está desativado. Quando ativado, ele lê um arquivo de texto simples. Um termo e sua tradução ficam em duas linhas, um termo a ser deixado sem tradução fica em uma linha, e as entradas são separadas por linhas em branco.

O plugin é gratuito, mas a tradução nem sempre é gratuita. Um romance de 300 páginas enviado a uma API paga é cobrado como qualquer outro uso de API. Nossos guias sobre ChatGPT, Claude e DeepSeek para tradução explicam o que cada modelo costuma errar em textos longos.

Escolha a saída apenas no idioma de destino ou bilíngue

A configuração Posição da tradução decide o formato do livro:

Se você quer um livro que possa simplesmente ler, mude a posição para Sem original antes de começar, porque o padrão produz um livro bilíngue.

Cuidado com as opções esquerda e direita. No original, cada par é reconstruído como uma linha de tabela com três células: original, um espaço e tradução. Com o espaço padrão de 10%, as colunas de texto ficam com 45% de largura cada. Em um celular ou um e-reader de 6 polegadas, isso vira duas faixas estreitas de texto. Nosso guia de EPUB bilíngue compara os layouts bilíngues que funcionam bem em telas pequenas.

O que o plugin altera dentro do seu EPUB

Esta é a parte que os tutoriais genéricos deixam de fora. A tabela resume o que a v2.4.2 faz com cada tipo de conteúdo, com base no código-fonte (lib/element.py e lib/conversion.py na tag v2.4.2).

Dois desses detalhes causam os danos mais visíveis.

Por que itálicos e links desaparecem. Para cada parágrafo, o plugin monta o texto a traduzir a partir do texto simples do parágrafo. Apenas as tags em sua lista de protegidas são substituídas por marcadores. Um <em> ou <a> não é protegido nem ignorado, então suas palavras são traduzidas e sua marcação é perdida. No modo bilíngue, o parágrafo original mantém sua formatação, então o problema só aparece na linha traduzida. No modo somente destino, a formatação se perde. Você pode adicionar seletores em Reserve Element, mas reservar um elemento o mantém não traduzido. Isso é útil para frases estrangeiras ou títulos de livros que você quer manter, e errado para ênfases que você quer traduzir.

Por que as notas de rodapé podem quebrar. As editoras marcam referências de notas de rodapé de maneiras diferentes. O plugin tem um caso especial para um link que envolve apenas um sobrescrito (<a href="#n1"><sup>1</sup></a>) e mantém esse link intacto. Uma referência escrita como <a href="#n1" class="noteref">1</a> não tem sobrescrito, então o número sobrevive, mas o link pode não sobreviver. Verifique as notas antes de confiar em uma tradução somente destino de não ficção. Para livros japoneses e chineses, veja como traduzir anotações ruby de EPUB antes de decidir se perder o furigana é aceitável.

O elemento traduzido também recebe um atributo lang para o idioma de destino e um atributo dir, o que ajuda os leitores digitais a escolher fontes e layout da direita para a esquerda. No modo bilíngue, a tradução não copia o id do elemento original, então âncoras existentes ainda apontam para o parágrafo original.

Por fim, o manual de conversão do Calibre descreve como a conversão funciona: a entrada é transformada em XHTML, modificada e então gravada por um plugin de saída. Ao longo do caminho, as transformações do Calibre podem regenerar os metadados e o sumário. O plugin traduz após essas transformações, pouco antes de o plugin de saída gravar o arquivo. Seu EPUB traduzido é, portanto, um livro reconstruído, não seu arquivo original com texto novo. O manual do Calibre observa que seu sistema de conversão "não é um substituto para um editor de e-books completo".

Verifique o EPUB traduzido em cinco minutos

Não julgue o resultado pelo primeiro capítulo. Faça uma comparação estrutural entre o arquivo original e o traduzido. Um EPUB é um arquivo ZIP, então ferramentas de linha de comando padrão podem contar a marcação de cada lado:

mkdir src out
unzip -q original.epub -d src
unzip -q translated.epub -d out
for tag in '<em' '<i[ >]' '<strong' '<a ' '<sup' '<img' '<rt'; do
  s=$(grep -rhoE "$tag" src --include='*htm*' | wc -l)
  o=$(grep -rhoE "$tag" out --include='*htm*' | wc -l)
  printf '%-10s source=%-6s output=%s\n' "$tag" "$s" "$o"
done
grep -rho '{{id_[0-9]*}}' out | head

Como interpretar o resultado:

• Saída somente destino com muito menos tags <em>, <i> ou <a do que a fonte significa ênfase ou links achatados. Isso é esperado pelo comportamento acima. Decida se o livro pode viver sem eles.
• Menos tags <img na saída somente destino significa que um marcador de imagem foi perdido. Na saída bilíngue, as imagens podem aparecer duas vezes, então confie na busca por marcadores. Encontre o capítulo e corrija no Modo Avançado ou no editor do Calibre.
• Qualquer texto {{id_…}} significa que um mecanismo alterou um placeholder, então o elemento protegido não foi restaurado.
• A saída bilíngue deve ter pelo menos tantas tags quanto o original, porque os parágrafos originais são mantidos.

O padrão <em também corresponde a <embed, o que é raro em livros, mas vale saber caso uma contagem pareça estranha.

Em seguida, execute o EPUBCheck do W3C no arquivo traduzido. Abra-o no leitor que você realmente vai usar e verifique a lista de verificação de QA de tradução de EPUB: navegação, notas, imagens e o último parágrafo de cada capítulo. Se o livro for para outras pessoas, teste-o no Kindle, Kobo e Apple Books.

Se a tradução parar no meio

O plugin armazena em cache os parágrafos traduzidos por padrão. Se a rede cair ou o mecanismo começar a recusar solicitações, execute o mesmo livro novamente com as mesmas configurações. Os parágrafos que já estão em cache não são traduzidos de novo. Na prática:

1. Abra o log da tarefa em Jobs e procure erros repetidos, que geralmente indicam limitação de taxa ou uma chave de API expirada.
2. Aumente o Interval ou reduza o Concurrency limit para esse mecanismo.
3. Execute o livro novamente. O cache continua de onde parou.
4. Use o Cache Manager para limpar o cache de um livro apenas quando quiser uma tradução nova, por exemplo, após editar seu glossário. Trocar o mecanismo ou o idioma de destino já inicia um cache separado.

Quando o Calibre é a ferramenta certa, e quando não é

Use o plugin do Calibre quando:

• o livro não tem DRM e já está na sua biblioteca do Calibre;
• você quer escolher e pagar pelo mecanismo você mesmo;
• você não se importa de revisar parágrafos no Modo Avançado; e
• o livro é principalmente texto simples, então perder a formatação embutida custa pouco.

Procure outro fluxo de trabalho quando:

• o livro depende de formatação embutida, referências cruzadas ou notas vinculadas, como muitos livros didáticos e acadêmicos fazem;
• nomes e termos precisam permanecer consistentes ao longo de centenas de páginas e você não quer manter um arquivo de glossário você mesmo;
• você prefere não executar verificações e reparos de marcação você mesmo; ou
• você não se sente confortável com chaves de API, limites de taxa e logs de tarefas.

Se essa segunda lista descreve seu livro, uma opção é enviar o EPUB para o BookTranslator e ver o preço antes de pagar. Tarefas concluídas oferecem download apenas do destino e bilíngue, e nomes e termos-chave são mantidos consistentes com um glossário integrado em vez de um arquivo que você escreve. É um serviço pago. Qualquer que seja a ferramenta que você use, execute a mesma verificação de marcação acima na saída e revise qualquer tradução longa antes de confiar nela. A comparação de ferramentas de tradução de EPUB coloca o plugin do Calibre, ferramentas de navegador e serviços de arquivo lado a lado, se você quiser comparar antes de escolher.