Merge commit 'ec0a4cac2884324d8894714dfe319f3f9954500c' as 'vim/bundle/solarized'
Buddy Sandidge
11 years ago
commit
c91ae95b98
@ -0,0 +1,267 @@
|
|||||||
|
---
|
||||||
|
Title: Solarized Colorscheme for Vim
|
||||||
|
Description: Precision colors for machines and people
|
||||||
|
Author: Ethan Schoonover
|
||||||
|
Colors: light yellow
|
||||||
|
Created: 2011 Mar 15
|
||||||
|
Modified: 2011 Apr 16
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Solarized Colorscheme for Vim
|
||||||
|
=============================
|
||||||
|
|
||||||
|
Developed by Ethan Schoonover <es@ethanschoonover.com>
|
||||||
|
|
||||||
|
Visit the [Solarized homepage]
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
See the [Solarized homepage] for screenshots,
|
||||||
|
details and colorscheme versions for Vim, Mutt, popular terminal emulators and
|
||||||
|
other applications.
|
||||||
|
|
||||||
|
Screenshots
|
||||||
|
-----------
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Downloads
|
||||||
|
---------
|
||||||
|
|
||||||
|
If you have come across this colorscheme via the [Vim-only repository] on
|
||||||
|
github, or the [vim.org script] page see the link above to the Solarized
|
||||||
|
homepage or visit the main [Solarized repository].
|
||||||
|
|
||||||
|
The [Vim-only repository] is kept in sync with the main [Solarized repository]
|
||||||
|
and is for installation convenience only (with [Pathogen] or [Vundle], for
|
||||||
|
instance). Issues, bug reports, changelogs are centralized at the main
|
||||||
|
[Solarized repository].
|
||||||
|
|
||||||
|
[Solarized homepage]: http://ethanschoonover.com/solarized
|
||||||
|
[Solarized repository]: https://github.com/altercation/solarized
|
||||||
|
[Vim-only repository]: https://github.com/altercation/vim-colors-solarized
|
||||||
|
[vimorg-script]: http://vim.org/script
|
||||||
|
[Pathogen]: https://github.com/tpope/vim-pathogen
|
||||||
|
[Vundle]: https://github.com/gmarik/vundle
|
||||||
|
|
||||||
|
Installation
|
||||||
|
------------
|
||||||
|
|
||||||
|
### Option 1: Manual installation
|
||||||
|
|
||||||
|
1. Move `solarized.vim` to your `.vim/colors` directory. After downloading the
|
||||||
|
vim script or package:
|
||||||
|
|
||||||
|
$ cd vim-colors-solarized/colors
|
||||||
|
$ mv solarized.vim ~/.vim/colors/
|
||||||
|
|
||||||
|
### Option 2: Pathogen installation ***(recommended)***
|
||||||
|
|
||||||
|
1. Download and install Tim Pope's [Pathogen].
|
||||||
|
|
||||||
|
2. Next, move or clone the `vim-colors-solarized` directory so that it is
|
||||||
|
a subdirectory of the `.vim/bundle` directory.
|
||||||
|
|
||||||
|
a. **Clone:**
|
||||||
|
|
||||||
|
$ cd ~/.vim/bundle
|
||||||
|
$ git clone git://github.com/altercation/vim-colors-solarized.git
|
||||||
|
|
||||||
|
b. **Move:**
|
||||||
|
|
||||||
|
In the parent directory of vim-colors-solarized:
|
||||||
|
|
||||||
|
$ mv vim-colors-solarized ~/.vim/bundle/
|
||||||
|
|
||||||
|
### Modify .vimrc
|
||||||
|
|
||||||
|
After either Option 1 or Option 2 above, put the following two lines in your
|
||||||
|
.vimrc:
|
||||||
|
|
||||||
|
syntax enable
|
||||||
|
set background=dark
|
||||||
|
colorscheme solarized
|
||||||
|
|
||||||
|
or, for the light background mode of Solarized:
|
||||||
|
|
||||||
|
syntax enable
|
||||||
|
set background=light
|
||||||
|
colorscheme solarized
|
||||||
|
|
||||||
|
I like to have a different background in GUI and terminal modes, so I can use
|
||||||
|
the following if-then. However, I find vim's background autodetection to be
|
||||||
|
pretty good and, at least with MacVim, I can leave this background value
|
||||||
|
assignment out entirely and get the same results.
|
||||||
|
|
||||||
|
if has('gui_running')
|
||||||
|
set background=light
|
||||||
|
else
|
||||||
|
set background=dark
|
||||||
|
endif
|
||||||
|
|
||||||
|
See the [Solarized homepage] for screenshots which will help you
|
||||||
|
select either the light or dark background.
|
||||||
|
|
||||||
|
### IMPORTANT NOTE FOR TERMINAL USERS:
|
||||||
|
|
||||||
|
If you are going to use Solarized in Terminal mode (i.e. not in a GUI version
|
||||||
|
like gvim or macvim), **please please please** consider setting your terminal
|
||||||
|
emulator's colorscheme to used the Solarized palette. I've included palettes
|
||||||
|
for some popular terminal emulator as well as Xdefaults in the official
|
||||||
|
Solarized download available from [Solarized homepage]. If you use
|
||||||
|
Solarized *without* these colors, Solarized will need to be told to degrade its
|
||||||
|
colorscheme to a set compatible with the limited 256 terminal palette (whereas
|
||||||
|
by using the terminal's 16 ansi color values, you can set the correct, specific
|
||||||
|
values for the Solarized palette).
|
||||||
|
|
||||||
|
If you do use the custom terminal colors, solarized.vim should work out of the
|
||||||
|
box for you. If you are using a terminal emulator that supports 256 colors and
|
||||||
|
don't want to use the custom Solarized terminal colors, you will need to use
|
||||||
|
the degraded 256 colorscheme. To do so, simply add the following line *before*
|
||||||
|
the `colorschem solarized` line:
|
||||||
|
|
||||||
|
let g:solarized_termcolors=256
|
||||||
|
|
||||||
|
Again, I recommend just changing your terminal colors to Solarized values
|
||||||
|
either manually or via one of the many terminal schemes available for import.
|
||||||
|
|
||||||
|
Advanced Configuration
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
Solarized will work out of the box with just the two lines specified above but
|
||||||
|
does include several other options that can be set in your .vimrc file.
|
||||||
|
|
||||||
|
Set these in your vimrc file prior to calling the colorscheme.
|
||||||
|
"
|
||||||
|
option name default optional
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_termcolors= 16 | 256
|
||||||
|
g:solarized_termtrans = 0 | 1
|
||||||
|
g:solarized_degrade = 0 | 1
|
||||||
|
g:solarized_bold = 1 | 0
|
||||||
|
g:solarized_underline = 1 | 0
|
||||||
|
g:solarized_italic = 1 | 0
|
||||||
|
g:solarized_contrast = "normal"| "high" or "low"
|
||||||
|
g:solarized_visibility= "normal"| "high" or "low"
|
||||||
|
------------------------------------------------
|
||||||
|
|
||||||
|
### Option Details
|
||||||
|
|
||||||
|
* g:solarized_termcolors
|
||||||
|
|
||||||
|
This is set to *16* by default, meaning that Solarized will attempt to use
|
||||||
|
the standard 16 colors of your terminal emulator. You will need to set
|
||||||
|
those colors to the correct Solarized values either manually or by
|
||||||
|
importing one of the many colorscheme available for popular terminal
|
||||||
|
emulators and Xdefaults.
|
||||||
|
|
||||||
|
* g:solarized_termtrans
|
||||||
|
|
||||||
|
If you use a terminal emulator with a transparent background and Solarized
|
||||||
|
isn't displaying the background color transparently, set this to 1 and
|
||||||
|
Solarized will use the default (transparent) background of the terminal
|
||||||
|
emulator. *urxvt* required this in my testing; iTerm2 did not.
|
||||||
|
|
||||||
|
Note that on Mac OS X Terminal.app, solarized_termtrans is set to 1 by
|
||||||
|
default as this is almost always the best option. The only exception to
|
||||||
|
this is if the working terminfo file supports 256 colors (xterm-256color).
|
||||||
|
|
||||||
|
* g:solarized_degrade
|
||||||
|
|
||||||
|
For test purposes only; forces Solarized to use the 256 degraded color mode
|
||||||
|
to test the approximate color values for accuracy.
|
||||||
|
|
||||||
|
* g:solarized_bold | g:solarized_underline | g:solarized_italic
|
||||||
|
|
||||||
|
If you wish to stop Solarized from displaying bold, underlined or
|
||||||
|
italicized typefaces, simply assign a zero value to the appropriate
|
||||||
|
variable, for example: `let g:solarized_italic=0`
|
||||||
|
|
||||||
|
* g:solarized_contrast
|
||||||
|
|
||||||
|
Stick with normal! It's been carefully tested. Setting this option to high
|
||||||
|
or low does use the same Solarized palette but simply shifts some values up
|
||||||
|
or down in order to expand or compress the tonal range displayed.
|
||||||
|
|
||||||
|
* g:solarized_visibility
|
||||||
|
|
||||||
|
Special characters such as trailing whitespace, tabs, newlines, when
|
||||||
|
displayed using `:set list` can be set to one of three levels depending on
|
||||||
|
your needs. Default value is `normal` with `high` and `low` options.
|
||||||
|
|
||||||
|
Toggle Background Function
|
||||||
|
--------------------------
|
||||||
|
|
||||||
|
Solarized comes with a Toggle Background plugin that by default will map to
|
||||||
|
<F5> if that mapping is available. If it is not available you will need to
|
||||||
|
either map the function manually or change your current <F5> mapping to
|
||||||
|
something else.
|
||||||
|
|
||||||
|
To set your own mapping in your .vimrc file, simply add the following line to
|
||||||
|
support normal, insert and visual mode usage, changing the "<F5>" value to the
|
||||||
|
key or key combination you wish to use:
|
||||||
|
|
||||||
|
call togglebg#map("<F5>")
|
||||||
|
|
||||||
|
Note that you'll want to use a single function key or equivalent if you want
|
||||||
|
the plugin to work in all modes (normal, insert, visual).
|
||||||
|
|
||||||
|
Code Notes
|
||||||
|
----------
|
||||||
|
|
||||||
|
Use folding to view the `solarized.vim` script with `foldmethod=marker` turned
|
||||||
|
on.
|
||||||
|
|
||||||
|
I have attempted to modularize the creation of Vim colorschemes in this script
|
||||||
|
and, while it could be refactored further, it should be a good foundation for
|
||||||
|
the creation of any color scheme. By simply changing the sixteen values in the
|
||||||
|
GUI section and testing in gvim (or mvim) you can rapidly prototype new
|
||||||
|
colorschemes without diving into the weeds of line-item editing each syntax
|
||||||
|
highlight declaration.
|
||||||
|
|
||||||
|
The Values
|
||||||
|
----------
|
||||||
|
|
||||||
|
L\*a\*b values are canonical (White D65, Reference D50), other values are
|
||||||
|
matched in sRGB space.
|
||||||
|
|
||||||
|
SOLARIZED HEX 16/8 TERMCOL XTERM/HEX L*A*B sRGB HSB
|
||||||
|
--------- ------- ---- ------- ----------- ---------- ----------- -----------
|
||||||
|
base03 #002b36 8/4 brblack 234 #1c1c1c 15 -12 -12 0 43 54 193 100 21
|
||||||
|
base02 #073642 0/4 black 235 #262626 20 -12 -12 7 54 66 192 90 26
|
||||||
|
base01 #586e75 10/7 brgreen 240 #4e4e4e 45 -07 -07 88 110 117 194 25 46
|
||||||
|
base00 #657b83 11/7 bryellow 241 #585858 50 -07 -07 101 123 131 195 23 51
|
||||||
|
base0 #839496 12/6 brblue 244 #808080 60 -06 -03 131 148 150 186 13 59
|
||||||
|
base1 #93a1a1 14/4 brcyan 245 #8a8a8a 65 -05 -02 147 161 161 180 9 63
|
||||||
|
base2 #eee8d5 7/7 white 254 #d7d7af 92 -00 10 238 232 213 44 11 93
|
||||||
|
base3 #fdf6e3 15/7 brwhite 230 #ffffd7 97 00 10 253 246 227 44 10 99
|
||||||
|
yellow #b58900 3/3 yellow 136 #af8700 60 10 65 181 137 0 45 100 71
|
||||||
|
orange #cb4b16 9/3 brred 166 #d75f00 50 50 55 203 75 22 18 89 80
|
||||||
|
red #dc322f 1/1 red 160 #d70000 50 65 45 220 50 47 1 79 86
|
||||||
|
magenta #d33682 5/5 magenta 125 #af005f 50 65 -05 211 54 130 331 74 83
|
||||||
|
violet #6c71c4 13/5 brmagenta 61 #5f5faf 50 15 -45 108 113 196 237 45 77
|
||||||
|
blue #268bd2 4/4 blue 33 #0087ff 55 -10 -45 38 139 210 205 82 82
|
||||||
|
cyan #2aa198 6/6 cyan 37 #00afaf 60 -35 -05 42 161 152 175 74 63
|
||||||
|
green #859900 2/2 green 64 #5f8700 60 -20 65 133 153 0 68 100 60
|
||||||
|
|
||||||
|
License
|
||||||
|
-------
|
||||||
|
Copyright (c) 2011 Ethan Schoonover
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in
|
||||||
|
all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||||
|
THE SOFTWARE.
|
||||||
@ -0,0 +1,55 @@
|
|||||||
|
" Toggle Background
|
||||||
|
" Modified: 2011 Apr 29
|
||||||
|
" Maintainer: Ethan Schoonover
|
||||||
|
" License: OSI approved MIT license
|
||||||
|
|
||||||
|
if exists("g:loaded_togglebg")
|
||||||
|
finish
|
||||||
|
endif
|
||||||
|
let g:loaded_togglebg = 1
|
||||||
|
|
||||||
|
" noremap is a bit misleading here if you are unused to vim mapping.
|
||||||
|
" in fact, there is remapping, but only of script locally defined remaps, in
|
||||||
|
" this case <SID>TogBG. The <script> argument modifies the noremap scope in
|
||||||
|
" this regard (and the noremenu below).
|
||||||
|
nnoremap <unique> <script> <Plug>ToggleBackground <SID>TogBG
|
||||||
|
inoremap <unique> <script> <Plug>ToggleBackground <ESC><SID>TogBG<ESC>a
|
||||||
|
vnoremap <unique> <script> <Plug>ToggleBackground <ESC><SID>TogBG<ESC>gv
|
||||||
|
nnoremenu <script> Window.Toggle\ Background <SID>TogBG
|
||||||
|
inoremenu <script> Window.Toggle\ Background <ESC><SID>TogBG<ESC>a
|
||||||
|
vnoremenu <script> Window.Toggle\ Background <ESC><SID>TogBG<ESC>gv
|
||||||
|
tmenu Window.Toggle\ Background Toggle light and dark background modes
|
||||||
|
nnoremenu <script> ToolBar.togglebg <SID>TogBG
|
||||||
|
inoremenu <script> ToolBar.togglebg <ESC><SID>TogBG<ESC>a
|
||||||
|
vnoremenu <script> ToolBar.togglebg <ESC><SID>TogBG<ESC>gv
|
||||||
|
tmenu ToolBar.togglebg Toggle light and dark background modes
|
||||||
|
noremap <SID>TogBG :call <SID>TogBG()<CR>
|
||||||
|
|
||||||
|
function! s:TogBG()
|
||||||
|
let &background = ( &background == "dark"? "light" : "dark" )
|
||||||
|
if exists("g:colors_name")
|
||||||
|
exe "colorscheme " . g:colors_name
|
||||||
|
endif
|
||||||
|
endfunction
|
||||||
|
|
||||||
|
if !exists(":ToggleBG")
|
||||||
|
command ToggleBG :call s:TogBG()
|
||||||
|
endif
|
||||||
|
|
||||||
|
function! ToggleBackground()
|
||||||
|
echo "Please update your ToggleBackground mapping. ':help togglebg' for information."
|
||||||
|
endfunction
|
||||||
|
|
||||||
|
function! togglebg#map(mapActivation)
|
||||||
|
try
|
||||||
|
exe "silent! nmap <unique> ".a:mapActivation." <Plug>ToggleBackground"
|
||||||
|
exe "silent! imap <unique> ".a:mapActivation." <Plug>ToggleBackground"
|
||||||
|
exe "silent! vmap <unique> ".a:mapActivation." <Plug>ToggleBackground"
|
||||||
|
finally
|
||||||
|
return 0
|
||||||
|
endtry
|
||||||
|
endfunction
|
||||||
|
|
||||||
|
if !exists("no_plugin_maps") && !hasmapto('<Plug>ToggleBackground')
|
||||||
|
call togglebg#map("<F5>")
|
||||||
|
endif
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 1.6 KiB |
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,254 @@
|
|||||||
|
*solarized.vim* for Vim version 7.3 or newer. Modified: 2011 May 05
|
||||||
|
|
||||||
|
|
||||||
|
Solarized Vim Colorscheme by Ethan Schoonover ~
|
||||||
|
|
||||||
|
Solarized Colorscheme *solarized*
|
||||||
|
*solarized-help*
|
||||||
|
*solarized-colors*
|
||||||
|
*solarized-colorscheme*
|
||||||
|
*vim-colors-solarized*
|
||||||
|
|
||||||
|
Solarized is a carefully designed selective contrast colorscheme with dual
|
||||||
|
light and dark modes that runs in both GUI, 256 and 16 color modes.
|
||||||
|
|
||||||
|
See the homepage at http://ethanschoonover.com/solarized for screenshots and
|
||||||
|
details.
|
||||||
|
|
||||||
|
0. Install |solarized-install|
|
||||||
|
1. Solarized Menu |solarized-menu|
|
||||||
|
2. Options |solarized-options|
|
||||||
|
3. Toggle Background |solarized-togglebg|
|
||||||
|
4. Terminal Issues |solarized-term|
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
0. Install *solarized-install*
|
||||||
|
|
||||||
|
Note: I recommend using Tim Pope's pathogen plugin to install this
|
||||||
|
colorscheme. See https://github.com/tpope/vim-pathogen . If you've installed
|
||||||
|
pathogen properly you can install Solarized with the following commands,
|
||||||
|
followed by the .vimrc configuration below.
|
||||||
|
|
||||||
|
$ cd ~/.vim/bundle
|
||||||
|
$ git clone https://github.com/altercation/vim-colors-solarized.git
|
||||||
|
|
||||||
|
If you aren't using pathogen, you can use the following three steps to install
|
||||||
|
Solarized:
|
||||||
|
|
||||||
|
1. Download the solarized distribution (available on the homepage above)
|
||||||
|
and unarchive the file.
|
||||||
|
|
||||||
|
2. Move `solarized.vim` to your `.vim/colors` directory.
|
||||||
|
|
||||||
|
3. Move each of the files in each subdirectories to the corresponding .vim
|
||||||
|
subdirectory (e.g. autoload/togglebg.vim goes into your .vim/autoload
|
||||||
|
directory as .vim/autoload/togglebg.vim).
|
||||||
|
|
||||||
|
|
||||||
|
After installation, place the following lines in your .vimrc:
|
||||||
|
|
||||||
|
syntax enable
|
||||||
|
set background=dark
|
||||||
|
colorscheme solarized
|
||||||
|
|
||||||
|
or, for the light background mode of Solarized:
|
||||||
|
|
||||||
|
syntax enable
|
||||||
|
set background=light
|
||||||
|
colorscheme solarized
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
1. Solarized Menu *solarized-menu*
|
||||||
|
|
||||||
|
Solarized makes available a menu when used in Vim GUI mode (gvim, macvim).
|
||||||
|
This menu includes many of the options detailed below so that you can test out
|
||||||
|
different values quickly without modifying your .vimrc file. If you wish to
|
||||||
|
turn off this menu permanently, simply place the following line in your .vimrc
|
||||||
|
above the "colorscheme solarized" line.
|
||||||
|
|
||||||
|
let g:solarized_menu=0
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
2. Toggle Background *solarized-togglebg*
|
||||||
|
*toggle-bg* *togglebg*
|
||||||
|
*toggle-background*
|
||||||
|
|
||||||
|
Solarized comes with Toggle Background, a simple plugin to switch between
|
||||||
|
light and dark background modes and reset the colorscheme. This is most useful
|
||||||
|
for colorschemes that support both light and dark modes and in terminals or
|
||||||
|
gui vim windows where the background will be properly set.
|
||||||
|
|
||||||
|
Toggle Background can be accessed by:
|
||||||
|
|
||||||
|
* the Solarized menu (in Vim gui mode)
|
||||||
|
* the Window menu (in Vim gui mode, even if the Solarized menu is off)
|
||||||
|
* the "yin/yang" toolbar button (in Vim gui mode)
|
||||||
|
* the default mapping of <F5>
|
||||||
|
* custom key mapping you set in your .vimrc (see below)
|
||||||
|
* command line via ":ToggleBG" (no quotes)
|
||||||
|
|
||||||
|
Toggle Background starts with a default mapping to function key <F5>. If you
|
||||||
|
are already using this in a mapping, Toggle Background will not map itself to
|
||||||
|
a default and you will have to map it manually in your .vimrc file, or
|
||||||
|
remove/change your existing <F5> mapping to another value. To customize the
|
||||||
|
keyboard mapping in your .vimrc file, use the following line, changing the
|
||||||
|
"<F5>" value to the key or key combination you wish to use:
|
||||||
|
|
||||||
|
call togglebg#map("<F5>")
|
||||||
|
|
||||||
|
Note that you'll want to use a single function key or equivalent if you want
|
||||||
|
the plugin to work in all modes (normal, insert, visual).
|
||||||
|
|
||||||
|
When using the plugin during normal, visual, or insert mode, there should be
|
||||||
|
no interruption in workflow. However, if you activate the plugin during
|
||||||
|
REPLACE mode, you will switch to standard insert mode (you will leave the
|
||||||
|
overwrite replace mode).
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
3. Solarized Terminal Issues *solarized-term*
|
||||||
|
|
||||||
|
If you are going to use Solarized in Terminal mode (i.e. not in a GUI version
|
||||||
|
like gvim or macvim), **please please please** consider setting your terminal
|
||||||
|
emulator's colorscheme to used the Solarized palette. I've included palettes
|
||||||
|
for some popular terminal emulator as well as Xdefaults in the official
|
||||||
|
Solarized download available from the Solarized homepage listed at the top of
|
||||||
|
this help document. If you use Solarized *without* these colors, Solarized
|
||||||
|
will need to be told to degrade its colorscheme to a set compatible with the
|
||||||
|
limited 256 terminal palette (whereas by using the terminal's 16 ansi color
|
||||||
|
values, you can set the correct, specific values for the Solarized palette).
|
||||||
|
|
||||||
|
If you do use the custom terminal colors, solarized.vim should work out of
|
||||||
|
the box for you. If you are using a terminal emulator that supports 256
|
||||||
|
colors and don't want to use the custom Solarized terminal colors, you will
|
||||||
|
need to use the degraded 256 colorscheme. To do so, simply add the following
|
||||||
|
line *before* the `colorschem solarized` line:
|
||||||
|
|
||||||
|
let g:solarized_termcolors=256
|
||||||
|
|
||||||
|
Again, I recommend just changing your terminal colors to Solarized values
|
||||||
|
either manually or via one of the many terminal schemes available for import.
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
4. Solarized Options *solarized-options*
|
||||||
|
|
||||||
|
|
||||||
|
AUTOGENERATE OPTIONS
|
||||||
|
|
||||||
|
You can easily modify and experiment with Solarized display options using the
|
||||||
|
Solarized menu when using Vim in gui mode. Once you have things set to your
|
||||||
|
liking, you can autogenerate the current option list in a format ready for
|
||||||
|
insertion into your .vimrc file using the Solarized menu "Autogenerate
|
||||||
|
Options" command or at the command line with:
|
||||||
|
|
||||||
|
:SolarizedOptions
|
||||||
|
|
||||||
|
|
||||||
|
OPTION LIST
|
||||||
|
|
||||||
|
Set these in your vimrc file prior to calling the colorscheme.
|
||||||
|
|
||||||
|
option name default optional
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_termcolors= 16 | 256
|
||||||
|
g:solarized_termtrans = 0 | 1
|
||||||
|
g:solarized_degrade = 0 | 1
|
||||||
|
g:solarized_bold = 1 | 0
|
||||||
|
g:solarized_underline = 1 | 0
|
||||||
|
g:solarized_italic = 1 | 0
|
||||||
|
g:solarized_contrast = "normal"| "high" or "low"
|
||||||
|
g:solarized_visibility= "normal"| "high" or "low"
|
||||||
|
g:solarized_hitrail = 0 | 1
|
||||||
|
g:solarized_menu = 1 | 0
|
||||||
|
------------------------------------------------
|
||||||
|
|
||||||
|
|
||||||
|
OPTION DETAILS
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_termcolors= 256 | 16 *'solarized_termcolors'*
|
||||||
|
------------------------------------------------
|
||||||
|
The most important option if you are using vim in terminal (non gui) mode!
|
||||||
|
This tells Solarized to use the 256 degraded color mode if running in a 256
|
||||||
|
color capable terminal. Otherwise, if set to `16` it will use the terminal
|
||||||
|
emulators colorscheme (best option as long as you've set the emulators colors
|
||||||
|
to the Solarized palette).
|
||||||
|
|
||||||
|
If you are going to use Solarized in Terminal mode (i.e. not in a GUI
|
||||||
|
version like gvim or macvim), **please please please** consider setting your
|
||||||
|
terminal emulator's colorscheme to used the Solarized palette. I've included
|
||||||
|
palettes for some popular terminal emulator as well as Xdefaults in the
|
||||||
|
official Solarized download available from:
|
||||||
|
http://ethanschoonover.com/solarized . If you use Solarized without these
|
||||||
|
colors, Solarized will by default use an approximate set of 256 colors. It
|
||||||
|
isn't bad looking and has been extensively tweaked, but it's still not quite
|
||||||
|
the real thing.
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_termtrans = 0 | 1 *'solarized_termtrans'*
|
||||||
|
------------------------------------------------
|
||||||
|
If you use a terminal emulator with a transparent background and Solarized
|
||||||
|
isn't displaying the background color transparently, set this to 1 and
|
||||||
|
Solarized will use the default (transparent) background of the terminal
|
||||||
|
emulator. *urxvt* required this in my testing; iTerm2 did not.
|
||||||
|
|
||||||
|
Note that on Mac OS X Terminal.app, solarized_termtrans is set to 1 by
|
||||||
|
default as this is almost always the best option. The only exception to this
|
||||||
|
is if the working terminfo file supports 256 colors (xterm-256color).
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_degrade = 0 | 1 *'solarized_degrade'*
|
||||||
|
------------------------------------------------
|
||||||
|
For test purposes only; forces Solarized to use the 256 degraded color mode
|
||||||
|
to test the approximate color values for accuracy.
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_bold = 1 | 0 *'solarized_bold'*
|
||||||
|
------------------------------------------------
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_underline = 1 | 0 *'solarized_underline'*
|
||||||
|
------------------------------------------------
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_italic = 1 | 0 *'solarized_italic'*
|
||||||
|
------------------------------------------------
|
||||||
|
If you wish to stop Solarized from displaying bold, underlined or
|
||||||
|
italicized typefaces, simply assign a zero value to the appropriate
|
||||||
|
variable, for example: `let g:solarized_italic=0`
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_contrast = "normal"| "high" or "low" *'solarized_contrast'*
|
||||||
|
------------------------------------------------
|
||||||
|
Stick with normal! It's been carefully tested. Setting this option to high
|
||||||
|
or low does use the same Solarized palette but simply shifts some values up
|
||||||
|
or down in order to expand or compress the tonal range displayed.
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_visibility = "normal"| "high" or "low" *'solarized_visibility'*
|
||||||
|
------------------------------------------------
|
||||||
|
Special characters such as trailing whitespace, tabs, newlines, when
|
||||||
|
displayed using ":set list" can be set to one of three levels depending on
|
||||||
|
your needs.
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_hitrail = 0 | 1 *'solarized_hitrail'*
|
||||||
|
------------------------------------------------
|
||||||
|
Visibility can make listchar entities more visible, but if one has set
|
||||||
|
cursorline on, these same listchar values standout somewhat less due to the
|
||||||
|
background color of the cursorline. g:solarized_hitrail enables highlighting
|
||||||
|
of trailing spaces (only one of the listchar types, but a particularly
|
||||||
|
important one) while in the cursoline in a different manner in order to make
|
||||||
|
them more visible. This may not work consistently as Solarized is using
|
||||||
|
a pattern match than can be overridden by a more encompassing syntax-native
|
||||||
|
match such as a comment line.
|
||||||
|
|
||||||
|
|
||||||
|
------------------------------------------------
|
||||||
|
g:solarized_menu = 1 | 0 *'solarized_menu'*
|
||||||
|
------------------------------------------------
|
||||||
|
Solarized includes a menu providing access to several of the above
|
||||||
|
display related options, including contrast and visibility. This allows
|
||||||
|
for an easy method of testing different values quickly before settling
|
||||||
|
on a final assignment for your .vimrc. If you wish to turn off this menu,
|
||||||
|
assign g:solarized_menu a value of 0.
|
||||||
|
|
||||||
|
|
||||||
|
vim:tw=78:noet:ts=8:ft=help:norl:
|
||||||
@ -0,0 +1,27 @@
|
|||||||
|
'solarized_bold' solarized.txt /*'solarized_bold'*
|
||||||
|
'solarized_contrast' solarized.txt /*'solarized_contrast'*
|
||||||
|
'solarized_degrade' solarized.txt /*'solarized_degrade'*
|
||||||
|
'solarized_hitrail' solarized.txt /*'solarized_hitrail'*
|
||||||
|
'solarized_italic' solarized.txt /*'solarized_italic'*
|
||||||
|
'solarized_menu' solarized.txt /*'solarized_menu'*
|
||||||
|
'solarized_termcolors' solarized.txt /*'solarized_termcolors'*
|
||||||
|
'solarized_termtrans' solarized.txt /*'solarized_termtrans'*
|
||||||
|
'solarized_underline' solarized.txt /*'solarized_underline'*
|
||||||
|
'solarized_visibility' solarized.txt /*'solarized_visibility'*
|
||||||
|
before solarized.txt /*before*
|
||||||
|
solarized solarized.txt /*solarized*
|
||||||
|
solarized-colors solarized.txt /*solarized-colors*
|
||||||
|
solarized-colorscheme solarized.txt /*solarized-colorscheme*
|
||||||
|
solarized-help solarized.txt /*solarized-help*
|
||||||
|
solarized-install solarized.txt /*solarized-install*
|
||||||
|
solarized-menu solarized.txt /*solarized-menu*
|
||||||
|
solarized-options solarized.txt /*solarized-options*
|
||||||
|
solarized-term solarized.txt /*solarized-term*
|
||||||
|
solarized-togglebg solarized.txt /*solarized-togglebg*
|
||||||
|
solarized.vim solarized.txt /*solarized.vim*
|
||||||
|
toggle-background solarized.txt /*toggle-background*
|
||||||
|
toggle-bg solarized.txt /*toggle-bg*
|
||||||
|
togglebg solarized.txt /*togglebg*
|
||||||
|
urxvt solarized.txt /*urxvt*
|
||||||
|
vim-colors-solarized solarized.txt /*vim-colors-solarized*
|
||||||
|
without solarized.txt /*without*
|
||||||
Loading…
Reference in New Issue