A Python
command line client for tldr.
$ pip install tldr
$ sudo pacman -S tldr
$ sudo dnf install tldr
tldr <command>
You can configure the behaviour and output of the tldr
client by setting environment variables. For example, in the .bashrc
file:
export TLDR_COLOR_BLANK="white"
export TLDR_COLOR_NAME="cyan"
export TLDR_COLOR_DESCRIPTION="white"
export TLDR_COLOR_EXAMPLE="green"
export TLDR_COLOR_COMMAND="red"
export TLDR_COLOR_PARAMETER="white"
export TLDR_CACHE_ENABLED=1
export TLDR_CACHE_MAX_AGE=720
TLDR_CACHE_ENABLED
(default is1
):- If set to
1
, the client will first try to load from cache, and fall back to fetching from the internet if the cache doesn't exist or is too old. - If set to
0
, the client will fetch from the internet, and fall back to the cache if the page cannot be fetched from the internet.
- If set to
TLDR_CACHE_MAX_AGE
(default is24
): maximum age of the cache in hours to be considered as valid whenTLDR_CACHE_ENABLED
is set to1
.
$XDG_CACHE_HOME/tldr
$HOME/.cache/tldr
~/.cache/tldr
- Previously, the cache resided in
$HOME/.tldr_cache
If you are experiencing issues with tldr, consider deleting the cache files before trying other measures.
Values of the TLDR_COLOR_x
variables may consist of three parts:
- Font color, required:
blue, green, yellow, cyan, magenta, white, grey, red
- Background color:
on_blue, on_cyan, on_magenta, on_white, on_grey, on_yellow, on_red, on_green
- Additional effects, which depends on platform:
reverse, blink, dark, concealed, underline, bold
Values of background color and additional effect may be omitted:
TLDR_COLOR_DESCRIPTION="white"
for white text on default system background color without any effectsTLDR_COLOR_NAME="cyan dark"
for dark cyan text on default system background colorTLDR_COLOR_PARAMETER="red on_yellow underline"
for underlined red text on yellow background