zsh-syntax-highlighting/docs/highlighters/pattern.md
Ivan Smirnov f19ff89432
Add instructions about initializing variable
Many users use modular configuration loaders for zshrc. Adding a note to users explaining how to define ZSH_HIGHLIGHT_PATTERNS before sourcing zsh-syntax-highlighting. The typeset is important, since simply setting the variable doesn't have the desired effect.
2018-08-20 16:49:39 -07:00

939 B

zsh-syntax-highlighting / highlighters / pattern

This is the pattern highlighter, that highlights user-defined patterns.

How to tweak it

To use this highlighter, associate patterns with styles in the ZSH_HIGHLIGHT_PATTERNS associative array, for example in ~/.zshrc:

# To have commands starting with `rm -rf` in red:
ZSH_HIGHLIGHT_PATTERNS+=('rm -rf *' 'fg=white,bold,bg=red')

The syntax for values is the same as the syntax of "types of highlighting" of the zsh builtin $zle_highlight array, which is documented in the zshzle(1) manual page. Note: if you would like to define this variable before you source zsh-syntax-highlighting, you will need to declare it first with: typeset -gA ZSH_HIGHLIGHT_PATTERNS.