Converti OPF in EPUB

Un flusso di pubblicazione, un archivio o un'applicazione di lettura può fornire un pacchetto OPF mentre il lettore di destinazione o il servizio di distribuzione richiede un singolo file .epub. La conversione inserisce OPF, XHTML, stylesheet, immagini, font e risorse di navigazione nel contenitore EPUB.

Cos'è il formato OPF

OPF, normalmente identificato dall'estensione .opf, è un documento di pacchetto XML utilizzato dai sistemi di produzione EPUB. Definisce i metadati, il manifest delle risorse e l'ordine di lettura tramite elementi quali <metadata>, <manifest> e <spine>.

Un file OPF di solito non è un ebook completo. Fa riferimento a capitoli XHTML o HTML, CSS, immagini, font, file di copertina e documenti di navigazione tramite percorsi relativi. Tali file devono rimanere nelle posizioni dichiarate dal manifest. I file OPF sono utilizzati da editori, applicazioni di authoring per ebook, progetti Calibre, biblioteche digitali e pacchetti EPUB estratti; normalmente non vengono aperti direttamente nei software di lettura.

Cos'è il formato EPUB

EPUB è un contenitore per ebook basato su ZIP che include il documento OPF e le risorse a cui fa riferimento. Un EPUB deve includere un file mimetype a livello radice contenente application/epub+zip, un file META-INF/container.xml che identifica il documento di pacchetto e i file di contenuto indicati dal pacchetto.

EPUB 2 utilizza comunemente un pacchetto OPF e un indice dei contenuti NCX. EPUB 3 utilizza il pacchetto OPF con un documento di navigazione XHTML e può supportare funzionalità quali HTML semantico, MathML, sovrapposizioni multimediali, audio, video, scripting e layout fissi, in base al supporto del lettore.

Il layout adattivo di EPUB adatta il testo a diverse dimensioni dello schermo, mentre un singolo file può contenere metadati, navigazione, stylesheet, immagini e font. Apple Books, Kobo, Thorium Reader, Adobe Digital Editions, molte app di lettura Android e i servizi di distribuzione di ebook supportano EPUB, sebbene il supporto per le singole funzionalità differisca.

Convertire un progetto OPF completo con Calibre

1. Collocare il file OPF e ogni file XHTML o HTML, stylesheet, immagine, font, copertina e documento di navigazione a cui fa riferimento nella struttura di directory specificata dal manifest. Conservare i percorsi relativi e le maiuscole dei nomi file.
2. Installare la versione desktop attuale di Calibre da calibre-ebook.com.
3. Eseguire il convertitore da riga di comando dalla directory del progetto:
   ebook-convert book.opf book.epub
4. In alternativa, provare il flusso di lavoro grafico: usare Calibre → Add books, selezionare la sorgente, scegliere Convert books, selezionare EPUB come formato di output e avviare la conversione. Se l'importatore grafico non accetta l'OPF, usare ebook-convert.
5. Aprire l'output nell'applicazione di lettura prevista e controllare l'ordine dei capitoli, l'indice dei contenuti, le immagini, i collegamenti, i font, la copertina e i metadati.

Calibre può risolvere il manifest OPF, ricostruire il contenitore EPUB, normalizzare i metadati e riscrivere HTML o CSS incompatibili. Potrebbe modificare il markup e lo stile originali, quindi conservare il progetto originale quando sono importanti la resa esatta o la conservazione della sorgente. Adobe Digital Editions è un lettore, non un convertitore generico da OPF a EPUB.

Ricostruire un EPUB estratto

Se l'OPF proviene da un EPUB estratto e tutti i file del pacchetto sono ancora presenti, la conversione tramite Calibre non è necessaria. Ricreare lo ZIP EPUB con la struttura di directory originale. La radice del pacchetto deve contenere mimetype, META-INF/container.xml, il documento di pacchetto indicato da container.xml e tutte le risorse del manifest.

Dalla radice del pacchetto, creare l'archivio con la voce mimetype per prima e non compressa:

zip -X0 ../book.epub mimetype
zip -rX9 ../book.epub META-INF OEBPS

Sostituire OEBPS con la directory del contenuto effettiva e includere ogni directory a cui fanno riferimento container.xml e il manifest OPF. Il file mimetype deve contenere esattamente application/epub+zip, senza spazi bianchi aggiuntivi, e deve essere la prima voce ZIP. Utilizzare uno strumento di pacchettizzazione compatibile con EPUB se l'utilità di archiviazione del sistema operativo non è in grado di preservare questi requisiti.

Convalidare l'EPUB

Eseguire l'utilità ufficiale EPUBCheck sul risultato:

epubcheck book.epub

EPUBCheck rileva metadati del pacchetto malformati, riferimenti non validi nel manifest o nello spine, navigazione non valida, dichiarazioni MIME errate ed errori nella struttura del contenitore. Non può ripristinare file mancanti né correggere HTML, CSS, tipografia o layout visivo di scarsa qualità.

Convertitori online e limiti di compatibilità

La maggior parte dei convertitori online di ebook accetta un singolo documento, non un progetto OPF con la relativa struttura di directory. Caricare solo il file .opf può produrre un EPUB incompleto o omettere risorse senza rendere evidente il problema. Per manoscritti non pubblicati o contenuti concessi in licenza, l'elaborazione locale con Calibre evita di inviare la sorgente a terzi.

Servizi affidabili come CloudConvert e Zamzar possono essere presi in considerazione solo quando il loro elenco dei formati attuale accetta esplicitamente l'OPF fornito o un archivio completo del pacchetto e spiega come vengono risolte le risorse esterne. Sono più adatti a un ebook impacchettato o a una semplice conversione di un singolo file che a un progetto OPF composto da più file. Convalidare qualsiasi risultato online con EPUBCheck e testarlo nel lettore di destinazione.

• Un OPF non può fornire capitoli, immagini, CSS, font o file di navigazione mancanti nei riferimenti del manifest.
• I percorsi all'interno dei pacchetti EPUB sono di fatto sensibili alle maiuscole. Un riferimento a Images/Cover.jpg non risolve in modo affidabile images/cover.jpg.
• Calibre può modificare CSS, HTML, metadati, navigazione e gestione delle immagini durante la conversione; confrontare l'output con la sorgente.
• I font incorporati richiedono tipi MIME validi e licenze appropriate. Alcuni lettori li ignorano o ne limitano l'utilizzo.
• JavaScript, layout fissi, MathML, sovrapposizioni multimediali, audio, video e altre funzionalità EPUB 3 hanno un supporto disomogeneo. Eseguire i test sull'app, sul dispositivo o sul validatore di distribuzione effettivo.