Matěj Cepl
2017-04-26 22:12:10 UTC
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: ***@ceplovi.cz
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."
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-users mailing list
Docutils-***@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-users
Please use "Reply All" t
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: ***@ceplovi.cz
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."
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Docutils-users mailing list
Docutils-***@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-users
Please use "Reply All" t