3 ms·
I like Latex (Math/CS background), but I would definitely like to try some alternatives (like Asciidoc discussed in https://news.ycombinator.com/item?id=8509062
by jmount 12y ago
I like Latex (Math/CS background), but I would definitely like to try some alternatives (like Asciidoc discussed in https://news.ycombinator.com/item?id=8509062 https://news.ycombinator.com/item?id=8509062 ). The problem is I never can tell which Markdown/Docbook inspired systems actually have working implementations and which ones are hot air. I don't want to end up with a big SGML mess that I can't do anything with or have to edit CSS just to render a book in a standard format.
Any recommendations/tutorials?
My ideal system would allow something like literate-programming/sweave/knitr. The notation could be any of markdownish/xml/ascii. I would have to be able to do call-outs/annotations on listings with tags (not insane/fragile region specifications). I need figures and charts. And I would have to be able to produce at least HTML5, PDF, epub, mobi. And I need support for footnotes, endnotes, tables of contents, indexes, and bibliographies. Flexibility in back-ends (like being able to render to Latex) would also be good.
Edit: the sweave/knitr thing I can live without (could probably arranged a pre-process to do this).
- masklinn 12y agoSphinx has most of these, though not all (it doesn't have the literate programming part, it could probably be done though; and the standard builders are html4). And I'll acknowledge that ReST is hard to love.
- amouat 12y agoasciidoc is quite nice. It can output DocBook which I think is pretty well supported. I'm currently writing a book in asciidoc which produces output in all your mentioned formats and includes footnotes, endnotes, call-outs, code listings, index etc. However, whilst I write almost exclusively in asciidoc, a lot of the styling etc is done by the publisher's docbook workflow.
- ultimape 12y agoI've had good luck using tools like Pandoc as part of a workflow to translate between various messes.