mirror of
https://github.com/neovim/neovim.git
synced 2024-12-23 20:55:18 -07:00
a98a6996c2
Vim runtime files based on 7.4.384 / hg changeset 7090d7f160f7
Excluding:
Amiga icons (*.info, icons/)
doc/hangulin.txt
tutor/
spell/
lang/ (only used for menu translations)
macros/maze/, macros/hanoi/, macros/life/, macros/urm/
These were used to test vi compatibility.
termcap
"Demonstration of a termcap file (for the Amiga and Archimedes)"
Helped-by: Rich Wareham <rjw57@cam.ac.uk>
Helped-by: John <john.schmidt.h@gmail.com>
Helped-by: Yann <yann@yann-salaun.com>
Helped-by: Christophe Badoit <c.badoit@lesiteimmo.com>
Helped-by: drasill <github@tof2k.com>
Helped-by: Tae Sandoval Murgan <taecilla@gmail.com>
Helped-by: Lowe Thiderman <lowe.thiderman@gmail.com>
73 lines
2.6 KiB
Plaintext
73 lines
2.6 KiB
Plaintext
README.txt for color scheme files
|
|
|
|
These files are used for the ":colorscheme" command. They appear in the
|
|
Edit/Color Scheme menu in the GUI.
|
|
|
|
|
|
Hints for writing a color scheme file:
|
|
|
|
There are two basic ways to define a color scheme:
|
|
|
|
1. Define a new Normal color and set the 'background' option accordingly.
|
|
set background={light or dark}
|
|
highlight clear
|
|
highlight Normal ...
|
|
...
|
|
|
|
2. Use the default Normal color and automatically adjust to the value of
|
|
'background'.
|
|
highlight clear Normal
|
|
set background&
|
|
highlight clear
|
|
if &background == "light"
|
|
highlight Error ...
|
|
...
|
|
else
|
|
highlight Error ...
|
|
...
|
|
endif
|
|
|
|
You can use ":highlight clear" to reset everything to the defaults, and then
|
|
change the groups that you want differently. This also will work for groups
|
|
that are added in later versions of Vim.
|
|
Note that ":highlight clear" uses the value of 'background', thus set it
|
|
before this command.
|
|
Some attributes (e.g., bold) might be set in the defaults that you want
|
|
removed in your color scheme. Use something like "gui=NONE" to remove the
|
|
attributes.
|
|
|
|
In case you want to set 'background' depending on the colorscheme selected,
|
|
this autocmd might be useful:
|
|
autocmd SourcePre */colors/blue_sky.vim set background=dark
|
|
Replace "blue_sky" with the name of the colorscheme.
|
|
|
|
In case you want to tweak a colorscheme after it was loaded, check out that
|
|
ColorScheme autocmd event.
|
|
|
|
To see which highlight group is used where, find the help for
|
|
"highlight-groups" and "group-name".
|
|
|
|
You can use ":highlight" to find out the current colors. Exception: the
|
|
ctermfg and ctermbg values are numbers, which are only valid for the current
|
|
terminal. Use the color names instead. See ":help cterm-colors".
|
|
|
|
The default color settings can be found in the source file src/syntax.c.
|
|
Search for "highlight_init".
|
|
|
|
If you think you have a color scheme that is good enough to be used by others,
|
|
please check the following items:
|
|
|
|
- Does it work in a color terminal as well as in the GUI?
|
|
- Is "g:colors_name" set to a meaningful value? In case of doubt you can do
|
|
it this way:
|
|
let g:colors_name = expand('<sfile>:t:r')
|
|
- Is 'background' either used or appropriately set to "light" or "dark"?
|
|
- Try setting 'hlsearch' and searching for a pattern, is the match easy to
|
|
spot?
|
|
- Split a window with ":split" and ":vsplit". Are the status lines and
|
|
vertical separators clearly visible?
|
|
- In the GUI, is it easy to find the cursor, also in a file with lots of
|
|
syntax highlighting?
|
|
- Do not use hard coded escape sequences, these will not work in other
|
|
terminals. Always use color names or #RRGGBB for the GUI.
|