Il messaggio di errore che ti mostra uno store di solito è vago. A volte non dice altro che «c'è un problema con il tuo file».
La prima cosa da fare è quindi passarlo attraverso un validatore chiamato EPUBCheck. È lo strumento ufficiale distribuito dal W3C ed è gratuito. Esistono anche servizi che lo eseguono online.
Lo strumento ti dice esattamente quale file, quale riga e che cosa non va. Questo ti porta alla causa molto più in fretta del messaggio di errore di uno store.
Se EPUBCheck è pulito e lo store rifiuta comunque il file, probabilmente non è una questione di specifica EPUB ma di un requisito specifico di quello store. Vedi la sezione più sotto.
Se fai EPUB per conto tuo, gli errori in cui incappi sono abbastanza prevedibili.
Dentro un EPUB c'è un filetto chiamato mimetype , e la regola vuole che sia archiviato per primo nello ZIP e non compresso.
Comprimere una cartella con un normale strumento di compressione non soddisfa quella condizione. È il problema più frequente quando un EPUB è stato montato a mano.
Ogni file di un EPUB deve essere registrato nel <manifest> di content.opf .
Hai aggiunto un'immagine e dimenticato di registrarla, oppure un file registrato non esiste più: l'una o l'altra incongruenza produce un errore.
EPUB 3 richiede quanto segue.
•dc:title (il titolo)
•dc:language (lingua; it per l'italiano)
•dc:identifier (identificatore)
•dcterms:modified (ultima modifica)
Un collegamento dell'indice (nav.xhtml) punta a un file che non c'è. Capita quando cancelli un capitolo e dimentichi di aggiornare l'indice.
Il corpo di un EPUB è scritto in XHTML, che è più severo dell'HTML normale. Un tag non chiuso, o scrivere <br> (dev'essere <br />), produce un errore.
Questo capita di solito quando i tag HTML sono stati digitati direttamente nel manoscritto.
Se EPUBCheck segnala zero errori e lo store rifiuta comunque il file, è un requisito dello store più che della specifica.
I requisiti di caricamento di ogni store vengono aggiornati di tanto in tanto. Conferma sempre quelli attuali nelle pagine di aiuto di quello store.
I riassunti di terzi, questo articolo compreso, possono essere superati. Cercare nell'aiuto dello store il testo esatto del messaggio di errore è la via più affidabile.
Amazon converte nel proprio formato l'EPUB che riceve. In quel passaggio di conversione possono emergere problemi, quindi controllare in Kindle Previewer prima di caricare restringe la causa più in fretta.
Se Previewer lo apre ma il caricamento viene rifiutato, è più probabile che il problema stia nei tuoi dati di registrazione o nella revisione che nel file stesso.
EPUBCheck scrive in inglese, ma una volta conosciuta la forma non è difficile.
| Etichetta | Significato |
|---|---|
| FATAL | Fatale. Il file non sta in piedi per niente |
| ERROR | Viola la specifica. Va corretto |
| WARNING | Avviso. Funziona, ma non è consigliato |
| INFO | Informazione. Di solito non richiede nulla |
Guarda prima FATAL ed ERROR. I WARNING di solito si possono pubblicare così come sono.
Quaranta errori di fila sembrano disperanti, ma di solito vengono tutti da un'unica causa.
Una riga sbagliata nel manifest, per esempio, fa fallire ogni file da lì referenziato.Correggi solo il primo dall'alto e rivalida — il conteggio spesso crolla di colpo.
Se hai modificato a mano un EPUB generato da uno strumento e l'hai rotto, ricostruire dal manoscritto originale di solito è più veloce. Correggere il manoscritto e riconvertire è più affidabile che schiacciare gli errori uno a uno.
EPUB FACTORY fa passare ogni file che genera attraverso una validazione conforme allo standard e ti mostra il risultato. Senza account, senza installare nulla.
Prova EPUB FACTORYLa nostra diagnosi EPUB segnala i punti che sulla carta sono validi ma si rompono per chi legge davvero, nella tua lingua. Funziona interamente nel browser, quindi il tuo file non viene inviato da nessuna parte. Gratis, senza registrazione.