2
0
Fork 0
mirror of https://github.com/pepa65/tldr-bash-client.git synced 2024-11-13 07:21:06 +01:00
Find a file
2017-02-07 09:01:32 +07:00
LICENSE First release after having gone overboard in modifications and enhancements, 2017-02-06 00:00:42 +07:00
README.md Added rendering of the new markdown as well, 2017-02-07 02:16:54 +07:00
tldr Fix serious logic error in platform choice code 2017-02-07 09:01:32 +07:00
tldr-customize.jpg Renamed repo, adapted readme and customize screenshot 2017-02-06 10:48:48 +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.jpg Renamed repo, adapted readme and customize screenshot 2017-02-06 10:48:48 +07:00
tldr-usage.jpg Added render option, adapted readme and usage screenshot 2017-02-06 10:11:13 +07:00

tldr-bash-client

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.

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!

This tldr-bash-client github page

tldr markdown screenshot

License

Relicensed under GPL v3+

tldr new markdown screenshot