colorschemer : Vim colorschemer
| script karma |
Rating 21/8,
Downloaded by 2198 |
Comments, bugs, improvements
|
Vim wiki
|
| created by |
| richard emberson |
| |
| script type |
| utility |
| |
| description |
The ColorSchemer is a Forms library based utility.
The Forms library can be found at
http://www.vim.org/scripts/script.php?script_id=4150
or
https://github.com/megaannum/forms
The ColorSchemer consist of three parts:
Basic utilty and core data,
Cterm distilled color scheme data files and
Gui distilled color scheme data files.
The core subset of colorschemer does not require either the
cterm or gui data files. It consist of the Distill code
found in 'distill.vim' and the Viewer code found in 'viewer.vim'.
In addition, it has a collection of some 687 third-party color
scheme files.
The Distiller will take one or more color scheme files and
produce 'distilled' versions of those color schema.
The processing does the following:
* It eliminates those highlight group declarations that are redundant,
* It eliminates those group attributes that are redundant,
* Generates a standard comment header and initial VimL code:
set background= 'light' or 'dark'
hi clear
if exists("syntax_on")
syntax reset
endif
let g:colors_name = expand("<sfile>:t:r")
* Output highlight group definitions targeted for specific GVim and Vim
configurations:
if has("gui_running")
" highlights for GVim
elseif &t_Co == 256
" highlights for 256 color Xterm Vim
elseif &t_Co == 88
" highlights for 88 urvxt color Vim
elseif &t_Co == 16
" highlights for 16 color Xterm Vim
else " &t_Co == 8
" highlights for 8 color Xterm Vim
endif
* It eliminates redundant link definitions,
* The background color set depends primarily on the Normal background value and not what the color scheme file says (because, they sometimes lie).
* When appropriate generates both a 'dark' and 'light' version of the same base color scheme file.
One of the Distill functions takes all of the 687 third-party color
schema and distills them. It should be noted that slightly different
results are achieved when executing the Distill code in GVim versus
Vim (some color schemes only have definitions for GVim or Vim).
Also part of the core distribution that allows one to very easily
view different file-types applying different color schemes.
Far easier and quicker than other ways.
The viewer can be invoked through the mapping:
<Leader>cv
The Cterm distribution contains the set of distilled files generated
by the distill script by using Vim. A user can simply download this
set if they do not want to generate them themselves using distill.vim.
The Gui distribution contains the set of distilled files generated
by the distill script by using GVim. A user can simply download this
set if they do not want to generate them themselves using distill.vim.
The release version can also be found at:
https://github.com/megaannum/colorschemer
Examples images of the color schemer viewer can be found at:
https://github.com/megaannum/colorschemer/tree/master/images
|
| |
| install details |
To get the Basic utilty and core data:
Download the colorschemer_core.zip file
To get the Cterm distilled color scheme files
Download the colorschemer_cterm.zip file
To get the Gui distilled color scheme files
Download the colorschemer_gui.zip file
A zip snapshot of the {ColorSchemer} library can be downloaded
from www.vim.org (http://www.vim.org/scripts/script.php?script_id=4240)
In your Vim home, normally $HOME/.vim in Unix, unzip the file:
# cd $HOME/.vim
# unzip colorschemer_core.zip
# unzip colorschemer_cterm.zip -- optional
# unzip colorschemer_gui.zip -- optional
On a Windows system, vim home is normally $HOME/vimfiles.
TODO how to unpack on Windows?
{ColorSchemer} is also available via
[githup](http://github.com/megaannum/colorschemer).
One can download a release from github and extract content.
If as a developer, one wants fixes as they appear, one can clone the
github {ColorSchemer} repository and, as updates appear, copy the files
over to you Vim home location.
Vim has a number of third-party plugin managers. If you are using one
you can configure it to automatically download and install {ColorSchemer}.
After unpacking the ColorSchemer directory layout should look like:
$HOME/.vim/
autoload/
colorschemer/
distill.vim
" generate distilled color scheme files
util.vim
viewer.vim
" view test files with their syntax allowing for
" very quick toggling through color schemes
data/
" data that persists between invocations of a plugin
colorschemer/
" colorschemer data
colors/
" source Vim color scheme files (some 688 of them!)
distilled/
" target directory for files generated by distill.vim
distilled.cterm/
" generated using distill.vim in Vim
" optional part of the colorschemer_cterm.zip
distilled.gui/
" generated using distill.vim in GVim
" optional part of the colorschemer_gui.zip
test/
" test source files (c, pl, java, scala, tex, html)
" users can add addition ones
doc/
colorschemer.txt
plugin/
colorschemer.vim
Intalling with vim-addon-manager (VAM)
For more information about vim-addon-manager, see [vim-addon-manager](https://github.com/MarcWeber/vim-addon-manager) and [Vim-addon-manager getting started](https://github.com/MarcWeber/vim-addon-manager/blob/master/doc/vim-addon-manager-getting-started.txt)
In your .vimrc, add self as shown below:
fun SetupVAM()
...
let g:vim_addon_manager = {}
let g:vim_addon_manager.plugin_sources = {}
....
let g:vim_addon_manager.plugin_sources['self'] = {'type': 'git', 'url': 'git://github.com/megaannum/self'}
let g:vim_addon_manager.plugin_sources['forms'] = {'type': 'git', 'url': 'git://github.com/megaannum/forms'}
let g:vim_addon_manager.plugin_sources['colorschemer'] = {'type': 'git', 'url': 'git://github.com/megaannum/colorschemer'}
let plugins = [
\ 'self',
\ 'forms',
\ 'colorschemer'
\ ]
call vam#ActivateAddons(plugins,{'auto_install' : 0})
...
endf
call SetupVAM()
Now start Vim. You will be asked by vim-addon-manager
if you would like to download and install the self plugin (no dependencies).
Installing with pathogen:
I do not use pathogen. An example usage would be welcome.
|
| |
script versions (upload new version)
Click on the package to download.
ip used for rating: 18.97.9.172
|
