I've played around with quite a few "text-based markup" documentation
toolchains in the past year or so. For Pythonistas, I think Sphinx /
reStructuredText is one of the more popular ones. There's also
GitBook, which is built on Node.js. For R, there's RMarkdown, which is
what I use most of the time as a front end to GitBook or Nikola.
For "vanilla" Markdown, AsciiDoc, reStructured Text, etc., Pandoc does
a pretty good job of rendering to HTML, PDF and EPUB. Calibre can make
MOBI ebooks if you're targeting Kindles.
Personally I'd recommend Sphinx and Pandoc because the whole toolchain
is in the Fedora repositories. GitBook is a bit rough around the
edges, but I'm using it installed via 'npm' and have it mostly under
control.
On Wed, Feb 11, 2015 at 5:13 PM, Jeff Fearn <jfearn(a)redhat.com> wrote:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On 02/12/2015 10:55 AM, Pete Travis wrote:
> It's not about getting rid of publican, or docbook.
Sure, but I hate XML so I mention exit strategies whenever I can :D
Cheers, Jeff.
- --
Jeff Fearn
Senior Software Engineer
Hosted & Shared Services
Red Hat Pty Ltd
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1
iQEcBAEBAgAGBQJU2/5XAAoJELs3R4zxGZvKUkcH/274/fc5aDCGQ53MI7ICeqq0
8/Khq99hKfyW3TrR/vUIkw/H4pfMefcjWY2rXjKYBwAj3KFzHZMGY/cNGOwj5fi5
wwflOE4IEK55pqNraNyZJntghhGOmSY7+9L0N+XsI3uUOt07u0A+eG7fvtuSdU0b
irptLqFfXBlh7KM8Eg5vYo/qlOawKPQ7FbCTiirZKKsWpWTofteRC1xmKU7M0HVt
6zqwTACqbYH3hrZIChcx8gwT8CoGunAydVqjeTq7rLhuS0+htw3eB+SaEYbSPdpq
mQosUrVgH4AbC9PTNZIhUc6Dmps0SoRCyBXWKDzUf2UitkUgjtiD05LS2mJAyto=
=mO5B
-----END PGP SIGNATURE-----
--
docs mailing list
docs(a)lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs
--
OSJourno: Robust Power Tools for Digital Journalists
http://www.znmeb.mobi/stories/osjourno-robust-power-tools-for-digital-jou...
Remember, if you're traveling to Bactria, Hump Day is Tuesday and Thursday.