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@xxxxxxxxxx> 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@xxxxxxxxxxxxxxxxxxxxxxx > 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-journalists Remember, if you're traveling to Bactria, Hump Day is Tuesday and Thursday. -- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
