prezto/modules/syntax-highlighting/README.md

2.1 KiB

Syntax Highlighting

Integrates zsh-syntax-highlighting into Prezto.

This module must be loaded before the prompt module.

If this module is used in conjunction with the history-substring-search module, this module must be loaded before the history-substring-search module.

Additionally, if this module is used in conjunction with the autosuggestions module, this module must be loaded before the autosuggestions module as well.

To elaborate, the relative order of loading the modules would be syntax-highlighting, history-substring-search, autosuggestions and prompt.

Contributors

New features and bug fixes should be submitted to the zsh-syntax-highlighting project according to its rules and regulations. This module will be synchronized against it.

Settings

Highlighting

To enable highlighting for this module only, add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:syntax-highlighting' color 'yes'

Highlighters

Syntax highlighting is accomplished by pluggable highlighters. This module only enables the main highlighter by default.

To enable all highlighters, add the following to ${ZDOTDIR:-$HOME}/.zpreztorc.

zstyle ':prezto:module:syntax-highlighting' highlighters \
  'main' \
  'brackets' \
  'pattern' \
  'line' \
  'cursor' \
  'root'

Highlighting Styles

Each syntax highlighter defines styles used to highlight tokens.

To highlight, for example, builtins, commands, and functions in blue instead of green, add the following to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:syntax-highlighting' styles \
  'builtin' 'bg=blue' \
  'command' 'bg=blue' \
  'function' 'bg=blue'

Authors

The authors of this module should be contacted via the issue tracker.