@daniel_bohrer Same with Asciidoctor.
@frumble okay, I've never used that ^^
@daniel_bohrer There are worse things than using Haskell 😺
@daniel_bohrer I just had to do documentation in corporate design. After fighting with Word for hours, I switched to pandoc+Markdown+LaTeX. So far no regret. 🙂
(and that's on Windows 10!!!)
I guess it's a good decision to elaborate first which kind of featureset you will need for your document and then pick a format. Knowing that it can be converted by pandoc later on ...
@blub @tuxicoman sadly pandoc cannot concert asciidoc yet, and its reStructuredText reader is really lacking some key features compared to python-docutils. So with pandoc, I think the only reasonable choice is really pandoc's dialect of Markdown (maybe interspersed with LaTeX snippets). You can enhance the output (e.g. to specify sizes for images) by inventing additional syntax inside Markdown and making a pandoc filter to parse it.
@wasamasa yes, I know. But last I remembered, pandoc couldn't parse roles in rST documents and ignored them altogether, so they didn't even show up in the abstract syntax tree, and filters couldn't use this info. But this was a while ago, maybe that has changed.
@wasamasa oh wait, different thread context :D
Yes, I usually also use Lua only for short filters, and do everything more complex with panflute in Python, which I feel more at home with :)
@daniel_bohrer This is brilliant!
chaos.social – a Fediverse instance for & by the Chaos community