2.4 KiB
tldr-bash-client
- version 0.1a
- https://github.com/pepa65/tldr-bash-client
Bash client for tldr: community driven man-by-example
A fully-functional bash client for the tldr project, providing poignant examples of terminal commands.
This client can render both the old and the new tldr markup format.
Installation
Download the tldr bash script to the install location:
location=/usr/local/bin/tldr # elevated privileges needed for some locations
sudo wget -qO $location https://raw.githubusercontent.com/pepa65/tldr-bash-client/master/tldr
sudo chmod +x $location
If the location is not in $PATH, you need to specify the path to run it.
Alternately, you can do sudo bpkg-install pepa65/tldr
if you have
bpkg installed.
Prerequisites
coreutils, less, grep, unzip, curl / wget
Customisation
The colors and other styling of the 5 elements of tldr pages can be modified either by editing the first few lines of the scipt, or by setting the following environment variables:
- TLDR_TITLE_STYLE (defaults to: Newline Space Bold Yellow)
- TLDR_DESCRIPTION_STYLE (defaults to: Space Yellow)
- TLDR_EXAMPLE_STYLE (defaults to: Newline Bold Green)
- TLDR_CODE_STYLE (defaults to: Space Bold Blue)
- TLDR_VALUE_STYLE (defaults to: Bold Cyan)
Also the error color and page expiry can easily be set:
- TLDR_ERROR_COLOR (defaults to: Red)
- TLDR_EXPIRY (defaults to: 60)
Contributing
Please file an issue for a question, a bug or a feature request. Or even better, send a pull request!
License
Relicensed under GPL v3+