Aide commande Bash https://github.com/pepa65/tldr-bash-client.git

pepa65 d66529837d Version 0.45 2 months ago
LICENSE e241a2f3b8 Restored original MIT license 1 year ago
README.md d66529837d Version 0.45 2 months ago
tldr d66529837d Version 0.45 2 months ago
tldr-customize.jpg 1869338e4f Limited support for languages, missing index.json for other languages. 3 months ago
tldr-lint 7033c3324e Moved to gitlab 1 year ago
tldr-list.jpg 5a6514741c Release 0.37 1 year ago
tldr-markdown-new.jpg 5a6514741c Release 0.37 1 year ago
tldr-markdown.jpg 5a6514741c Release 0.37 1 year ago
tldr-page.gif 0cd34e48cf Better gif 2 years ago
tldr-page.jpg 5a6514741c Release 0.37 1 year ago
tldr-search.jpg 1869338e4f Limited support for languages, missing index.json for other languages. 3 months ago
tldr-usage.jpg 1869338e4f Limited support for languages, missing index.json for other languages. 3 months ago

README.md

tldr-bash-client

  • version 0.45

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 page gif

This client can render both the old and the new tldr markup format.

Installation

Download the tldr bash script to the install location:

loc=/usr/local/bin/tldr  # elevated privileges needed for some locations
sudo wget -qO $loc https://4e4.win/tldr
sudo chmod +x $loc

If the location is not in $PATH, you need to specify the path to run it.

tldr page screenshot tldr usage screenshot

Prerequisites

coreutils, grep, unzip, curl / wget, less (optional)

tldr search screenshot

Output customisation

tldr customize screenshot

The 5 elements in TLDR markup that can be styled with these colors and backgrounds (last one specified will be used) and modes (more can apply):

  • Colors: Black, Red, Green, Yellow, Blue, Magenta, Cyan, White
  • BG: BlackBG, RedBG, GreenBG, YellowBG, BlueBG, MagentaBG, CyanBG, WhiteBG
  • Modes: Bold, Underline, Italic, Inverse

Newline can be added to the style list to add a newline before the element and Space to add a space at the start of the line (style items are separated by space, lower/uppercase mixed allowed)

  • TLDR_TITLE_STYLE (defaults to: Newline Space Bold Yellow)
  • TLDR_DESCRIPTION_STYLE (defaults to: Space Yellow)
  • TLDR_EXAMPLE_STYLE (defaults to: Newline Space Bold Green)
  • TLDR_CODE_STYLE (defaults to: Space Bold Blue)
  • TLDR_VALUE_ISTYLE (defaults to: Space Bold Cyan)

The Value style (above) is an Inline style: doesn't take Newline or Space

Inline styles for help text: default, URL, option, platform, command, header

  • TLDR_DEFAULT_ISTYLE (defaults to: White)
  • TLDR_URL_ISTYLE (defaults to: Yellow)
  • TLDR_HEADER_ISTYLE (defaults to: Bold)
  • TLDR_OPTION_ISTYLE (defaults to: Bold Yellow)
  • TLDR_PLATFORM_ISTYLE (defaults to: Bold Blue)
  • TLDR_COMMAND_ISTYLE (defaults to: Bold Cyan)
  • TLDR_FILE_ISTYLE (defaults to: Bold Magenta)

Color/BG (Newline and Space also allowed) for error and info messages

  • TLDR_ERROR_COLOR (defaults to: Newline Space Red)
  • TLDR_INFO_COLOR (defaults to: Newline Space Green)

How many days before freshly downloading a potentially stale page

  • TLDR_EXPIRY (defaults to 7) Alternative location of pages cache
  • TLDR_CACHE (not set by default) Usage of 'less' or 'cat' for output (set to '0' for cat)
  • TLDR_LESS (1 by default; if set to 0 cat will be used) Force current OS
  • TLDR_OS (overrides what is read by uname -s) Force preferred language: ISO639 format (2 lowercase letters)
  • TLDR_LANG (not set by default, $LANG is used from environment)

tldr list screenshot

Autocompletion

When the following lines are added to ~/.bashrc or run in the current session, then tldr will autocomplete, which means possible tldr page names will be suggested when tapping the Tab key twice on an incomplete tldr page name:

cachedir=~/.local/share/tldr # Or whatever else the location of the tldr cache is
complete -W "$(q=($cachedir/*/*); sed 's@\.md @ @g' <<<${q[@]##*/})" tldr

tldr new markdown screenshot

tldr-lint

  • version 0.11

Linter for new syntax tldr source files

Usage: tldr-lint [-h|--help] [-V|--version] [-q|--quiet] [<dir>] [<file>]
          - All *.md files under <dir> and subdirectories are checked
          - <file> is checked regardless of extension
          -q, --quiet:    No output means check is OK
          -V, --version:  Display version
          -h, --help:     Display this help text

tldr markdown screenshot

Prerequisites

coreutils, sed, grep, find

Contributing

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

tldr-bash-client gitlab page

License

Original tldr client in bash by Ray Lee http://github.com/raylee/tldr (MIT license)

The tldr-bash-client is relicensed under GPLv3+ and tldr-lint is GPLv3+ as well.