the-power-of-prolog icon indicating copy to clipboard operation
the-power-of-prolog copied to clipboard

creating valid epub structure

Open kiicia opened this issue 6 years ago • 4 comments

added bash script to create minimal valid epub structure, todo: table of contents/order of chapters, images, cross-reference links

instructions how to create ebook:

  • one need to zip all files in ebook directory (without directory), rename .zip to .epub and this is epub ebook
  • then use kindlegen or calibre to convert to mobi
  • pdf file can be created with calibre, too

kiicia avatar May 28 '18 19:05 kiicia

Excellent work! I've checked out and merged it with the current master locally for testing.

I'm able to generate a epub file using your instructions and read it in calibre. However, when I try to convert the epub file to other formats (mobi or pdf) I get errors related to epub validation. The same errors occur both when trying to convert using calibre and pandoc.

According to epubcheck it seems like the generated epub fails validation for the following reasons:

  • File 'META-INF/container.xml' could not be found.
  • Mimetype file entry is missing or is not the first file in the archive.

I'm not too familiar with the epub format so any guidance would be appreciated :smile: .

NJBS avatar Jan 06 '19 22:01 NJBS

@triska what you decided about this one by the way?

XVilka avatar May 14 '19 04:05 XVilka

First of all, thank you a lot for this contribution!

This will become very important once the book becomes more final. Currently, there is too much still missing, and I need to add a lot more material before I feel confident in providing a static version, or even making it easier to generate one.

As soon as a PDF is generated, copied, printed, distributed etc., readers will no longer automatically see the latest updates, so I would like to add as much as possible before distributing a PDF or e-book.

Please also see #3.

triska avatar May 14 '19 19:05 triska

Thanks a lot for this work! Hopefully this can be done eventually.

ghost avatar Feb 19 '20 09:02 ghost