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

O Calibre não traduz livros por si só. Traduz um EPUB no Calibre com o Ebook Translator, um plugin de terceiros da bookfere que está listado no índice de plugins do Calibre. Instale-o em Preferências → Plug-ins → Obter novos plugins, escolha um motor de tradução, decida se quer apenas a tradução ou ao lado do original e execute-o num EPUB sem DRM. 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 ao livro durante o processo. Analisámos o código-fonte da versão atual (v2.4.2) para descobrir, e três predefinições são mais importantes do que o motor que escolher:

1. A saída predefinida é bilingue. Cada parágrafo traduzido é colocado abaixo do original, a menos que altere a definição de posição.
2. A formatação inline é achatada no texto traduzido. Itálicos, negritos e ligações dentro de um parágrafo não são transportados para a tradução. Apenas uma lista fixa de etiquetas, como imagens, quebras de linha e sobrescritos, é protegida e reposta.
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 ficheiro de saída.

Nada disto torna o plugin uma má escolha. É gratuito, de código aberto (GPL-3.0) e muito configurável. Mas deve saber o que verificar antes de ler o resultado, ou de o partilhar.

Uma nota 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 realizámos uma tradução cronometrada para este artigo, pelo que não fazemos afirmações sobre velocidade, qualidade de tradução ou qual o motor que dá o melhor resultado.

O que 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 de qualquer forma pela conversão do Calibre, começar com um EPUB limpo dá-lhe o resultado mais previsível.

Instalar o plugin Ebook Translator

A documentação do plugin apresenta duas formas de o instalar:

1. De dentro do Calibre (recomendado): abra Preferências → Plug-ins → Obter novos plugins, procure Ebook Translator, clique em Instalar e reinicie o Calibre.
2. A partir de um ficheiro: transfira o ZIP da página inicial do plugin e, em seguida, utilize Preferências → Plug-ins → Carregar plug-in a partir de ficheiro 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 indica o autor do plugin como bookfere.com. A equipa do Calibre não o mantém. Comunique problemas ao repositório GitHub do plugin, não ao Calibre.

Modo em lote ou modo avançado

O plugin tem duas formas 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. Utilize este modo para uma primeira versão de um livro inteiro que planeia ler uma vez.
• Modo avançado: extraia os parágrafos de um livro para uma tabela, traduza todos ou apenas os selecionados, edite qualquer tradução manualmente e clique em Saída. Utilize este modo quando o livro for importante, por exemplo, quando alguns capítulos precisarem de ser retraduzidos ou nomes precisarem de correção, porque pode corrigir parágrafos antes de o EPUB ser criado.

Se for rever a tradução de qualquer forma, o modo avançado permite-lhe fazer correções no plugin. Com o modo em lote, fá-las-ia mais tarde no editor do Calibre.

Escolher um motor de tradução

Um motor Google gratuito é a predefinição. A versão 2.4.2 oferece estes motores (nomes conforme aparecem no plugin):

Predefinições que afetam um livro longo:

• O Intervalo entre pedidos depende do motor. 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 pedidos.
• O número de tentativas é 3 e a execução aborta após 10 erros consecutivos. Defina a contagem de abortagem como 0 para nunca parar automaticamente.
• O Timeout também depende do motor: 60 segundos para o ChatGPT e o DeepSeek, 30 segundos para o Claude e o Gemini e 10 segundos para os restantes.
• A opção Juntar para traduzir está desativada. Quando está ativada, o plugin envia parágrafos em lotes de até 1 800 caracteres. Os lotes dão a um LLM mais contexto envolvente por pedido, mas uma resposta má afeta então vários parágrafos de uma só vez.
• O Glossário está desativado. Quando está ativado, lê um ficheiro de texto simples. Um termo e a sua tradução ficam em duas linhas, um termo a deixar sem tradução fica numa 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 para uma API paga é cobrado como qualquer outra utilização da API. Os nossos guias sobre ChatGPT, Claude e DeepSeek para tradução explicam o que cada modelo tende a errar em textos longos.

Escolha uma saída apenas no idioma de destino ou bilingue

A definição Posição da tradução decide a forma do livro:

Se quiseres um livro que possas simplesmente ler, muda a posição para Sem original antes de começares, porque a predefinição produz um livro bilingue.

Tem 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 predefinido de 10%, as colunas de texto ficam com 45% de largura cada. Num telemóvel ou num leitor de e-reader de 6 polegadas, isso transforma-se em duas faixas estreitas de texto. O nosso guia de EPUB bilingue compara os esquemas bilingues que se mantêm legíveis em ecrãs pequenos.

O que o plugin altera dentro do teu EPUB

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

Dois destes detalhes causam os danos mais visíveis.

Porque desaparecem os itálicos e as ligações. Para cada parágrafo, o plugin constrói o texto a traduzir a partir do texto simples do parágrafo. Apenas as etiquetas da sua lista protegida são substituídas por marcadores de posição. Um <em> ou <a> não é protegido nem ignorado, pelo que as suas palavras são traduzidas e a sua marcação é perdida. No modo bilingue, o parágrafo original mantém a formatação, pelo que o problema só se manifesta na linha traduzida. No modo apenas destino, a formatação desaparece. Pode adicionar seletores em Reservar elemento, mas reservar um elemento mantém-no não traduzido. Isso é útil para expressões estrangeiras ou títulos de livros que quer manter, e errado para ênfases que quer traduzir.

Porque podem quebrar as notas de rodapé. Os editores marcam as referências de notas de rodapé de formas diferentes. O plugin tem um caso especial para uma ligação que envolve apenas um sobrescrito (<a href="#n1"><sup>1</sup></a>) e mantém essa ligação intacta. Uma referência escrita como <a href="#n1" class="noteref">1</a> não tem sobrescrito, pelo que o número sobrevive mas a ligação pode não sobreviver. Verifique as notas antes de confiar numa tradução apenas destino de não ficção. Para livros japoneses e chineses, consulte 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 de e-books a escolher tipos de letra e esquemas da direita para a esquerda. No modo bilingue, a tradução não copia o id do elemento original, pelo que as âncoras existentes continuam a apontar para o parágrafo original.

Por fim, o manual de conversão do Calibre descreve como funciona a conversão: a entrada é transformada em XHTML, modificada e depois escrita por um plugin de saída. Ao longo do processo, as transformações do Calibre podem regenerar os metadados e o índice. O plugin traduz após essas transformações, imediatamente antes de o plugin de saída escrever o ficheiro. O seu EPUB traduzido é, portanto, um livro reconstruído, não o seu ficheiro original com texto novo. O manual do Calibre observa que o seu sistema de conversão "não substitui 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 ficheiro original e o traduzido. Um EPUB é um arquivo ZIP, pelo que as ferramentas de linha de comandos 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 apenas destino com muito menos etiquetas <em>, <i> ou <a do que a fonte significa ênfase ou ligações achatadas. Isso é esperado pelo comportamento acima. Decida se o livro pode viver sem elas.
• Menos etiquetas <img na saída apenas destino significa que se perdeu um marcador de posição de imagem. Na saída bilingue, as imagens podem aparecer duas vezes, pelo que deve confiar antes na pesquisa de marcadores de posição. Encontre o capítulo e corrija-o no Modo Avançado ou no editor do Calibre.
• Qualquer texto {{id_…}} significa que um motor alterou um marcador de posição, pelo que o elemento protegido não foi restaurado.
• A saída bilingue deve ter pelo menos tantas etiquetas como o original, uma vez que os parágrafos originais são mantidos.

O padrão <em também corresponde a <embed, o que é raro em livros, mas vale a pena saber se uma contagem parecer estranha.

Em seguida, execute o EPUBCheck da W3C no ficheiro traduzido. Abra-o no leitor que vai realmente utilizar e verifique a lista de verificação de controlo de qualidade 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 a meio

O plugin coloca em cache os parágrafos traduzidos por predefinição. Se a rede falhar ou o motor começar a recusar pedidos, execute o mesmo livro novamente com as mesmas definições. Os parágrafos que já estão em cache não são traduzidos de novo. Na prática:

1. Abra o registo da tarefa em Tarefas e procure erros repetidos, que normalmente indicam limitação de pedidos ou uma chave de API expirada.
2. Aumente o Intervalo ou reduza o Limite de simultaneidade para esse motor.
3. Execute o livro novamente. A cache retoma a partir do ponto onde parou.
4. Utilize o Gestor de cache para limpar a cache de um livro apenas quando quiser uma tradução nova, por exemplo depois de editar o seu glossário. Mudar de motor ou de idioma de destino já inicia uma cache separada.

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

Utilize o plugin do Calibre quando:

• o livro não tem DRM e já está na sua biblioteca do Calibre;
• quiser escolher e pagar o motor você mesmo;
• não se importar de rever parágrafos no Modo Avançado; e
• o livro for maioritariamente prosa simples, pelo que perder a formatação em linha custa pouco.

Procure outro fluxo de trabalho quando:

• o livro depender de formatação em linha, referências cruzadas ou notas com ligações, como acontece em muitos manuais e livros académicos;
• os nomes e termos tiverem de se manter consistentes ao longo de centenas de páginas e não quiser manter um ficheiro de glossário você mesmo;
• preferir não fazer verificações e reparações de marcação você mesmo; ou
• não se sentir à vontade com chaves de API, limites de pedidos e registos de tarefas.

Se a segunda lista descreve o seu livro, uma opção é carregar o EPUB para o BookTranslator e ver o preço antes de pagar. As tarefas concluídas oferecem tanto uma transferência apenas do idioma de destino como uma bilingue, e os nomes e termos-chave são mantidos consistentes com um glossário incorporado em vez de um ficheiro que escreve. É um serviço pago. Independentemente da ferramenta que utilizar, execute a mesma verificação de marcação acima no resultado e reveja qualquer tradução longa antes de confiar nela. A comparação de ferramentas de tradução de EPUB coloca o plugin do Calibre, as ferramentas de navegador e os serviços de ficheiros lado a lado, se quiser comparar antes de escolher.