Sphinx - epub

[AA-Turner]

A stab at ePub support (xref #1994).

Previewing on a desktop app (adobe digital editions) everything looks fine apart from code blocks (e.g. page 66), so will have a look at overriding the CSS.

Test: make sphinx-epub and look at build/PEPs.epub. This is the one massive file for all PEPs approach, which is the default from the Sphinx ePub 3 writer -- if a per-PEP solution were wanted, I imagine this may be tricker.

(Note that this builds on the sphinx-theming branch -- the relevant commits are the last three (387b19b...37d9975), or changes in
build.py, contents-epub.rst, and Makefile)

cc: @froi, @Mariatta

[rybaktomasz]

Thanks for providing this patch. I tried it yesterday, and had some problems. All done on Debian unstable, recently updated, with following versions:

• python3-sphinx 4.2.0-4
• fbreader 0.12.10dfsg2-5
• calibre 5.29.0+dfsg-1
  ePub file was built without problems (with some warnings) but could not be used with fbreader. After some time of processing it displayed empty page; I was able to get Table of Contents, but clicking on any item resulted in empty page.
  Calibre was able to display content, but cover consisted of error message: "This page contains following errors: error on line 10 at column 109: EntityRef: expecting ';' Below is the rendering of the page up to the first error" and empty page.
  I could not find error; I'm not even sure if error is with PEP Makefile, Sphinx, or anything else. I can try to debug problem when helped.

[AA-Turner]

Closing this, there've been no updates in a while. Perhaps the best way of doing this if epub support were wanted is to generate one per PEP. Happy to review something if this is revived but likely won't advance this myself.