Riv: Take Notes in rst

Last Update:	2017-02-07
Version:	0.791

The Internet is just a world passing around notes in a classroom.

—Jon Stewart

What's New

0.791: Add a conceal syntax for *.rst filelink

Intro

Riv is a vim plugin for taking notes with reStructuredText.

riv.vim (vim) + InstantRst (web server) + rhythm.css (theme)

Comparion

First things first.

As there are some other note plugins in vim. like vimwiki, vim-notes, VOoM etc.

Also org-mode if you are Emacs fan.

Why using this plugin?

In comparition, the most advantage of Riv.vim is reStructuredText support.

reStructuredText is a markup language.

It's syntax are markdown alike, but more powerful and extensible, table, LaTex ect. are supported.

It's widely used in python community. And have many relevent plugins. Sphinx (www.readthedocs.org) Pygments, Nikola, etc.

There is a post of comparions between reStructuredText and markdown https://gist.github.com/dupuy/1855764

Features

Wiki

Write wiki with project and file link support. TODO syntax is added.

Editing

Faster typing, easier navigation, clear intending, auto formatting etc.

Reading

Improved syntax highlighting and folding support for reading document clearly.

Publish

Convert rst files to a number of different formats: pdf, html, xml, latex and odt etc. A new theme rhythm.css is added for better performance.

Plugins

Support many plugins like Sphinx syntax support. Other rst plugins:

• Vim & Python: InstantRst for preview rst document instantly.
• Vim & Python: Syntastic for syntax checking. Requires Docutils and Pygments.
• Python: Sphinx for Sphinx users.
• Python: Nikola or pelican for static blogging with rst syntax.
• Python: HoverCraft for writing presentation from rst.

Contribution to this list are welcome.

Installation

Using Vundle

Recommended Add this line to your .vimrc (after you have properly set up Vundle):

Bundle 'Rykka/riv.vim'

Downloaded zip/tar.gz file

Extract the contents of the archive to your .vim directory.

Config

You can add projects with g:riv_projects:

let proj1 = { 'path': '~/Dropbox/rst',}
let g:riv_projects = [proj1]

More options see the :RivInstruction

Make sure your .vim directory is before $VIMRUNTIME in runtimepath. By default it IS present before $VIMRUNTIME.

Also Make sure filetype plugin indent on and syntax on options are present in your .vimrc.

Related tools

Tutorials

You can have a quick start with :RivQuickStart.

Here is the Screencast:

• Riv: QuickStart (HD)

New To Vim

• If you are new to Vim, you can get a basic overview of Vim using vimtutor. To use it simply type vimtutor in your shell.
• To view the quick reference of Vim, use :h quickref.

New TO Rst

• To get a quick overview of reStructuredText, some of the available options are:

  Read "A ReStructuredText Primer". You can use :RivPrimer to open it in Vim. Or, you can read "Quick reStructuredText".

• For a detailed look at reStructuredText's specifications, take a look at "reStructuredText Specification". You can use :RivSpecification to open it in Vim.

• Finally, you can use "reStructuredText cheatsheet" for a quick review. Use :RivCheatSheet to open it in Vim.

New To Riv

• For getting started with Riv, read "QuickStart With Riv". You can also view it using :RivQuickStart in Vim.
• Detailed instructions for Riv are available at "Instructions". Use :RivInstruction to read the same in Vim.

Issues

The bug tracker for Riv is at https://github.com/Rykka/riv.vim/issues. You can use it to report bugs and open feature requests. Discussions related to Riv are welcome too.

You can follow my twitter @rykkaf and notice me there too.

Common Issues

• If you get errors with folding in documents, you can try to force reload using :RivReload or <C-E>t`.

  Or just :w as it will auto refolding after saving.

• Windows:

  • Converting to other formats may fail.

    This could happen due to Docutils not working correctly with vimrun.exe.

• Mac OS:

  • Lists don't act as expected.

    This could happen if the <C-Enter> key could not be mapped. Try some other mapping instead.