Go to file
pepa65 0cd34e48cf Better gif 2017-02-26 11:52:00 +07:00
LICENSE First release after having gone overboard in modifications and enhancements, 2017-02-06 00:00:42 +07:00
Makefile Add files for bpkg 2017-02-22 19:57:27 +07:00
README.md Version 0.2 2017-02-23 16:17:43 +07:00
package.json Version 0.2 2017-02-23 16:17:43 +07:00
tldr Version 0.2 2017-02-23 16:17:43 +07:00
tldr-customize.jpg Updated screenshots 2017-02-23 16:28:11 +07:00
tldr-list.jpg Cut down screenshots, removed mention of ncurses (tput) as requirement 2017-02-06 00:19:38 +07:00
tldr-markdown-new.jpg Added rendering of the new markdown as well, 2017-02-07 02:16:54 +07:00
tldr-markdown.jpg Cut down screenshots, removed mention of ncurses (tput) as requirement 2017-02-06 00:19:38 +07:00
tldr-page.gif Better gif 2017-02-26 11:52:00 +07:00
tldr-page.jpg Renamed repo, adapted readme and customize screenshot 2017-02-06 10:48:48 +07:00
tldr-usage.jpg Updated screenshots 2017-02-23 16:28:11 +07:00

README.md

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.

tldr list screenshot

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.

tldr page gif [](tldr page screenshot)

Prerequisites

coreutils, less, grep, unzip, curl / wget

tldr usage screenshot

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)
tldr customize screenshot

Contributing

Please file an issue for a question, a bug or a feature request. Or even better, send a pull request!

tldr-bash-client github page

tldr markdown screenshot

License

Relicensed under GPL v3+

tldr new markdown screenshot