| This is a fork of [chriskempson](https://github.com/chriskempson)'s [base16-vim](https://github.com/chriskempson/base16-vim) which refreshes and commits new themes weekly automatically and has a documented build process. | | --- | # Base16 Vim See the [Base16 repository](https://github.com/chriskempson/base16) for more information. This theme was built with [base16-builder-python](https://github.com/InspectorMustache/base16-builder-python). Supports graphical Vim and console Vim. ![Base16 Vim](https://raw.github.com/fnune/base16-vim/master/base16-vim.png) ## Terminal Themes For terminal Vim (non-gui) please ensure you are using a base16 terminal theme. * [iTerm2](https://github.com/chriskempson/base16-iterm2) ## Installation Add `colorscheme base16-default-dark` to your `~/.vimrc`. ### Vundle Add the following to your `~/.vimrc` file and run `PluginInstall` in Vim. Plugin 'fnune/base16-vim' ### vim-plug Add the following to your `~/.vimrc` file and run `PlugInstall` in Vim. Plug 'fnune/base16-vim' ### Pathogen cd ~/.vim/bundle git clone https://github.com/fnune/base16-vim.git ### Manual cd ~/.vim/colors git clone git://github.com/fnune/base16-vim.git base16 cp base16/colors/*.vim . ## 256 colorspace If using a Base16 terminal theme designed to keep the 16 ANSI colors intact (a "256" variation) **and** have sucessfully modified your 256 colorspace with [base16-shell](https://github.com/chriskempson/base16-shell) you'll need to add the following to your `~/.vimrc` **before** the colorsheme declaration. let base16colorspace=256 " Access colors present in 256 colorspace This will cause vim to access the colours in the modified 256 colorspace. Please **do not** enable this simply because you have a 256 color terminal as this will cause colors to be displayed incorrectly. ## Troubleshooting There is a script to help troubleshoot colour issues called `colortest` available in the [Base16 Shell](https://github.com/fnune/base16-shell) repository. If you are using a ISO-8613-3 compatible terminal ( [vim docs](https://github.com/vim/vim/blob/23c1b2b018c8121ca5fcc247e37966428bf8ca66/runtime/doc/options.txt#L7876), [neovim docs](https://neovim.io/doc/user/options.html#'termguicolors')), and you see a green or blue line, try to enable `termguicolors`: ```vim set termguicolors ``` ### Green line numbers ![green line numbers screenshot](https://raw.github.com/chriskempson/base16-vim/master/without-base16colorspace-256-with-256-terminal-theme.png) If your Vim looks like the above image you are using a 256 terminal theme without setting `let base16colorspace=256` in your `~/.vimrc`. Either set `let base16colorspace=256` in your `~/.vimrc` or use a non 256 terminal theme. ### Blue line numbers ![blue line numbers screenshot](https://raw.github.com/chriskempson/base16-vim/master/with-base16colorspace-256-without-base16-shell.png) If your Vim looks like the above image you are setting `let base16colorspace=256` in your `~/.vimrc` but either not running [Base16 Shell](https://github.com/fnune/base16-shell) or [Base16 Shell](https://github.com/fnune/base16-shell) is not working for your terminal. Either ensure [Base16 Shell](https://github.com/fnune/base16-shell) is working by running the `colortest` available in the [Base16 Shell](https://github.com/fnune/base16-shell) repository or not setting `let base16colorspace=256` in your `~/.vimrc`. ## Customization If you want to do some local customization, you can add something like this to your `~/.vimrc`: ```vim function! s:base16_customize() abort call Base16hi("MatchParen", g:base16_gui05, g:base16_gui03, g:base16_cterm05, g:base16_cterm03, "bold,italic", "") endfunction augroup on_change_colorschema autocmd! autocmd ColorScheme * call s:base16_customize() augroup END ``` ## Building Dependencies: - Python, at least version 3.5 - The `pybase16` command from [base16-builder-python](https://github.com/InspectorMustache/base16-builder-python) - The `make` command ``` # Install dependencies (you probably already have pip/pip3 and make) apt install build-essential # for make pip3 install pybase16-builder # Build the packages make ```