4 ms·
ReStructuredText with Sphinx is wonderful. The syntax isn't the most intuitive, however once you have overcome this small hurdle, it can boost your productivity
by ioloop 10y ago
ReStructuredText with Sphinx is wonderful. The syntax isn't the most intuitive, however once you have overcome this small hurdle, it can boost your productivity enormously.
In terms of deployment, using Sphinx enables you to easily deploy to readthedocs.io, or github pages.
Since it is a static site generate, it also enables you to use bootstrap, any javascript front-end library you wish to use, so nothing stops you from having web-application type behaviour and interactions in your posts. It also integrates nicely with extensions, such as mermaid, to make graphs inline with your posts. It can include code snippets from code, offers syntax highlighting and a lot more.