Toner is a plugin for interactively and visually toning vim highlight colors.
The nicest way is to use the excellent Pathogen plugin, and just clone the Toner repository while standing in your <~/.vim/bundle/>.
To have the docs indexed, then run:
Load up some code with nice syntax highlighting. Set up default mappings with:
:TonerMap + -
Then adjust a current or newly made colorscheme interactively, using e.g.:
:Toner . h " affect color group under cursor, operate on hue :Toner l 1 fg bg " on light by 1, affect both fore- and background :Toner * s 10 bg " *all colors*, saturation by 10, only background :Toner! " reset Toner state to ". h fg 2"
To get an overview of the available highlight groups for Vim structures and various syntaxes, do:
in one window, and:
in another (also available in the menu (and thus via
Important about Float
Floating point numbers in Vim can bug out if your locale doesn't use "." as decimal mark. If you see this:
E806: using Float as a String
, either do this in your running vim instance:
(any locale using '.' as decimal mark should do), or set the locale in the terminal, e.g:
$ LC_CYPE=en_US.UTF-8 gvim
Using MacVim, it seems just launching with the
mvim script is enough.
(Note: this is said to have been fixed in Patch 7.2.318, but there still are problems in recent 7.3. Really must research and report..)
I suggest you read some or all of:
to get the gist of it all.
The HSL and hue rotation code is from huerotation.vim (Vim Script #2283) by Yukihiro Nakadaira. See http://www.vim.org/scripts/script.php?script_id=2283 (placed in the public domain). Many thanks for this!