Ahmed Wael 6bc4c80c7d fix(colored-man-pages): add env GROFF_NO_SGR=1 (#11831) 7 months ago
..
README.md 9b119866dd refactor(colored-man-pages): move nroff wrapper and refactor logic in `colored` function (#9437) 3 years ago
colored-man-pages.plugin.zsh 6bc4c80c7d fix(colored-man-pages): add env GROFF_NO_SGR=1 (#11831) 7 months ago
nroff 9b119866dd refactor(colored-man-pages): move nroff wrapper and refactor logic in `colored` function (#9437) 3 years ago

README.md

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:

plugins=(... colored-man-pages)

It will also automatically colorize man pages displayed by dman or debman, from debian-goodies.

You can also try to color other pages by prefixing the respective command with colored:

colored git help clone

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:

less_termcap[md]="${fg_bold[blue]}" # this tells less to print bold text in bold blue