prezto/modules/syntax-highlighting/README.md
Indrajit Raychaudhuri d80e393f78 general: Reformat documentation with better formatting and wording
General purpose reformating and rewording in (a few places). This should
also make markdown linting happier.

Prefer back-ticks wherever useful and use `console` for code blocks to
be executed on terminal.

Also, update references links wherever possible (including update from
'http://' to 'https://').
2021-05-05 12:21:04 -05:00

1.8 KiB

Syntax Highlighting

Integrates zsh-syntax-highlighting into Prezto.

This module should be loaded before the prompt module.

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

To elaborate: The relative order of loading the modules would be 'syntax-highlighting', 'history-substring-search' 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 ~/.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 ~/.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 ~/.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.