Ripara il mio EPUB

Come riparare un EPUB danneggiato

Cosa esamina il controllo diagnostico

Un EPUB è un archivio ZIP con regole severe sul proprio impianto interno, e quasi ogni caso di «non si apre» è un guasto dell'impianto più che un testo danneggiato. La diagnosi ispeziona quell'impianto strato per strato. Parte dall'archivio stesso, poi da META-INF/container.xml — l'etichetta di spedizione che indica al lettore dove si trova il documento di pacchetto. Verifica la voce mimetype: deve essere il primo record dell'archivio, memorizzato senza compressione, con esattamente la stringa di contenuto giusta. Molti strumenti di ricompressione sbagliano questo passaggio, e diversi lettori rifiutano il libro per questo motivo.

Più in profondità, il controllo confronta il manifest con i file effettivamente presenti nell'archivio: ogni documento e ogni immagine referenziata devono esistere, ogni voce dello spine deve puntare a un elemento dichiarato nel manifest, e i documenti di navigazione (la nav di EPUB 3 e la NCX di EPUB 2) devono essere presenti e risolvibili. Infine esamina le due cose che i lettori mostrano nella tua libreria: la dichiarazione dell'immagine di copertina e i metadati di titolo e autore. Ogni esito viene segnalato come a posto, riparabile automaticamente, o come una mancanza che solo tu puoi colmare.

Perché i file EPUB si rompono

La maggior parte dei libri rotti nasce già rotta per colpa dello strumento che li ha prodotti. Esportatori con scrittori ZIP difettosi mettono la voce mimetype nella posizione sbagliata o la comprimono; scraper e convertitori fatti in casa referenziano file che non hanno mai incorporato; alcune app di scrittura generano un manifest che punta a percorsi con maiuscole e minuscole errate su lettori che le distinguono.

Gli altri si rompono in transito o in archiviazione: un download interrotto a metà, un conflitto di sincronizzazione cloud che ha fuso due copie di un archivio, un tool zip che «gentilmente» ha riconfezionato il libro con una compressione diversa, o un rinominamento manuale che ha confuso il container. Niente di tutto questo tocca il testo vero e proprio — ed è per questo che una riparazione strutturale, fatta bene, restituisce il libro senza ricodificare nemmeno un capitolo.

Il ciclo diagnosi → riparazione → ricontrollo

Una riparazione che non si può verificare è solo una congettura. I tool desktop ti consegnano un file sistemato e si affidano alla tua prova; i convertitori basati su upload mostrano una pagina di successo anche quando il libro continua a non superare la validazione. Questo strumento chiude il cerchio: dopo aver applicato le correzioni strutturali, lo stesso identico controllo diagnostico viene eseguito di nuovo sul risultato, dentro il tuo browser, prima che compaia il download. Se manca ancora qualcosa — per esempio hai saltato la copertina facoltativa — il rapporto lo dice chiaramente invece di cantare vittoria.

Il ricontrollo è anche ciò che tiene lo strumento onesto sui propri limiti. Quando un libro presenta un danno che nessuna riparazione lato browser può affrontare, la diagnosi lo dichiara irriparabile subito, prima che tu ci spenda un minuto, invece di fallire alla fine di una falsa barra di avanzamento.

Cosa si può e non si può riparare — onestamente

Riparabile automaticamente: un container.xml mancante o malformato, una voce mimetype nella posizione sbagliata o compressa, elementi del manifest che puntano a file inesistenti, voci dello spine che fanno riferimento a elementi non dichiarati, un documento nav di EPUB 3 o una NCX di EPUB 2 mancanti, e collegamenti vecchi rimasti da modifiche precedenti. Per ciascuno di questi esiste una riparazione deterministica che questo strumento applica e poi verifica.

Riparabile da te, con lo strumento che scrive: una copertina mancante (scegli una qualsiasi JPG, PNG, WebP o GIF) e metadati di titolo o autore mancanti (li digiti tu; lo strumento scrive veri elementi Dublin Core).

Non riparabile qui, e lo strumento lo dichiara: un archivio che non è affatto uno ZIP valido, un libro senza capitoli leggibili all'interno, e file bloccati dal DRM. I libri protetti da DRM non possono essere elaborati — rimuoverlo non è possibile in un browser né legale nella maggior parte dei paesi, e nessuno strumento onesto sosterrà il contrario.

Perché la tua libreria mostra un nome di file o una copertina vuota

Le app di libreria leggono esattamente due cose quando dispongono lo scaffale: la dichiarazione della copertina nei metadati del pacchetto e gli elementi dc:title / dc:creator. Quando manca uno dei due, il lettore improvvisa — il nome del file al posto del titolo, una tessera grigia generica al posto della copertina — e la gente dà per scontato che il file del libro sia corrotto. Di solito è semplicemente stato pubblicato incompleto, oppure un convertitore precedente ha spogliato i metadati.

Ecco perché copertina e metadati fanno parte della diagnosi di questo strumento invece di essere una faccenda a parte: il controllo diagnostico indica la lacuna, tu fornisci il pezzo mancante, e il ricontrollo conferma che la libreria ora mostrerà il libro come si deve.

Perché riparare in locale è importante

Un EPUB a cui tieni è un oggetto personale. Può contenere le tue annotazioni, i riferimenti di posizione, gli indicatori di avanzamento della lettura, gli identificativi di acquisto e, nei metadati, qualunque cosa il proprietario o lo strumento precedente vi abbia scritto. I servizi di riparazione basati su upload portano l'intero file su un server che non puoi controllare, e le loro informative sulla privacy descrivono finestre di conservazione, non impossibilità.

Questa pagina non ha alcun canale di upload — nessun fallback compresso, nessuna coda, nessuna copia temporanea. Il file viene aperto con le stesse API del browser che userebbe un lettore, modificato in memoria e riconsegnato a te. Puoi tenere d'occhio la scheda di rete mentre lavora: le uniche richieste sono quelle della pagina stessa.

Ripara il mio EPUB rispetto agli strumenti monofunzione

Questo sito offre anche ogni riparazione singolarmente — Repair EPUB, Fix EPUB TOC, Metadata Editor, Change Cover — e restano disponibili. La differenza sta nell'intento. Quelle pagine presuppongono che tu sappia già cosa non va. Ripara il mio EPUB presuppone il contrario: hai un libro rotto e nessuna diagnosi. Ispeziona tutto, applica ogni correzione automatica in un solo passaggio, chiede le due correzioni che richiedono un intervento umano e si conclude con un file verificato e pronto per la libreria.

Sono supportati libri fino a 120 MB, con un avviso cortese oltre i 100 MB perché le riparazioni avvengono in memoria. L'output è un EPUB standard che si apre in Calibre, Thorium, Kobo, Kindle (via Send to Kindle) e in ogni lettore che accettava l'originale.

Domande frequenti

Strumenti correlati