elixir-lang/ex_doc

Getting an invalid epub format

Closed this issue · 0 comments

Downloading the latest documentation as an EPUB doesn't open in iBooks, getting the following error:
Screenshot 2024-01-23 at 19 18 33

To download the epub I opened Elixir's hexdocs, scrolled to the bottom and selected download ePub version.

Using this tool https://github.com/w3c/epubcheck it reports the following(I used this command epubcheck Elixir.epub:

Check finished with errors
Messages: 10 fatals / 421 errors / 0 warnings / 0 infos

EPUBCheck completed

Installed version 5.1.0 of epubcheck with brew.

Most fatal errors look like:

FATAL(RSC-016): Elixir.epub/OEBPS/nav.xhtml(133,26): Fatal Error while parsing file: The entity name must immediately follow the '&' in the entity reference.