The Internet is just a world passing around notes in a classroom.
-- Jon Stewart
- Last Update
2014-08-15
- Version
0.77
Lots of changes were made, so take care, and
DON'T PANIC!
A brand new html theme for riv, rhythm.css
Provides much better view experience.
Syntax Preview__
Article Preview__
__ http://rykka.github.io/rhythm.css/rst_syntax __ http://rykka.github.io/rhythm.css/article
Also, code syntax highlighting and themes are now truly supported, you can change the theme by setting
g:riv_html_code_hl_style
, default is 'molokai'.(This option may change to
g:riv_code_theme
in future.)You can add your theme's css dir at
g:riv_css_theme_dir
. then set the style to the filename.For view and edit in vim, you can use most morden themes like molokai. And the Galaxy.vim can be a good choice too.
Auto convert to html on
:w
:Use option
g:riv_auto_rst2html
, set it to 1 to active. default is 0.If you even don't want to refresh the browser, use InstantRst.
New syntax and method for local files, which is much simpler, and robust.
see #72 for details.
Just input
xxx.rst
orxxx/
, Then use:RivCreatLink
or<C-E>ck
, you will get the file link.When click on a reference which location is a file link, you will open it directly.
To disable this, set
g:riv_open_link_location
to 0. Then you will move to that location only. default is 1.- NOTE
When convert to html, the xxx.rst in the file location will be auto convert to xxx.html for navigation in browser.
- NOTE
The moinmoin style (
[[xxxx]]
) is deprecated, and will be removed in next few versions.The sphinx style (
:doc:`xxxx
`) will go on.Unicode Link names.
Reference links now supporting unicode names.
Also filename supports unicode names too, though that's not encouraged.
like:
名字_ .. 名字: name.rst
Better and faster indent behavior.
see #71 for details.
Fixed lots of misc bugs and made lots of small optimization
The error phase ptn.
Project's id working error.
Editing a file missing working directory.
Syntax highlighting error and optimize.
Improved doctest using doctest.vim
...
And
Please help improving this plugin, for better writing and reading.
Both bug reports and suggestions are welcome.
Many Thanks!
Riv is a vim plugin for taking notes with reStructuredText.
A screencast with Riv in vim and InstantRst
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
- 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 for static blogging with rst syntax.
- Python: HoverCraft for writing presentation from rst.
Contribution to this list are welcome.
Using Vundle
Recommended Add this line to your .vimrc (after you have properly set up Vundle):
Bundle 'Rykka/riv.vim'
Extract the contents of the archive to your .vim
directory.
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.
You can have a quick start with :RivQuickStart
.
Here is the Screencast:
- Riv: QuickStart (HD)
- If you are new to Vim, you can get a basic overview of Vim using
vimtutor
. To use it simply typevimtutor
in your shell. - To view the quick reference of Vim, use
:h quickref
.
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.
- 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.
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.
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.