A Vim plugin to highlight custom patterns on any buffer (filetype whitelist/blacklist supported), for example highlight indentation, inactive window, word under the cursor or even user made Vim highlighting.

• https://gitlab.com/bimlas/vim-high (main respository)

• https://github.com/bimlas/vim-high (mirror, please star if you like it)

To try out, install in your preferred way, then enable a lighter by :HighEnable <C-D>.

To enable lighters by default, add the preferred ones to g:high_lighter as a dictionary in your .vimrc, like this:

1. The _ key means these settings will affect every lighter,

2. for example all of them will be disabled in these filetypes.

3. You can add predefined lighters, whose can be found in autoload/high/light/ directory.

4. To override the global settings, pass the lighter-specific ones in the dictionary.

5. You can create your own lighters as you want.

By default, every lighter in g:high_lighters are enabled at Vim startup, but passing 'enabled': 0 will disable it. To use the lighter, call :HighEnable lighter or :HighToggle lighter.

The available configuration parameters can be found in plugin/high.vim as g:high.defaults. Options starting with double underscore (__init_function for example) are private and you shouldn’t override those. See :help matchadd for pattern and priority; :highlight for possible values of hlgroup.

Some lighters have specific settings, starting with an underscore (_length of long_line for example) are lighter-specific, the underscore is used only to prevent conflicts with global settings, but you can safely override those.

Do not fear to view the source files to get the possibilities, because there is no help file for the plugin, source codes and test files contains everything.

To define your own hlgroup, take a look at :help highlight. Here are the highlight groups of the example config, place it to your .vimrc:

Some lighters are based on Vim settings, for example indent uses shiftwidth to highlight the indentation. The highlighting will follow the change of it only on certain events (jumping to another window, switching buffer, etc.). To apply the new settings automatically, you have to write an autocommand in your .vimrc:

It will update every lighter where the __update_function is set.

For example, a very basic implentation of Valloric/vim-operator-highlight should looks like this:

1. Add a name to the lighter (which is not in use),

2. define the pattern to match,

3. add whitelist/blacklist,

4. choose a hlgroup from the existing ones.

Vim Netrw filetype coloring

let g:high_lighters = {
\ 'netrw_yaml': {
\   'whitelist': ['netrw'],
\   'pattern': '\v^([|│] )*\zs\f+\.yml',
\   'hlgroup': 'HighNetrwYaml',
\ },
\ 'netrw_asciidoc': {
\   'whitelist': ['netrw'],
\   'pattern': '\v^([|│] )*\zs\f+\.adoc',
\   'hlgroup': 'HighNetrwAsciidoc',
\ }}

autocmd ColorScheme,VimEnter *
\ highlight! HighNetrwYaml guifg=#ae9400 |
\ highlight! HighNetrwAsciidoc guifg=#dd3a00