Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tldr-pages/tlrc
A tldr client written in Rust
https://github.com/tldr-pages/tlrc
hacktoberfest rust tldr tldr-pages
Last synced: about 1 month ago
JSON representation
A tldr client written in Rust
- Host: GitHub
- URL: https://github.com/tldr-pages/tlrc
- Owner: tldr-pages
- License: mit
- Created: 2023-04-14T23:19:32.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-09T19:22:12.000Z (about 1 month ago)
- Last Synced: 2024-05-09T20:35:53.922Z (about 1 month ago)
- Topics: hacktoberfest, rust, tldr, tldr-pages
- Language: Rust
- Homepage: http://tldr.sh/tlrc/
- Size: 374 KB
- Stars: 183
- Watchers: 6
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- my-awesome-stars - tldr-pages/tlrc - A tldr client written in Rust (Rust)
README
# tlrc
A [tldr](https://github.com/tldr-pages/tldr) client written in Rust.
[](https://github.com/tldr-pages/tlrc/actions/workflows/ci.yml)
[][latest-release]
[][crate]
[](/LICENSE)
[][latest-release]
[](https://matrix.to/#/#tldr-pages:matrix.org)
## Installation
### Linux/macOS using Homebrew
Install [tlrc](https://formulae.brew.sh/formula/tlrc) with Homebrew:
```shell
brew install tlrc
```
### Linux/macOS using Nix
Install [tlrc](https://search.nixos.org/packages?channel=unstable&show=tlrc) from nixpkgs.
### Arch Linux
Install [tlrc](https://aur.archlinux.org/packages/tlrc) (from source) or [tlrc-bin](https://aur.archlinux.org/packages/tlrc-bin) (prebuilt) from the AUR.
### openSUSE
Install [tlrc](https://software.opensuse.org/package/tlrc) with Zypper:
```shell
zypper install tlrc
```
### Windows
Install [tlrc](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/tldr-pages/tlrc) with Winget:
```shell
winget install tldr-pages.tlrc
```
### macOS using MacPorts
Install [tlrc](https://ports.macports.org/port/tlrc/details) with MacPorts:
```shell
port install tlrc
```
### NetBSD
Install [tlrc](https://ftp.netbsd.org/pub/NetBSD/NetBSD-current/pkgsrc/net/tlrc/index.html) with `pkgin`:
```shell
pkgin install tlrc
```
### From crates.io
To build [tlrc][crate] from a source tarball, run:
```shell
cargo install tlrc
```
> [!NOTE]
> Shell completion files and the man page will not be installed that way.
### From GitHub Releases
You can find prebuilt binaries [here][latest-release].
## Usage
See `man tldr` or the [online manpage](https://tldr.sh/tlrc). For a brief description, you can also run:
```shell
tldr --help
```
## Configuration
Tlrc can be customized with a [TOML](https://toml.io) configuration file. To get the default path for your system, run:
```shell
tldr --config-path
```
To generate a default config file, run:
```shell
tldr --gen-config > $(tldr --config-path)
```
or copy the below example.
### Configuration options
```toml
[cache]
# Override the cache directory.
dir = "/path/to/cache"
# Automatically update the cache when it is if it is older than max_age hours.
auto_update = true
max_age = 336
# Specify a list of desired page languages. If it is empty, languages specified in
# the LANG and LANGUAGE environment variables are downloaded.
# English is implied and will always be downloaded.
# You can see a list of language codes here: https://github.com/tldr-pages/tldr
# Example: ["de", "pl"]
languages = []
[output]
# Show the title in the rendered page.
show_title = true
# Show the platform name ('common', 'linux', etc.) in the title.
platform_title = false
# Prefix descriptions of examples with hyphens.
show_hyphens = false
# Use a custom string instead of a hyphen.
example_prefix = "- "
# Strip empty lines from output.
compact = false
# Print pages in raw markdown.
raw_markdown = false
# Number of spaces to put before each line of the page.
[indent]
# Command name.
title = 2
# Command description.
description = 2
# Descriptions of examples.
bullet = 2
# Example command invocations.
example = 4
# Style for the title of the page (command name).
[style.title]
# Fixed colors: "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "default"
# 256color ANSI code: { color256 = 50 }
# RGB: { rgb = [0, 255, 255] }
color = "magenta"
background = "default"
bold = true
underline = false
italic = false
dim = false
strikethrough = false
# Style for the description of the page.
[style.description]
color = "magenta"
background = "default"
bold = false
underline = false
italic = false
dim = false
strikethrough = false
# Style for descriptions of examples.
[style.bullet]
color = "green"
background = "default"
bold = false
underline = false
italic = false
dim = false
strikethrough = false
# Style for command examples.
[style.example]
color = "cyan"
background = "default"
bold = false
underline = false
italic = false
dim = false
strikethrough = false
# Style for URLs inside the description.
[style.url]
color = "red"
background = "default"
bold = false
underline = false
italic = true
dim = false
strikethrough = false
# Style for text surrounded by backticks (`).
[style.inline_code]
color = "yellow"
background = "default"
bold = false
underline = false
italic = true
dim = false
strikethrough = false
# Style for placeholders inside command examples.
[style.placeholder]
color = "red"
background = "default"
bold = false
underline = false
italic = true
dim = false
strikethrough = false
```
[latest-release]: https://github.com/tldr-pages/tlrc/releases/latest
[crate]: https://crates.io/crates/tlrc