diff options
| author | Francisco de Zuviría <franciscodezuviria@gmail.com> | 2019-04-22 16:06:47 -0300 |
|---|---|---|
| committer | Marc Cornellà <marc.cornella@live.com> | 2019-04-22 21:06:47 +0200 |
| commit | ebd13b60c107f424b40438404c18c3e8dc03433c (patch) | |
| tree | 251e1d901772e20fb905fd0f93e567446ea83853 /plugins/colorize/README.md | |
| parent | 9b2410fbcfa21d6115219fe626a6f422b578d3ac (diff) | |
| download | zsh-ebd13b60c107f424b40438404c18c3e8dc03433c.tar.gz zsh-ebd13b60c107f424b40438404c18c3e8dc03433c.tar.bz2 zsh-ebd13b60c107f424b40438404c18c3e8dc03433c.zip | |
colorize: add ability to colorize multiple files into less (#7662)
cless is an alias for a colorized less wrappper: colorize_via_pygmentize_less.
Note that cless opens many files as independent files, navigatable with `:n` and `:p`.
Diffstat (limited to 'plugins/colorize/README.md')
| -rw-r--r-- | plugins/colorize/README.md | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/plugins/colorize/README.md b/plugins/colorize/README.md index c006071f9..71fa87861 100644 --- a/plugins/colorize/README.md +++ b/plugins/colorize/README.md @@ -2,6 +2,10 @@ With this plugin you can syntax-highlight file contents of over 300 supported languages and other text formats. +Colorize will highlight the content based on the filename extension. If it can't find a syntax-highlighting +method for a given extension, it will try to find one by looking at the file contents. If no highlight method +is found it will just cat the file normally, without syntax highlighting. + To use it, add colorize to the plugins array of your zshrc file: ``` plugins=(... colorize) @@ -9,9 +13,16 @@ plugins=(... colorize) ## Usage -* `ccat <file> [files]`: colorize the contents of the file (or files, if more than one are provided). If no arguments are passed it will colorize the standard input or stdin. +* `ccat <file> [files]`: colorize the contents of the file (or files, if more than one are provided). + If no arguments are passed it will colorize the standard input or stdin. + +* `cless <file> [files]`: colorize the contents of the file (or files, if more than one are provided) and + open less. If no arguments are passed it will colorize the standard input or stdin. -Colorize will highlight the content based on the filename extension. If it can't find a syntax-highlighting method for a given extension, it will try to find one by looking at the file contents. If no highlight method is found it will just cat the file normally, without syntax highlighting. +Note that `cless` will behave as less when provided more than one file: you have to navigate files with +the commands `:n` for next and `:p` for previous. The downside is that less options are not supported. +But you can circumvent this by either using the LESS environment variable, or by running `ccat file1 file2|less --opts`. +In the latter form, the file contents will be concatenated and presented by less as a single file. ## Requirements |