109 lines
3.5 KiB
Markdown
109 lines
3.5 KiB
Markdown
jellybeans.vim
|
||
==============
|
||
|
||
A colorful, dark color scheme, inspired by [ir_black][] and [twilight][].
|
||
|
||
Designed primarily for a graphical Vim, but includes support for 256, 88, 16,
|
||
and 8 color terminals. On a 16 or 8 color terminal, replace its colors with
|
||
those in `ansi-term-colors.txt` for best results.
|
||
|
||
This script is [vimscript #2555][vimscript] at Vim.org.
|
||
|
||
Scroll down for [screenshots][ss-anchor]!
|
||
|
||
## Options
|
||
|
||
### Custom Highlights
|
||
|
||
If you prefer slightly different colors from what Jellybeans defines,
|
||
you can set `g:jellybeans_overrides` in your .vimrc to a dictionary of
|
||
custom highlighting parameters:
|
||
|
||
let g:jellybeans_overrides = {
|
||
\ 'Todo': { 'guifg': '303030', 'guibg': 'f0f000',
|
||
\ 'ctermfg': 'Black', 'ctermbg': 'Yellow',
|
||
\ 'attr': 'bold' },
|
||
\ 'Comment': { 'guifg': 'cccccc' },
|
||
\}
|
||
|
||
This removes the need to edit Jellybeans directly, simplifying
|
||
upgrades. In addition, RGB colors specified this way are run through
|
||
the same color approximation algorithm that the core theme uses, so
|
||
your colors work just as well in 256-color terminals.
|
||
|
||
If you can pick better colors than the approximator, specify them
|
||
in the `256ctermfg` and `256ctermbg` parameters to override
|
||
its choices.
|
||
|
||
#### Custom Background Colors
|
||
|
||
To set a custom background color, override the special
|
||
`background` highlight group:
|
||
|
||
let g:jellybeans_overrides = {
|
||
\ 'background': { 'guibg': '000000' },
|
||
\}
|
||
|
||
Jellybeans uses the background color in multiple highlight
|
||
groups. Using the special `background` group overrides them all
|
||
at once.
|
||
|
||
This replaces `g:jellybeans_background_color` and
|
||
`g:jellybeans_background_color_256` from Jellybeans versions
|
||
before 1.6.
|
||
|
||
#### Terminal Background
|
||
|
||
If you would prefer to use your terminal's default background
|
||
(e.g. for transparent backgrounds, image backgrounds, or a
|
||
different color) instead of the background color that Jellybeans
|
||
applies, use this `background` override:
|
||
|
||
let g:jellybeans_overrides = {
|
||
\ 'background': { 'ctermbg': 'none', '256ctermbg': 'none' },
|
||
\}
|
||
|
||
### Italics
|
||
|
||
Jellybeans disables italics in terminal Vim by default, as some
|
||
terminals do other things with the text's colors instead of
|
||
actually italicizing the text. If your terminal does fully
|
||
support italics, add
|
||
|
||
let g:jellybeans_use_term_italics = 1
|
||
|
||
to your .vimrc to enable italics in terminal Vim.
|
||
|
||
If you don't want italics even in GUI Vim, add
|
||
|
||
let g:jellybeans_use_gui_italics = 0
|
||
|
||
### Low-Color Black (16 and 8 color terminals)
|
||
|
||
Since the background on a dark terminal is usually black already,
|
||
Jellybeans appropriates the black ANSI color as a dark grey and
|
||
uses no color when it really wants black.
|
||
|
||
If you can’t or don’t want to change your terminal’s color
|
||
mappings, add
|
||
|
||
let g:jellybeans_use_lowcolor_black = 0
|
||
|
||
to your .vimrc to render “black” text as Vim’s grey (ANSI white).
|
||
|
||
Users of Apple’s pre-10.7 Terminal.app can use the TerminalColours
|
||
plugin ([Leopard][tc-leopard], [Snow Leopard][tc-snowleopard]) to
|
||
change the default colors.
|
||
|
||
## Screenshots
|
||
|
||
![][preview-ss]
|
||
|
||
|
||
[ir_black]: https://web.archive.org/web/20140211124943/http://toddwerth.com/2008/01/25/a-black-os-x-leopard-terminal-theme-that-is-actually-readable/
|
||
[twilight]: http://www.vim.org/scripts/script.php?script_id=1677
|
||
[vimscript]: http://www.vim.org/scripts/script.php?script_id=2555
|
||
[tc-leopard]: http://ciaranwal.sh/2007/11/01/customising-colours-in-leopard-terminal
|
||
[tc-snowleopard]: https://github.com/timmfin/terminalcolours
|
||
[preview-ss]: https://nanotech.nanotechcorp.net/downloads/jellybeans-preview.png
|
||
[ss-anchor]: #screenshots
|