3 ms·
As of late I’ve been using restructuredtext and rst2latex.py and have been quite happy with it. I’m quite used to LaTeX for writing equations and RST handles mo
by tonyarkles 3y ago
As of late I’ve been using restructuredtext and rst2latex.py and have been quite happy with it. I’m quite used to LaTeX for writing equations and RST handles most of the other boilerplate. If you do need to do fancy TeX things you can still just drop that inline and it generally works pretty good.
- IshKebab 3y agoRestructuredText is pretty awful in my experience. Barely documented and unreliable. Asciidoc is much much much better.
- tonyarkles 3y agoInteresting! 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.
- __mharrison__ 3y agoI wrote many physical books in rst. (see rst2nitrile). Last year I decided to join the 21st century and migrated my tool to be Pandoc and markdown based. I'm still writing code for my toolchain, but now I'm using tools that much more folks are using.