Description:

tldart

tldart #


Fast tldr client written in dart.

Installation #

Installing it through the Dart SDK [Recommended]

$ dart pub global activate tldart
copied to clipboard
This will add the tldr executable to your path.

Manual installation

Simple binaries for windows, macos and linux are available in zip files in the release section. You can download the zip file, extract the tldr.exe (or tldr depending on your platform) and add the directory to your path.
Usage #
Tldart follows the tldr client specifications, so it should be the same as any other tldr client if you've used any before.
tldart stores a local copy of tldr-pages in your ~/.tldr directory. If its missing, the app will prompt you to update the cache directory.
Search for a page #
$ tldr man # to search for `man`

$ tldr git log # to search for `git-log`

$ tldr -p linux mv # to search for `mv` for linux platform

$ tldr -l ar chrome # to search for `chrome` in arabic lang
copied to clipboard
You can specify the language with the --language or -l flag.
Platform can be specified with --platform or -p flag. (One of 'linux', 'macos', 'windows', 'sunos', 'osx', 'android'). By default the platform used is the user's current platform, if the query is not available for the platform, the app switches to the common platform. You can view the raw markdown using the --raw or -r flag.
Render custom file #
To render a custom markdown file not within the cache directory, use the --render or -f flag.
$ tldr -f path/to/file.md
copied to clipboard
The -l and -p flag are completely useless in this case but the -r (raw) flag will work. If the markdown contains any line that does not match the tldr format, it is silently ignored.
Listing all commands #
$ tldr --list
copied to clipboard
Lists all the available command in your local cache
Updating local cache #
$ tldr --update
# or
$ tldr -u
copied to clipboard
This downloads the tldr archive, unzips it and stores it in your ~/.tldr/cache directory. This might take a few seconds or minutes as the archive file is big and unzipping it takes a bit of time.
The app emits some debug logs internally. This can be viewed by setting the DEBUG env variable to anything, as long as its not empty. For example in bash:
$ DEBUG=1 tldr -u
copied to clipboard
To see a short help, run
$ tldr tldr
copied to clipboard
For any problems, queries or bugs, feel free to open a new issue.
Credits #
This project was heavily inspired by dbrgn's tealdeer.
Author #
tldart © Yakiyo. Authored and maintained by Yakiyo.
Released under MIT License

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter