2019-08-03 14:33:40 -07:00
|
|
|
# Colored man pages plugin
|
|
|
|
|
|
|
|
|
|
This plugin adds colors to man pages.
|
|
|
|
|
|
|
|
|
|
To use it, add `colored-man-pages` to the plugins array in your zshrc file:
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
plugins=(... colored-man-pages)
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-30 11:13:12 -07:00
|
|
|
It will also automatically colorize man pages displayed by `dman` or `debman`,
|
|
|
|
|
from [`debian-goodies`](https://packages.debian.org/stable/debian-goodies).
|
|
|
|
|
|
2019-08-03 14:33:40 -07:00
|
|
|
You can also try to color other pages by prefixing the respective command with `colored`:
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
colored git help clone
|
|
|
|
|
```
|
2020-11-12 11:32:17 -07:00
|
|
|
|
|
|
|
|
## Customization
|
|
|
|
|
|
|
|
|
|
The plugin declares global associative array `less_termcap`, which maps termcap capabilities to escape
|
|
|
|
|
sequences for the `less` pager. This mapping can be further customized by the user after the plugin is
|
|
|
|
|
loaded. Check out sources for more.
|
|
|
|
|
|
|
|
|
|
For example: `less_termcap[md]` maps to `LESS_TERMCAP_md` which is the escape sequence that tells `less`
|
|
|
|
|
how to print something in bold. It's currently shown in bold red, but if you want to change it, you
|
|
|
|
|
can redefine `less_termcap[md]` in your zshrc file, after OMZ is sourced:
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
less_termcap[md]="${fg_bold[blue]}" # this tells less to print bold text in bold blue
|
|
|
|
|
```
|
