Rainbow Parentheses Improved
Vim script
Latest commit 7871d3e Nov 28, 2014 @oblitum fiat tenebris
Permalink
Failed to load latest commit information.
plugin Support chevrons in other languages May 5, 2014
README.md fiat tenebris Dec 3, 2014

README.md

#NOTICE Please try luochen's repository. I don't like rainbow highlighting anymore and he's using GitHub now. This repository is frozen for historical reasons now (specific c++ support, fixes to be backported, etc).

#Rainbow Parentheses Improved

This is a fork of Rainbow Parentheses Improved by luo chen.

I've applied some minor corrections and modifications:

  • Operators outside any braces get the last color of the rainbow. Previously, it was being ignored for highlighting.
  • Simplified/corrected logic to define highlighting precedence for braces as higher than for operators. So if you got a brace that's also an operator and you got to the situation that it can match both roles, it'll assume the brace role.
  • Changed default highlighted operators (now most punctuation) and highlighted braces (added < and > for C++, Rust, C# and Java).
  • Removed optional highlighting for operators. Now hard enabled.
  • Changed loading autocommand for the events "syntax" and "colorscheme" so that the rainbow gets loaded only when there's syntax being applied and aways after switching colorschemes.
  • Changed default colors. Default rainbow colors copied from gruvbox colorscheme (good for dark and light backgrounds).

Chevrons are a hard case to deal with. To distinguish "less than" from "bracket for open generics argument list" it's assumed that "less than" will always be surrounded by spaces. If not, it'll be treated as an open template's angle bracket (although, still some checking applies for the template or operator keyword, for C++ for example).

###Simple Configuration

Put this on your .vimrc for loading it for specific file types:

au FileType c,cpp,objc,objcpp call rainbow#load()

or just this to enable it globally:

let g:rainbow_active = 1

###Advanced Configuration An advanced configuration allows you to define what parentheses to use for each type of file. You can also determine the colors of your parentheses by this way (read file vim73/rgb.txt for all named colors).

e.g. this is an advanced config (add these sentences to your .vimrc):

let g:rainbow_active = 1

let g:rainbow_load_separately = [
    \ [ '*' , [['(', ')'], ['\[', '\]'], ['{', '}']] ],
    \ [ '*.tex' , [['(', ')'], ['\[', '\]']] ],
    \ [ '*.cpp' , [['(', ')'], ['\[', '\]'], ['{', '}']] ],
    \ [ '*.{html,htm}' , [['(', ')'], ['\[', '\]'], ['{', '}'], ['<\a[^>]*>', '</[^>]*>']] ],
    \ ]

let g:rainbow_guifgs = ['RoyalBlue3', 'DarkOrange3', 'DarkOrchid3', 'FireBrick']
let g:rainbow_ctermfgs = ['lightblue', 'lightgreen', 'yellow', 'red', 'magenta']

###User Command

:RainbowToggle  --you can use it to toggle this plugin.
:RainbowLoad    --you can use it to load/reload this plugin.

I recommend VAM or Vundle for plugin management.

Here's a sample of a dark gruvbox vim session:

Dark VIM Session

and here's a slightly lighter dark solarized session:

Lighter VIM Session

I thank Luo for being supportive and accepting the operator highlighting idea.