Skip to content

Sublime Syntax definition for sharkdp/bat to colorize command --help messages.

License

Notifications You must be signed in to change notification settings

victor-gp/cmd-help-sublime-syntax

Repository files navigation

cmd-help.sublime-syntax

Sublime Syntax definition for bat to colorize command --help messages.

It provides just enough color to help find your way around a help message.

Example usage of the cmd-help syntax on 'bat -h'

See examples from other help messages.

Installation

This syntax is included with bat since version 0.21.0.

If you have an earlier version of bat or you want the latest version of cmd-help, you can add it as a new syntax. You have to copy this file.

To check that everything works, run git --help | bat -plhelp

Configuration

You can find various configuration tips in the wiki. Some of the topics it covers include:

  • Setting a bathelp alias to avoid typing the full bat command with options each time (basic configuration).
  • Adding a help function you can use like $ help <CMD>, or even $ help <CMD> <SUBCMD>.
  • Enhancing --help so you can simply type $ <CMD> --help as usual.

cmd-help is compatible with most bat themes (~2/3rds). To get the best experience, ensure your configured theme is supported. You can find the full list of compatible themes here.

Contributing

Contributions are welcome! :D

Make sure to give CONTRIBUTING.md a cursory read to learn how you can help.

If you want to hack on the project, look at the Development doc to help get you started.

If you like cmd-help, please star it on GitHub and spread the word. :)

License

MIT © Víctor González Prieto