Come tradurre un EPUB con Calibre: installazione del plugin, modalità di output e controlli sul file

Calibre non traduce i libri da solo. Per tradurre un EPUB in Calibre usi Ebook Translator, un plugin di terze parti di bookfere presente nell'indice dei plugin di Calibre. Installalo da Preferenze → Plugin → Ottieni nuovi plugin, scegli un motore di traduzione, decidi se vuoi solo la traduzione o affiancata all'originale, e avvialo su un EPUB senza DRM. Otterrai un nuovo EPUB nella tua libreria Calibre.

L'installazione è la parte veloce. Quello che la maggior parte delle guide omette è cosa fa il plugin al libro lungo il percorso. Abbiamo letto il codice sorgente della versione attuale (v2.4.2) per scoprirlo, e tre impostazioni predefinite contano più del motore che scegli:

1. L'output predefinito è bilingue. Ogni paragrafo tradotto viene inserito sotto l'originale, a meno che tu non modifichi l'impostazione della posizione.
2. La formattazione inline viene appiattita nel testo tradotto. Corsivi, grassetti e link all'interno di un paragrafo non vengono riportati nella traduzione. Solo un elenco fisso di tag, come immagini, interruzioni di riga e apici, viene protetto e reinserito.
3. Ogni esecuzione è una conversione di Calibre. Anche da EPUB a EPUB, il plugin affida il libro alla pipeline di conversione di Calibre, che ricostruisce il file di output.

Niente di tutto questo rende il plugin una scelta sbagliata. È gratuito, open source (GPL-3.0) e molto configurabile. Ma dovresti sapere cosa controllare prima di leggere il risultato, o di condividerlo.

Una nota sul metodo: questa guida si basa sul codice sorgente della v2.4.2 del plugin, sulla sua documentazione ufficiale e sul manuale di Calibre. Non abbiamo eseguito una traduzione cronometrata per questo articolo, quindi non facciamo affermazioni sulla velocità, sulla qualità della traduzione o su quale motore dia il risultato migliore.

Cosa ti serve prima di iniziare

Il plugin accetta anche altri formati che Calibre sa leggere, come MOBI o AZW3. Poiché il libro passa comunque attraverso la conversione di Calibre, partire da un EPUB pulito ti dà l'output più prevedibile.

Installa il plugin Ebook Translator

La documentazione del plugin indica due modi per installarlo:

1. Dall'interno di Calibre (consigliato): apri Preferenze → Plugin → Ottieni nuovi plugin, cerca Ebook Translator, clicca Installa, poi riavvia Calibre.
2. Da file: scarica lo ZIP dalla homepage del plugin, poi usa Preferenze → Plugin → Carica plugin da file e riavvia.

Se il plugin non compare sulla barra degli strumenti, aggiungilo in Preferenze → Barre degli strumenti e menu → La barra degli strumenti principale.

Calibre indica bookfere.com come autore del plugin. Il team di Calibre non lo mantiene. Segnala i problemi al repository GitHub del plugin, non a Calibre.

Modalità batch o modalità avanzata

Il plugin offre due modi per eseguire una traduzione:

• Modalità batch: seleziona uno o più libri, imposta la lingua di destinazione e il formato di output, quindi fai clic su Traduci. Il lavoro viene eseguito nella coda dei processi di Calibre. Usala per una prima bozza di un intero libro che prevedi di leggere una sola volta.
• Modalità avanzata: estrai i paragrafi di un libro in una tabella, traducili tutti o solo quelli selezionati, modifica manualmente qualsiasi traduzione, quindi fai clic su Output. Usala quando il libro è importante, ad esempio quando alcuni capitoli devono essere ritradotti o i nomi devono essere corretti, perché puoi correggere i paragrafi prima che l'EPUB venga scritto.

Se in ogni caso rivedrai la traduzione, la modalità avanzata ti permette di apportare correzioni nel plugin. Con la modalità batch, le faresti successivamente nell'editor di Calibre.

Scegli un motore di traduzione

Il motore Google gratuito è quello predefinito. La versione 2.4.2 offre questi motori (nomi come appaiono nel plugin):

Impostazioni predefinite che influiscono su un libro lungo:

• L'intervallo tra le richieste dipende dal motore. Nel codice sorgente v2.4.2 è di 20 secondi per ChatGPT (OpenAI e Azure), 12 secondi per Claude, 1 secondo per Gemini e DeepL (Free), e 0 per la maggior parte degli altri. La documentazione suggerisce di aumentarlo se il servizio inizia a rifiutare le richieste.
• Il numero di tentativi è 3, e l'esecuzione si interrompe dopo 10 errori consecutivi. Imposta il conteggio di interruzione a 0 per non fermarti mai automaticamente.
• Anche il timeout dipende dal motore: 60 secondi per ChatGPT e DeepSeek, 30 secondi per Claude e Gemini, e 10 secondi per gli altri.
• L'opzione Unisci per tradurre è disattivata. Quando è attiva, il plugin invia i paragrafi in batch fino a 1.800 caratteri. I batch offrono a un LLM più contesto circostante per richiesta, ma una risposta errata influisce poi su diversi paragrafi contemporaneamente.
• Il glossario è disattivato. Quando è attivo, legge un file di testo semplice. Un termine e la sua traduzione vanno su due righe, un termine da lasciare non tradotto va su una riga, e le voci sono separate da righe vuote.

Il plugin è gratuito, ma la traduzione non è sempre gratuita. Un romanzo di 300 pagine inviato a un'API a pagamento viene fatturato come qualsiasi altro utilizzo dell'API. Le nostre guide su ChatGPT, Claude e DeepSeek per la traduzione spiegano cosa ciascun modello tende a sbagliare nei testi lunghi.

Scegli un output solo nella lingua di destinazione o bilingue

L'impostazione Posizione della traduzione decide la forma del libro:

Se vuoi un libro che puoi semplicemente leggere, cambia la posizione in Senza originale prima di iniziare, perché l'impostazione predefinita produce un libro bilingue.

Fai attenzione alle opzioni sinistra e destra. Nel file di origine, ogni coppia viene ricostruita come una riga di tabella con tre celle: originale, uno spazio vuoto e traduzione. Con lo spazio predefinito del 10%, le colonne di testo sono larghe il 45% ciascuna. Su un telefono o un e-reader da 6 pollici, questo diventa due strisce strette di testo. La nostra guida all'EPUB bilingue confronta i layout bilingui che resistono sugli schermi piccoli.

Cosa modifica il plugin all'interno del tuo EPUB

Questa è la parte che i tutorial generici omettono. La tabella riassume cosa fa la v2.4.2 a ciascun tipo di contenuto, in base al codice sorgente (lib/element.py e lib/conversion.py al tag v2.4.2).

Due di questi dettagli causano i danni più visibili.

Perché corsivi e link scompaiono. Per ogni paragrafo, il plugin costruisce il testo da tradurre a partire dal testo semplice del paragrafo. Solo i tag presenti nella sua lista protetta vengono sostituiti con segnaposto. Un <em> o un <a> non è né protetto né ignorato, quindi le sue parole vengono tradotte e il suo markup va perso. In modalità bilingue il paragrafo originale mantiene la formattazione, quindi il problema si vede solo nella riga tradotta. In modalità solo destinazione la formattazione sparisce. Puoi aggiungere selettori sotto Reserve Element, ma riservare un elemento lo mantiene non tradotto. È utile per frasi straniere o titoli di libri che vuoi conservare, ed è sbagliato per le enfasi che vuoi tradurre.

Perché le note a piè di pagina possono rompersi. Gli editori contrassegnano i riferimenti alle note in modi diversi. Il plugin ha un caso speciale per un link che avvolge solo un apice (<a href="#n1"><sup>1</sup></a>) e mantiene quel link intatto. Un riferimento scritto come <a href="#n1" class="noteref">1</a> non ha un apice, quindi il numero sopravvive ma il link potrebbe no. Controlla le note prima di fidarti di una traduzione solo destinazione di saggistica. Per i libri giapponesi e cinesi, consulta come tradurre le annotazioni ruby degli EPUB prima di decidere se perdere i furigana è accettabile.

L'elemento tradotto riceve anche un attributo lang per la lingua di destinazione e un attributo dir, il che aiuta gli e-reader a scegliere i font e il layout da destra a sinistra. In modalità bilingue, la traduzione non copia l'id dell'elemento originale, quindi i collegamenti esistenti puntano ancora al paragrafo originale.

Infine, il manuale di conversione di Calibre descrive come funziona la conversione: l'input viene trasformato in XHTML, modificato e poi scritto da un plugin di output. Lungo il percorso, le trasformazioni di Calibre possono rigenerare i metadati e l'indice. Il plugin traduce dopo queste trasformazioni, appena prima che il plugin di output scriva il file. Il tuo EPUB tradotto è quindi un libro ricostruito, non il tuo file originale con del testo nuovo. Il manuale di Calibre osserva che il suo sistema di conversione "non è un sostituto di un editor di e-book completo".

Controlla l'EPUB tradotto in cinque minuti

Non giudicare il risultato dal primo capitolo. Esegui un confronto strutturale tra il file originale e quello tradotto. Un EPUB è un archivio ZIP, quindi i normali strumenti da riga di comando possono contare il markup su ciascun lato:

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

Come leggere il risultato:

• Output solo destinazione con molti meno tag <em>, <i> o <a rispetto alla fonte significa enfasi o link appiattiti. È quanto ci si aspetta dal comportamento descritto sopra. Decidi se il libro può vivere senza di essi.
• Meno tag <img nell'output solo destinazione significa che un segnaposto immagine è andato perso. Nell'output bilingue, le immagini possono apparire due volte, quindi affidati invece alla ricerca dei segnaposto. Trova il capitolo e correggilo in Modalità Avanzata o nell'editor di Calibre.
• Qualsiasi testo {{id_…}} significa che un motore ha modificato un segnaposto, quindi l'elemento protetto non è stato ripristinato.
• L'output bilingue dovrebbe avere almeno tanti tag quanti la fonte, perché i paragrafi originali vengono mantenuti.

Il pattern <em corrisponde anche a <embed, cosa rara nei libri ma utile da sapere se un conteggio sembra strano.

Poi esegui EPUBCheck del W3C sul file tradotto. Aprilo nel lettore che userai effettivamente e controlla la checklist di QA per la traduzione EPUB: navigazione, note, immagini e l'ultimo paragrafo di ogni capitolo. Se il libro è destinato ad altre persone, provalo su Kindle, Kobo e Apple Books.

Se la traduzione si interrompe a metà

Il plugin memorizza nella cache i paragrafi tradotti per impostazione predefinita. Se la rete cade o il motore inizia a rifiutare le richieste, esegui di nuovo lo stesso libro con le stesse impostazioni. I paragrafi già in cache non vengono ritradotti. In pratica:

1. Apri il log del job in Jobs e cerca errori ripetuti, che di solito indicano throttling o una chiave API scaduta.
2. Aumenta Interval o riduci Concurrency limit per quel motore.
3. Riesegui il libro. La cache riprende da dove si era fermata.
4. Usa Cache Manager per cancellare la cache di un libro solo quando vuoi una traduzione fresca, ad esempio dopo aver modificato il glossario. Cambiare motore o lingua di destinazione avvia già una cache separata.

Quando Calibre è lo strumento giusto e quando non lo è

Usa il plugin Calibre quando:

• il libro è senza DRM e già nella tua libreria Calibre;
• vuoi scegliere e pagare tu stesso il motore;
• sei disposto a rivedere i paragrafi in Modalità Avanzata; e
• il libro è per lo più prosa semplice, quindi perdere la formattazione inline costa poco.

Cerca un altro flusso di lavoro quando:

• il libro dipende da formattazione inline, riferimenti incrociati o note collegate, come molti libri di testo e testi accademici;
• nomi e termini devono rimanere coerenti su centinaia di pagine e non vuoi mantenere tu stesso un file di glossario;
• preferisci non eseguire tu stesso controlli e riparazioni del markup; o
• non ti senti a tuo agio con chiavi API, limiti di velocità e log dei job.

Se la seconda lista descrive il tuo libro, un'opzione è caricare l'EPUB su BookTranslator e vedere il prezzo prima di pagare. Le attività completate offrono sia un download solo nella lingua di destinazione sia uno bilingue, e nomi e termini chiave vengono mantenuti coerenti con un glossario integrato invece che con un file che scrivi tu. È un servizio a pagamento. Qualunque strumento tu usi, esegui lo stesso controllo del markup sopra sull'output e rivedi qualsiasi traduzione lunga prima di affidarti ad essa. Il confronto degli strumenti di traduzione EPUB mette a confronto il plugin Calibre, gli strumenti del browser e i servizi per file, se vuoi confrontare prima di scegliere.