docs: Tweaks to highlighters.md after recent refactoring branch.

Merge remote-tracking branch 'danielsh/docs-highlighters.d-landing-page-v3'

* danielsh/docs-highlighters.d-landing-page-v3:
  docs: Restore (with changes) links removed in f5ca4b891b.
  docs: Followup to the recent docs branch: clean up some internal cross-references.
  docs: Clarify tagline summary of 'root' highlighter
  docs: Minor clarification.

Fixes zsh-users/zsh-syntax-highlighting#242.
This commit is contained in:
Daniel Shahaf 2015-11-27 04:12:02 +00:00
commit 952a97dbc9
3 changed files with 29 additions and 14 deletions

View File

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

View File

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

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.