From: Matěj C. <mc...@ce...> - 2017-04-26 22:12:32
|
How do people here generate EPub archives from their rST? I see on http://docutils.sourceforge.net/docs/user/links.html#epub the following three options, but I am not happy with either: 1. pandoc — I just do not like HTML it produces, it does not support some rST constructs I want to use (..include) and it cannot work with some other tools for rST. 2. rst2epub from https://bitbucket.org/wierob/rst2epub — the last commit from 2013-05-12 and it shows. Seems to break on non-ASCII titles (I am Czech, so it is point of no way for me), and of course it does not seem to support ..include. 3. rst2epub2 from https://github.com/mattharrison/rst2epub2 — last commit 2016-05-06 and that was mine pull request ;). Again, it does not seem to work with non-ASCII titles, it requires some weird virtualenv, and I was not able to make it working at all. 4. sphinx — I would prefer plain docutils simple HTML (or HTML5), sphinx seems to do too much for me to like it (specific stylesheets etc.), also it requires fixed structure of source files (or it is too complicated to persuade it). Which gets me back to my original thought: why isn’t some rst2epub script part of docutils themselves? 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? 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.)? Best, Matěj -- https://matej.ceplovi.cz/blog/, Jabber: mc...@ce... GPG Finger: 3C76 A027 CA45 AD70 98B5 BC1D 7920 5802 880B C9D8 Of course I'm respectable. I'm old. Politicians, ugly buildings, and whores all get respectable if they last long enough. --John Huston in "Chinatown." |