Solarized Colorscheme for Vim ============================= Developed by Ethan Schoonover See the [homepage for the Solarized colorscheme][solarized] for screenshots, details and colorscheme versions for Vim, Mutt, popular terminal emulators and other applications. If you have come across this colorscheme via the [vim-only repository on github][vim-solarized-github], or the [vim.org script page][vimorg-script] see the link above to the Solarized homepage or visit the [github repository for Solarized][solarized-github]. [solarized]: http://ethanschoonover.com/solarized [solarized-github]: https://github.com/altercation/solarized [vim-solarized-github]: https://github.com/altercation/vim-colors-solarized [vimorg-script]: http://vim.org/script [pathogen]: https://github.com/tpope/vim-pathogen Installation ------------ ### Option 1: Manual installation 1. Put the files in the right place! 2. Move `solarized.vim` to your `.vim/colors` directory. ### 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: set background=dark colorscheme solarized or, for the light background mode of Solarized: set background=light colorscheme solarized See the [Solarized homepage][solarized] for screenshots which will help you select either the light or dark background. Advanced Configuration ---------------------- Solarized will work out of the box with just the two lines specified above. ### **IMPORTANT NOTE FOR TERMINAL USERS** If you are running vim in a terminal, Solarized will run in 256 color mode if the terminal supports it, but those 256 colors are (in all 256 color terminal emulators) limited to a "degraded" color palette. While the colors will all approximate the specific Solarized color values, if you prefer an accurate color palette you can set the ANSI colors in your terminal and use the 16 color terminal mode using the g:solarized_termcolors="16" option detailed below. The ANSI color map is specified in the table below and terminal color themes are available for download from the web page listed at the top of this file, including xorg defaul color values and themes for OS X Terminal.app and iTerm2. 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. 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.