public/zsh-syntax-highlighting
1
0
Fork 0
mirror of https://github.com/zsh-users/zsh-syntax-highlighting.git synced 2025-04-17 11:35:32 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge 55dbb05e3c into 2e5481ab9a

Browse Source
This commit is contained in:
Daniel Shahaf 2015-11-27 03:48:03 +00:00
commit b7294588c2
3 changed files with 22 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@ -45,5 +45,5 @@ How to tweak
------------
Syntax highlighting is done by pluggable highlighter scripts. See the
[`highlighters` directory](./highlighters) for documentation and configuration
settings.
[documentation on highlighters](docs/highlighters.md) for details and
configuration settings.

23
docs/highlighters.md
View File

@ -3,12 +3,12 @@ zsh-syntax-highlighting / highlighters
Syntax highlighting is done by pluggable highlighters:
* `main` - the base highlighter, and the only one active by default.
* `brackets` - matches brackets and parenthesis.
* `pattern` - matches user-defined patterns.
* `cursor` - matches the cursor position.
* `root` - triggered if the current user is root.
* `line` - applied to the whole command line
* `main` - the base highlighter, and the only one [active by default](highlighters/main.md).
* `brackets` - [matches brackets](highlighters/brackets.md) and parenthesis.
* `pattern` - matches [user-defined patterns](highlighters/pattern.md).
* `cursor` - matches [the cursor](highlighters/cursor.md) position.
* `root` - highlights the whole command line [if the current user is root](highlighters/root.md).
* `line` - applied to [the whole command line](highlighters/line.md).
How to activate highlighters
@ -27,15 +27,16 @@ How to tweak highlighters
-------------------------
Highlighters look up styles from the `ZSH_HIGHLIGHT_STYLES` associative array.
Navigate into each highlighter directory to see what styles (keys) it defines;
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][zshzle-Character-Highlighting].
Navigate into the [individual highlighters' documentation](highlighters/) to
see what styles (keys) each highlighter defines; 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][zshzle-Character-Highlighting].
[zshzle-Character-Highlighting]: http://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html#Character-Highlighting
Some highlighters support additional configuration parameters; see each
highlighter's documentation for details.
highlighter's documentation for details and examples.
How to implement a new highlighter

1
highlighters/README.md
View File

@ -1 +0,0 @@
../docs/highlighters.md

8
highlighters/README.md Normal file
View File

@ -0,0 +1,8 @@
zsh-syntax-highlighting / highlighters
======================================
Navigate into the individual highlighters' documentation to see
what styles (`$ZSH_HIGHLIGHT_STYLES` keys) each highlighter defines.
Refer to the [documentation on highlighters](../docs/highlighters.md) for further
information.