Re: [Docutils-users] EPub?

[Guenter M. <mi...@us...>]

On 2017-04-26, Matěj Cepl wrote:
> How do people here generate EPub archives from their rST?

I don't know, actually.

> Which gets me back to my original thought: why isn’t some 
> rst2epub script part of docutils themselves?

This is a long standing TODO issue (see docs/dev/todo.txt).
However, noone volunteered to to the work ...


> From looking to pages like 
> https://www.thoughtco.com/create-epub-file-from-html-and-xml-3467282 ,
> https://www.ibm.com/developerworks/xml/tutorials/x-epubtut/index.html 
> , or http://www.idpf.org/epub/301/spec/epub-contentdocs.html it 
> doesn’t seem to be THAT complicated. Although, do we have support for
> generating XHTML?

Both html writers generate XML-compatible HTML.
There is also an XHTML1.1 writer in the sandbox.

The problem with epub is our CSS stylesheet that contains some code that is
not allowed in epub.

> Isn’t whole generating epub just stiching together HTML (which 
> we know how to generate, hopefully) with some metadata (which we 
> already have for generating ToC etc.)?

Yes. It just needs to be done...

Günter