mirror of
https://github.com/zsh-users/zsh-syntax-highlighting.git
synced 2025-02-20 10:15:31 +08:00
0916794aeb
It's really annoying to have partial paths appear the same as paths to complete files. However, it is still nice to be able to highlight them. Full paths are now bold while partial paths use plain underline.
60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
zsh-syntax-highlighting / highlighters / main
|
|
=============================================
|
|
|
|
This is the ***main*** highlighter, that highlights:
|
|
|
|
* Commands
|
|
* Options
|
|
* Arguments
|
|
* Paths
|
|
* Strings
|
|
|
|
How to activate it
|
|
------------------
|
|
To activate it, add it to `ZSH_HIGHLIGHT_HIGHLIGHTERS`:
|
|
|
|
ZSH_HIGHLIGHT_HIGHLIGHTERS=( [...] main)
|
|
|
|
This highlighter is active by default.
|
|
|
|
|
|
How to tweak it
|
|
---------------
|
|
This highlighter defines the following styles:
|
|
|
|
* `unknown-token` - unknown tokens / errors
|
|
* `reserved-word` - shell reserved words
|
|
* `alias` - aliases
|
|
* `builtin` - shell builtin commands
|
|
* `function` - functions
|
|
* `command` - commands
|
|
* `precommand` - precommands (i.e. exec, builtin, ...)
|
|
* `commandseparator` - command separation tokens
|
|
* `hashed-command` - hashed commands
|
|
* `path` - paths which exist
|
|
* `partial-path` - partial paths (prefixes of existing files)
|
|
* `globbing` - globbing expressions
|
|
* `history-expansion` - history expansion expressions
|
|
* `single-hyphen-option` - single hyphen options
|
|
* `double-hyphen-option` - double hyphen options
|
|
* `back-quoted-argument` - backquoted expressions
|
|
* `single-quoted-argument` - single quoted arguments
|
|
* `double-quoted-argument` - double quoted arguments
|
|
* `dollar-double-quoted-argument` - dollar double quoted arguments
|
|
* `back-double-quoted-argument` - back double quoted arguments
|
|
* `assign` - variable assignments
|
|
* `default` - parts of the buffer that do not match anything
|
|
|
|
To override one of those styles, change its entry in `ZSH_HIGHLIGHT_STYLES`, for example in `~/.zshrc`:
|
|
|
|
# To differentiate aliases from other command types
|
|
ZSH_HIGHLIGHT_STYLES[alias]='fg=magenta,bold'
|
|
|
|
# To have paths colored instead of underlined
|
|
ZSH_HIGHLIGHT_STYLES[path]='fg=cyan'
|
|
|
|
# To disable highlighting of globbing expressions
|
|
ZSH_HIGHLIGHT_STYLES[globbing]='none'
|
|
|
|
The syntax for declaring styles is [documented here](http://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html#SEC135).
|