neovim/runtime/colors
Evgeni Chasnovski 4f788f78f8
vim-patch:9.1.0061: UX of visual highlighting can be improved (#27256)
Problem:  UX of visual highlighting can be improved
Solution: Improve readibility of visual highlighting,
          by setting better foreground and background
          colors

The default visual highlighting currently is nice in that it overlays
the actual syntax highlighting by using a separate distinct background
color.

However, this can cause hard to read text, because the contrast
between the actual syntax element and the background color is way too
low. That is an issue, that has been bothering colorschemes authors for
quite some time so much, that they are defining the Visual highlighting
group to use a separate foreground and background color, so that the
syntax highlighting vanishes, but the text remains readable (ref:
vim/colorschemesvim/vim#250)

So this is an attempt to perform the same fix for the default Visual
highlighting and just use a default foreground and background color
instead of using reverse.

I also removed the hard-coded changes to the Visual highlighting in
init_highlight. It's not quite clear to me, why those were there and not
added directly to the highlighting_init_<dark|light> struct.

closes: vim/vim#13663
related: vim/colorschemes#250

e6d8b4662d

Co-authored-by: Christian Brabandt <cb@256bit.org>
2024-01-29 18:39:57 +08:00
..
blue.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
darkblue.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
default.vim feat(highlight): tweak default color scheme 2023-12-16 14:43:03 +01:00
delek.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
desert.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
elflord.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
evening.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
habamax.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
industry.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
koehler.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
lunaperche.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
morning.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
murphy.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
pablo.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
peachpuff.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
quiet.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
README.txt vim-patch:dbf749bd5aae (#25665) 2023-10-16 16:36:25 +08:00
retrobox.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
ron.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
shine.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
slate.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
sorbet.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
torte.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
vim.lua vim-patch:9.1.0061: UX of visual highlighting can be improved (#27256) 2024-01-29 18:39:57 +08:00
wildcharm.vim vim-patch:5f4cc8ea65e8 2024-01-12 13:52:26 +01:00
zaibatsu.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00
zellner.vim fix(runtime): source old color scheme in bundled color schemes (#26641) 2023-12-21 20:53:43 +08:00

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.

The colorschemes were updated for the Vim 9 release.  If you don't like the
changes you can find the old ones here:
https://github.com/vim/colorschemes/tree/master/legacy_colors


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 will also 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 the
ColorScheme autocommand event.

To clean up just before loading another colorscheme, use the ColorSchemePre
autocommand event.  For example: >

	let g:term_ansi_colors = ...
	augroup MyColorscheme
	  au!
	  au ColorSchemePre * unlet g:term_ansi_colors
	  au ColorSchemePre * au! MyColorscheme
	augroup END

To customize a colorscheme use another name, e.g.  "~/.vim/colors/mine.vim",
and use ":runtime" to load the original colorscheme: >

	" load the "evening" colorscheme
	runtime colors/evening.vim
	" change the color of statements
	hi Statement ctermfg=Blue guifg=Blue

To see which highlight group is used where, see `:help highlight-groups` and
`:help 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 for better portability.  See
`:help cterm-colors` .

The default color settings can be found in the source file
"src/nvim/highlight_group.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:

- Source the $VIMRUNTIME/colors/tools/check_colors.vim script to check for
  common mistakes.

- Does it work in a color terminal as well as in the GUI? Is it consistent?

- 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?

- In general, test your color scheme against as many filetypes, Vim features,
  environments, etc. as possible.

- Do not use hard coded escape sequences, these will not work in other
  terminals.  Always use #RRGGBB for the GUI.

- When targeting 8-16 colors terminals, don't count on "darkblue" to be blue
  and dark, or on "2" to be even vaguely reddish.  Names are more portable
  than numbers, though.

- When targeting 256 colors terminals, prefer colors 16-255 to colors 0-15
  for the same reason.

- Typographic attributes (bold, italic, underline, reverse, etc.) are not
  universally supported.  Don't count on any of them.

- Is "g:terminal_ansi_colors" set to a list of 16 #RRGGBB values?

- Try to keep your color scheme simple by avoiding unnecessary logic and
  refraining from adding options.  The best color scheme is one that only
  requires: >

  	colorscheme foobar

The color schemes distributed with Vim are built with lifepillar/colortemplate
(https://github.com/lifepillar/vim-colortemplate).  It is therefore highly
recommended.

If you would like your color scheme to be distributed with Vim, make sure
that:

- it satisfies the guidelines above,
- it was made with colortemplate,

and join us at vim/colorschemes: (https://github.com/vim/colorschemes).


vim: set ft=help :