Cómo traducir un EPUB con Calibre: configuración del plugin, modos de salida y verificación del archivo

Calibre no traduce libros por sí solo. Traduces un EPUB en Calibre con Ebook Translator, un plugin de terceros de bookfere que aparece en el índice de plugins de Calibre. Instálalo desde Preferencias → Complementos → Obtener nuevos complementos, elige un motor de traducción, decide si quieres solo la traducción o junto al original, y ejecútalo sobre un EPUB sin DRM. Obtendrás un nuevo EPUB en tu biblioteca de Calibre.

Configurarlo es la parte rápida. Lo que la mayoría de las guías omite es lo que el plugin le hace al libro durante el proceso. Hemos leído el código fuente de la versión actual (v2.4.2) para averiguarlo, y tres valores predeterminados importan más que el motor que elijas:

1. La salida predeterminada es bilingüe. Cada párrafo traducido se coloca debajo del original a menos que cambies la configuración de posición.
2. El formato en línea se aplana en el texto traducido. Las cursivas, negritas y enlaces dentro de un párrafo no se trasladan a la traducción. Solo se protege y se restaura una lista fija de etiquetas, como imágenes, saltos de línea y superíndices.
3. Cada ejecución es una conversión de Calibre. Incluso de EPUB a EPUB, el plugin entrega el libro al flujo de conversión de Calibre, que reconstruye el archivo de salida.

Nada de esto hace que el plugin sea una mala elección. Es gratuito, de código abierto (GPL-3.0) y muy configurable. Pero deberías saber qué revisar antes de leer el resultado o compartirlo.

Una nota sobre el método: esta guía se basa en el código fuente de la v2.4.2 del plugin, su documentación oficial y el manual de Calibre. No realizamos una traducción cronometrada para este artículo, por lo que no hace afirmaciones sobre velocidad, calidad de traducción ni qué motor da el mejor resultado.

Lo que necesitas antes de empezar

El plugin también acepta otros formatos que Calibre puede leer, como MOBI o AZW3. Dado que el libro pasa por la conversión de Calibre en cualquier caso, partir de un EPUB limpio te da la salida más predecible.

Instalar el plugin Ebook Translator

La documentación del plugin ofrece dos formas de instalarlo:

1. Desde dentro de Calibre (recomendado): abre Preferencias → Complementos → Obtener nuevos complementos, busca Ebook Translator, haz clic en Instalar y reinicia Calibre.
2. Desde un archivo: descarga el ZIP desde la página del complemento, luego usa Preferencias → Complementos → Cargar complemento desde archivo y reinicia.

Si el complemento no aparece en la barra de herramientas, añádelo en Preferencias → Barras de herramientas y menús → La barra de herramientas principal.

Calibre indica que el autor del complemento es bookfere.com. El equipo de Calibre no lo mantiene. Informa los problemas en el repositorio de GitHub del complemento, no a Calibre.

Modo por lotes o modo avanzado

El complemento tiene dos formas de ejecutar una traducción:

• Modo por lotes: selecciona uno o varios libros, establece el idioma de destino y el formato de salida, y haz clic en Traducir. La tarea se ejecuta en la cola de trabajos de Calibre. Úsalo para un primer borrador de un libro completo que planeas leer una vez.
• Modo avanzado: extrae los párrafos de un libro a una tabla, traduce todos o solo los seleccionados, edita cualquier traducción a mano y luego haz clic en Salida. Úsalo cuando el libro sea importante, por ejemplo cuando algunos capítulos necesiten retraducción o haya que corregir nombres, porque puedes corregir párrafos antes de que se escriba el EPUB.

Si vas a revisar la traducción de todos modos, el modo avanzado te permite hacer correcciones en el complemento. Con el modo por lotes, las harías después en el editor de Calibre.

Elige un motor de traducción

Un motor de Google gratuito es el predeterminado. La versión 2.4.2 ofrece estos motores (nombres tal como aparecen en el complemento):

Valores predeterminados que afectan a un libro largo:

• El intervalo entre solicitudes depende del motor. En el código fuente de la v2.4.2 es de 20 segundos para ChatGPT (OpenAI y Azure), 12 segundos para Claude, 1 segundo para Gemini y DeepL (Free), y 0 para la mayoría de los demás. La documentación sugiere aumentarlo si el servicio empieza a rechazar solicitudes.
• Los intentos son 3, y la ejecución se aborta tras 10 errores consecutivos. Establece el número de abortos en 0 para que nunca se detenga automáticamente.
• El tiempo de espera también depende del motor: 60 segundos para ChatGPT y DeepSeek, 30 segundos para Claude y Gemini, y 10 segundos para el resto.
• La opción Combinar para traducir está desactivada. Cuando está activada, el plugin envía párrafos en lotes de hasta 1800 caracteres. Los lotes dan a un LLM más contexto circundante por solicitud, pero una respuesta incorrecta afecta entonces a varios párrafos a la vez.
• El glosario está desactivado. Cuando está activado, lee un archivo de texto sin formato. Un término y su traducción van en dos líneas, un término que se debe dejar sin traducir va en una línea, y las entradas se separan con líneas en blanco.

El plugin es gratuito, pero la traducción no siempre lo es. Una novela de 300 páginas enviada a una API de pago se factura como cualquier otro uso de la API. Nuestras guías sobre ChatGPT, Claude y DeepSeek para traducción explican en qué suelen fallar cada uno de estos modelos en textos largos.

Elige una salida solo en el idioma de destino o bilingüe

La opción Posición de la traducción decide la forma del libro:

Si quieres un libro que puedas leer sin más, cambia la posición a Sin original antes de empezar, porque la opción predeterminada genera un libro bilingüe.

Ten cuidado con las opciones de izquierda y derecha. En el archivo de origen, cada par se reconstruye como una fila de tabla con tres celdas: original, un espacio y traducción. Con el espacio predeterminado del 10 %, las columnas de texto ocupan un 45 % cada una. En un teléfono o un lector de libros electrónicos de 6 pulgadas, eso se convierte en dos franjas estrechas de texto. Nuestra guía de EPUB bilingüe compara los diseños bilingües que resisten en pantallas pequeñas.

Qué modifica el plugin dentro de tu EPUB

Esta es la parte que los tutoriales genéricos omiten. La tabla resume lo que hace la v2.4.2 con cada tipo de contenido, según el código fuente (lib/element.py y lib/conversion.py en la etiqueta v2.4.2).

Dos de estos detalles causan el daño más visible.

Por qué desaparecen las cursivas y los enlaces. Para cada párrafo, el plugin construye el texto a traducir a partir del texto plano del párrafo. Solo las etiquetas de su lista de protegidas se sustituyen por marcadores. Un <em> o un <a> no está protegido ni ignorado, así que sus palabras se traducen y su marcado se pierde. En modo bilingüe, el párrafo original conserva su formato, por lo que el problema solo se ve en la línea traducida. En modo solo destino, el formato desaparece. Puedes añadir selectores en Reservar elemento, pero reservar un elemento lo mantiene sin traducir. Eso es útil para frases en otro idioma o títulos de libros que quieras conservar, y es incorrecto para el énfasis que quieres traducir.

Por qué pueden romperse las notas al pie. Los editores marcan las referencias a notas al pie de distintas maneras. El plugin tiene un caso especial para un enlace que envuelve solo un superíndice (<a href="#n1"><sup>1</sup></a>) y mantiene ese enlace intacto. Una referencia escrita como <a href="#n1" class="noteref">1</a> no tiene superíndice, así que el número sobrevive pero el enlace puede que no. Revisa las notas antes de confiar en una traducción solo destino de no ficción. Para libros japoneses y chinos, consulta cómo traducir anotaciones ruby de EPUB antes de decidir si perder el furigana es aceptable.

El elemento traducido también recibe un atributo lang para el idioma de destino y un atributo dir, lo que ayuda a los lectores de libros electrónicos a elegir fuentes y diseño de derecha a izquierda. En modo bilingüe, la traducción no copia el id del elemento original, por lo que los anclajes existentes siguen apuntando al párrafo original.

Por último, el manual de conversión de Calibre describe cómo funciona la conversión: la entrada se convierte en XHTML, se transforma y luego la escribe un plugin de salida. En el proceso, las transformaciones de Calibre pueden regenerar los metadatos y el índice. El plugin traduce después de esas transformaciones, justo antes de que el plugin de salida escriba el archivo. Por lo tanto, tu EPUB traducido es un libro reconstruido, no tu archivo original con texto nuevo. El manual de Calibre señala que su sistema de conversión "no es un sustituto de un editor de libros electrónicos completo".

Revisa el EPUB traducido en cinco minutos

No juzgues el resultado por el primer capítulo. Haz una comparación estructural entre el archivo original y el traducido. Un EPUB es un archivo ZIP, así que las herramientas de línea de comandos estándar pueden contar el marcado 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

Cómo interpretar el resultado:

• Una salida solo destino con muchas menos etiquetas <em>, <i> o <a que el original indica énfasis o enlaces aplanados. Eso es lo esperado según el comportamiento descrito. Decide si el libro puede vivir sin ellos.
• Menos etiquetas <img en la salida solo destino significa que se perdió un marcador de imagen. En la salida bilingüe, las imágenes pueden aparecer dos veces, así que confía mejor en la búsqueda de marcadores. Encuentra el capítulo y corrígelo en el modo avanzado o en el editor de Calibre.
• Cualquier texto {{id_…}} significa que un motor modificó un marcador de posición, por lo que el elemento protegido no se restauró.
• La salida bilingüe debería tener al menos tantas etiquetas como el original, porque se conservan los párrafos originales.

El patrón <em también coincide con <embed, algo poco frecuente en los libros, pero conviene saberlo si un recuento parece extraño.

Después, ejecuta EPUBCheck de la W3C sobre el archivo traducido. Ábrelo en el lector que vayas a usar realmente y revisa la lista de verificación de control de calidad de traducción de EPUB: navegación, notas, imágenes y el último párrafo de cada capítulo. Si el libro es para otras personas, pruébalo en Kindle, Kobo y Apple Books.

Si la traducción se detiene a mitad de camino

El plugin almacena en caché los párrafos traducidos de forma predeterminada. Si se cae la red o el motor empieza a rechazar solicitudes, vuelve a ejecutar el mismo libro con la misma configuración. Los párrafos que ya están en caché no se traducen de nuevo. En la práctica:

1. Abre el registro de la tarea en Jobs y busca errores repetidos, que suelen indicar limitación de velocidad o una clave de API caducada.
2. Aumenta el Interval o reduce el Concurrency limit de ese motor.
3. Vuelve a ejecutar el libro. La caché retoma donde se detuvo.
4. Usa Cache Manager para borrar la caché de un libro solo cuando quieras una traducción desde cero, por ejemplo después de editar tu glosario. Cambiar de motor o de idioma de destino ya inicia una caché aparte.

Cuándo Calibre es la herramienta adecuada y cuándo no

Usa el plugin de Calibre cuando:

• el libro no tenga DRM y ya esté en tu biblioteca de Calibre;
• quieras elegir y pagar tú mismo el motor;
• no te importe revisar párrafos en el modo Advanced; y
• el libro sea en su mayor parte prosa sencilla, de modo que perder el formato en línea cueste poco.

Busca otro flujo de trabajo cuando:

• el libro dependa del formato en línea, las referencias cruzadas o las notas enlazadas, como ocurre en muchos libros de texto y libros académicos;
• los nombres y términos deban mantenerse consistentes a lo largo de cientos de páginas y no quieras mantener tú mismo un archivo de glosario;
• prefieras no encargarte tú mismo de las comprobaciones y reparaciones de marcado; o
• no te sientas cómodo con claves de API, límites de velocidad y registros de tareas.

Si esa segunda lista describe tu libro, una opción es subir el EPUB a BookTranslator y ver el precio antes de pagar. Las tareas terminadas ofrecen tanto una descarga solo del idioma de destino como una bilingüe, y los nombres y términos clave se mantienen consistentes con un glosario integrado en lugar de un archivo que tú escribas. Es un servicio de pago. Sea cual sea la herramienta que uses, ejecuta la misma comprobación de marcado anterior sobre el resultado y revisa cualquier traducción larga antes de confiar en ella. La comparación de herramientas de traducción de EPUB pone en paralelo el plugin de Calibre, las herramientas del navegador y los servicios de archivos, por si quieres comparar antes de elegir.