Comment traduire un EPUB avec Calibre : installation du plugin, modes de sortie et vérification du fichier

Calibre ne traduit pas les livres par lui-même. Vous traduisez un EPUB dans Calibre avec Ebook Translator, un plugin tiers de bookfere référencé dans l'index des plugins de Calibre. Installez-le depuis Préférences → Extensions → Obtenir de nouvelles extensions, choisissez un moteur de traduction, décidez si vous voulez la traduction seule ou à côté de l'original, puis lancez-le sur un EPUB sans DRM. Vous obtenez un nouvel EPUB dans votre bibliothèque Calibre.

L'installation est la partie rapide. Ce que la plupart des guides passent sous silence, c'est ce que le plugin fait au livre en cours de route. Nous avons lu le code source de la version actuelle (v2.4.2) pour le découvrir, et trois réglages par défaut comptent plus que le moteur que vous choisissez :

1. La sortie par défaut est bilingue. Chaque paragraphe traduit est placé sous l'original, sauf si vous modifiez le réglage de position.
2. La mise en forme en ligne est aplatie dans le texte traduit. Les italiques, les gras et les liens à l'intérieur d'un paragraphe ne sont pas reportés dans la traduction. Seule une liste fixe de balises, comme les images, les sauts de ligne et les exposants, est protégée et réinsérée.
3. Chaque exécution est une conversion Calibre. Même pour un EPUB vers EPUB, le plugin confie le livre au pipeline de conversion de Calibre, qui reconstruit le fichier de sortie.

Rien de tout cela ne fait du plugin un mauvais choix. Il est gratuit, open source (GPL-3.0) et très configurable. Mais vous devez savoir quoi vérifier avant de lire le résultat, ou de le partager.

Une note sur la méthode : ce guide s'appuie sur le code source de la v2.4.2 du plugin, sa documentation officielle et le manuel de Calibre. Nous n'avons pas chronométré de traduction pour cet article, il n'avance donc aucune affirmation sur la vitesse, la qualité de traduction ou le moteur qui donne le meilleur résultat.

Ce qu'il vous faut avant de commencer

Le plugin accepte aussi d'autres formats que Calibre peut lire, comme MOBI ou AZW3. Comme le livre passe de toute façon par la conversion Calibre, partir d'un EPUB propre donne la sortie la plus prévisible.

Installer le plugin Ebook Translator

La documentation du plugin propose deux méthodes d'installation :

1. Depuis Calibre (recommandé) : ouvrez Préférences → Extensions → Obtenir de nouvelles extensions, recherchez Ebook Translator, cliquez sur Installer, puis redémarrez Calibre.
2. À partir d'un fichier : téléchargez le ZIP depuis la page d'accueil de l'extension, puis utilisez Préférences → Extensions → Charger l'extension depuis un fichier et redémarrez.

Si l'extension n'apparaît pas dans la barre d'outils, ajoutez-la dans Préférences → Barres d'outils et menus → La barre d'outils principale.

Calibre indique bookfere.com comme auteur de l'extension. L'équipe de Calibre ne la maintient pas. Signalez les problèmes au dépôt GitHub de l'extension, et non à Calibre.

Mode par lots ou mode avancé

L'extension propose deux façons de lancer une traduction :

• Mode par lots : sélectionnez un ou plusieurs livres, définissez la langue cible et le format de sortie, puis cliquez sur Traduire. La tâche s'exécute dans la file d'attente des tâches de Calibre. Utilisez ce mode pour une première ébauche d'un livre entier que vous prévoyez de lire une seule fois.
• Mode avancé : extrayez les paragraphes d'un livre dans un tableau, traduisez-les tous ou seulement certains, modifiez manuellement n'importe quelle traduction, puis cliquez sur Sortie. Utilisez ce mode lorsque le livre compte, par exemple lorsque quelques chapitres doivent être retraduits ou que des noms doivent être corrigés, car vous pouvez corriger les paragraphes avant que l'EPUB ne soit généré.

Si vous comptez de toute façon relire la traduction, le mode avancé vous permet d'apporter des corrections dans l'extension. Avec le mode par lots, vous les apporteriez plus tard dans l'éditeur de Calibre.

Choisir un moteur de traduction

Un moteur Google gratuit est utilisé par défaut. La version 2.4.2 propose ces moteurs (noms tels qu'ils apparaissent dans l'extension) :

Valeurs par défaut qui affectent un livre long :

• L'intervalle entre les requêtes dépend du moteur. Dans le code source de la v2.4.2, il est de 20 secondes pour ChatGPT (OpenAI et Azure), 12 secondes pour Claude, 1 seconde pour Gemini et DeepL (gratuit), et 0 pour la plupart des autres. La documentation suggère de l'augmenter si le service commence à refuser les requêtes.
• Le nombre de tentatives est de 3, et l'exécution s'interrompt après 10 erreurs consécutives. Réglez le nombre d'interruptions sur 0 pour ne jamais s'arrêter automatiquement.
• Le délai d'attente dépend aussi du moteur : 60 secondes pour ChatGPT et DeepSeek, 30 secondes pour Claude et Gemini, et 10 secondes pour les autres.
• L'option Fusionner pour traduire est désactivée. Lorsqu'elle est activée, le plugin envoie les paragraphes par lots allant jusqu'à 1 800 caractères. Les lots offrent plus de contexte environnant à un LLM par requête, mais une mauvaise réponse affecte alors plusieurs paragraphes à la fois.
• Le glossaire est désactivé. Lorsqu'il est activé, il lit un fichier texte brut. Un terme et sa traduction s'écrivent sur deux lignes, un terme à laisser non traduit s'écrit sur une ligne, et les entrées sont séparées par des lignes vides.

Le plugin est gratuit, mais la traduction n'est pas toujours gratuite. Un roman de 300 pages envoyé à une API payante est facturé comme toute autre utilisation d'API. Nos guides sur ChatGPT, Claude et DeepSeek pour la traduction expliquent ce que chaque modèle a tendance à mal faire dans les textes longs.

Choisir une sortie cible uniquement ou bilingue

Le réglage Position de la traduction détermine la forme du livre :

Si vous voulez un livre que vous pouvez simplement lire, changez la position sur Sans original avant de commencer, car la valeur par défaut produit un livre bilingue.

Faites attention aux options gauche et droite. Dans la source, chaque paire est reconstruite sous forme de ligne de tableau avec trois cellules : original, un espace, et traduction. Avec l'espace par défaut de 10 %, les colonnes de texte font 45 % de largeur chacune. Sur un téléphone ou une liseuse de 6 pouces, cela devient deux bandes de texte étroites. Notre guide de l'EPUB bilingue compare les mises en page bilingues qui tiennent sur les petits écrans.

Ce que le plugin modifie dans votre EPUB

C'est la partie que les tutoriels génériques omettent. Le tableau résume ce que fait la v2.4.2 pour chaque type de contenu, d'après le code source (lib/element.py et lib/conversion.py au tag v2.4.2).

Deux de ces détails causent les dommages les plus visibles.

Pourquoi les italiques et les liens disparaissent. Pour chaque paragraphe, le plugin construit le texte à traduire à partir du texte brut du paragraphe. Seules les balises de sa liste protégée sont remplacées par des espaces réservés. Un <em> ou un <a> n'est ni protégé ni ignoré, donc ses mots sont traduits et son balisage est perdu. En mode bilingue, le paragraphe original conserve sa mise en forme, le problème n'apparaît donc que dans la ligne traduite. En mode cible uniquement, la mise en forme disparaît. Vous pouvez ajouter des sélecteurs sous Réserver l'élément, mais réserver un élément le garde non traduit. C'est utile pour les expressions étrangères ou les titres de livres que vous voulez conserver, et inadapté pour l'emphase que vous voulez traduire.

Pourquoi les notes de bas de page peuvent se casser. Les éditeurs marquent les références de notes de bas de page de différentes manières. Le plugin a un cas particulier pour un lien qui n'enveloppe qu'un exposant (<a href="#n1"><sup>1</sup></a>) et conserve ce lien intact. Une référence écrite comme <a href="#n1" class="noteref">1</a> n'a pas d'exposant, donc le numéro survit mais le lien peut ne pas survivre. Vérifiez les notes avant de faire confiance à une traduction en mode cible uniquement d'un ouvrage non romanesque. Pour les livres japonais et chinois, consultez comment traduire les annotations ruby EPUB avant de décider si la perte des furigana est acceptable.

L'élément traduit reçoit également un attribut lang pour la langue cible et un attribut dir, ce qui aide les liseuses à choisir les polices et la mise en page de droite à gauche. En mode bilingue, la traduction ne copie pas l'attribut id de l'élément original, donc les ancres existantes pointent toujours vers le paragraphe original.

Enfin, le manuel de conversion de Calibre décrit le fonctionnement de la conversion : l'entrée est transformée en XHTML, modifiée, puis écrite par un plugin de sortie. En cours de route, les transformations de Calibre peuvent régénérer les métadonnées et la table des matières. Le plugin traduit après ces transformations, juste avant que le plugin de sortie n'écrive le fichier. Votre EPUB traduit est donc un livre reconstruit, et non votre fichier original avec un nouveau texte. Le manuel de Calibre note que son système de conversion « n'est pas un substitut à un véritable éditeur de livres électroniques ».

Vérifiez l'EPUB traduit en cinq minutes

Ne jugez pas le résultat à partir du premier chapitre. Effectuez une comparaison structurelle entre le fichier original et le fichier traduit. Un EPUB est une archive ZIP, donc les outils de ligne de commande standard peuvent compter le balisage de chaque côté :

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

Comment interpréter le résultat :

• Une sortie en mode cible uniquement avec beaucoup moins de balises <em>, <i> ou <a que la source signifie que l'emphase ou les liens ont été aplatis. C'est attendu d'après le comportement ci-dessus. Décidez si le livre peut s'en passer.
• Moins de balises <img dans la sortie en mode cible uniquement signifie qu'un espace réservé d'image a été perdu. Dans une sortie bilingue, les images peuvent apparaître deux fois, donc fiez-vous plutôt à la recherche d'espaces réservés. Trouvez le chapitre et corrigez-le en mode avancé ou dans l'éditeur de Calibre.
• Tout texte {{id_…}} signifie qu'un moteur a modifié un espace réservé, donc l'élément protégé n'a pas été restauré.
• La sortie bilingue doit comporter au moins autant de balises que la source, car les paragraphes originaux sont conservés.

Le motif <em correspond aussi à <embed, ce qui est rare dans les livres mais bon à savoir si un décompte semble étrange.

Ensuite, exécutez EPUBCheck du W3C sur le fichier traduit. Ouvrez-le dans le lecteur que vous utiliserez réellement, et vérifiez la liste de contrôle QA pour la traduction EPUB : navigation, notes, images et dernier paragraphe de chaque chapitre. Si le livre est destiné à d'autres personnes, testez-le sur Kindle, Kobo et Apple Books.

Si la traduction s'arrête à mi-chemin

Le plugin met en cache les paragraphes traduits par défaut. Si le réseau tombe ou que le moteur commence à refuser les requêtes, relancez le même livre avec les mêmes paramètres. Les paragraphes déjà en cache ne sont pas retraduits. En pratique :

1. Ouvrez le journal des tâches sous Jobs et recherchez les erreurs répétées, qui indiquent généralement une limitation de débit ou une clé API expirée.
2. Augmentez Interval ou réduisez Concurrency limit pour ce moteur.
3. Relancez le livre. Le cache reprend là où il s'est arrêté.
4. Utilisez Cache Manager pour vider le cache d'un livre uniquement lorsque vous voulez une traduction fraîche, par exemple après avoir modifié votre glossaire. Changer de moteur ou de langue cible démarre déjà un cache séparé.

Quand Calibre est l'outil approprié, et quand il ne l'est pas

Utilisez le plugin Calibre lorsque :

• le livre est sans DRM et déjà dans votre bibliothèque Calibre ;
• vous voulez choisir et payer le moteur vous-même ;
• vous êtes prêt à revoir les paragraphes en mode avancé ; et
• le livre est principalement de la prose simple, donc perdre la mise en forme en ligne coûte peu.

Cherchez un autre flux de travail lorsque :

• le livre dépend de la mise en forme en ligne, des renvois ou des notes liées, comme beaucoup de manuels et d'ouvrages universitaires ;
• les noms et termes doivent rester cohérents sur des centaines de pages et vous ne voulez pas maintenir vous-même un fichier de glossaire ;
• vous préférez ne pas effectuer vous-même les vérifications et réparations du balisage ; ou
• vous n'êtes pas à l'aise avec les clés API, les limites de débit et les journaux de tâches.

Si cette deuxième liste décrit votre livre, une option consiste à téléverser l'EPUB sur BookTranslator et à voir le prix avant de payer. Les tâches terminées offrent à la fois un téléchargement cible uniquement et un téléchargement bilingue, et les noms et termes clés sont maintenus cohérents grâce à un glossaire intégré plutôt qu'à un fichier que vous écrivez. C'est un service payant. Quel que soit l'outil utilisé, effectuez la même vérification de balisage ci-dessus sur la sortie, et relisez toute traduction longue avant de vous y fier. La comparaison des outils de traduction EPUB met côte à côte le plugin Calibre, les outils de navigateur et les services de fichiers, si vous voulez comparer avant de choisir.