09 Oct 2016 by dryobates
Most of my projects documentation is written in reStructuredText with riv in vim. Same is for all those blog entries here. Until up recently my workflow was traditional: write, save, generate html, preview. Now it has changed...
reStructuredText  is de facto standard in Python's community for writing documentation. It's easily readable as plain text. You can use any text editor and be happy to see that generated document will be similar to what you see. Of course you have to use some imagination. E.g. text in **double stars** will render as bold text.
riv - reStructuredText in Vim
To make it easier to visualize and easier to edit some text editors have special syntax highlighting and shortcuts. I use vim with riv  extension.
Riv has a lot of shortcuts and built-in features that help editing RST. It has even some features that help managing todos or projects.
In case of visualizing results riv has shortcuts that are able to generate document and start it in browser to preview result.
Now the author of Riv made something even better...
InstantRST allows preview RST document in browser in real time. It has two parts: script written in vim and server written in python.
When you run :InstantRst from vim it will start browser and real time preview of your file.
To see what I mean go for project page  and see animated gif.
One short note: I wasn't able to install instantrst-py (the python part) from zip file as it was described on the project's page. On the other hand simple pip install instantrst-py did the thing.
|||riv - reStructuredText in Vim https://github.com/Rykka/riv.vim|