3 ms·
Interesting! I picked it up because of Sphinx primarily. The ability to extend it to pretty easily and cleanly add things like project management blocks is awes
by tonyarkles 3y ago
Interesting! I picked it up because of Sphinx primarily. The ability to extend it to pretty easily and cleanly add things like project management blocks is awesome. The Emacs ReST mode generally works pretty good. The only thing that kind of tripped me up was the indentation rules around bullet points.
Just had a quick look at AsciiDoc and it does have some features that look really nice (e.g. the include:: blocks are quite reminiscent of how I structured my LaTeX MSc thesis). And it looks like it similarly has an extension API that would likely fit some of the project management stuff I put together. Neat!
- IshKebab 3y ago> The ability to extend it to pretty easily and cleanly add things like project management blocks is awesome. I agree but the issue is that the APIs to do the extension are really really badly documented. Also it's quite buggy. Things don't compose very well, e.g. if you want to have nested blocks. Asciidoc is extensible in the same way, but it actually works properly.