<div>
<h1 align="center">tldr-man</h1>
<h5 align="center">A tldr-pages client that works just like <code>man</code></h5>
</div>
`tldr-man` is a command-line client for [tldr-pages][tldr-pages],
a collection of community-maintained help pages for command-line tools.
It differs from other clients because it displays its pages as `man` pages.
This client is also able to integrate with the `man` command to fall back to displaying a tldr-page for a command when
no manpage exists.
Features:
- Fully abides by the [tldr-pages client specification][client-spec].
- Supports all page languages, not just English pages.
- Displays tldr-pages in the same style as manpages.
- Integrates with `man` to provide a fallback for missing manpages.
- Supports rendering markdown formatted tldr-pages with `--render`.
- Local cache abides by the [XDG base directory specification][xdg].
- Supports shell completion for `bash`, `zsh`, and `fish` shells.
- And much more!
## Installation
### With Homebrew
Install `tldr-man` with [Homebrew](https://brew.sh):
```shell
brew install superatomic/tap/tldr-man
```
### With Pip
Install `tldr-man` with pip (version 3.10+):
```shell
pip install tldr-man
```
`tldr-man` additionally depends on [`pandoc`](https://pandoc.org/installing.html) being installed.
After installation, you can view a tldr-page with the `tldr` command.
## Usage
**Display a tldr-page for a command:**
```shell
tldr <COMMAND>
```
**Update the local page cache:**
```shell
tldr --update
```
**Render a page locally:**
```shell
tldr --render path/to/page.md
```
**Print tldr manpage paths as a colon-separated list (see the [Manpage Integration](#manpage-integration) section):**
```shell
tldr --manpath
```
**Display usage information:**
```shell
tldr --help
```
### Setting languages
[As specified by the tldr-pages client specification][client-spec-language],
tldr-pages from other languages can be displayed by this client
(falling back to English if the page doesn't exist for that language).
To do so, set any of the environment variables `$LANG`, `$LANGUAGE`, or `$TLDR_LANGUAGE` to the two-letter language code
for your language (e.g. `export LANGUAGE=es`),
or set the `--language` option when running `tldr` (e.g. `tldr <COMMAND> --language es`).
### Setting platforms
By default, tldr-pages will be displayed based on your current platform.
To directly specify what platform's page to use, use the `--platform` flag.
For example, to display the macOS version of the `top` command's tldr-page, run `tldr top --platform macos`.
This is the default behavior on macOS,
but `--platform macos` is required to show the macOS version of this page on other platforms.
## Manpage Integration
The command `man` can be set up to fall back to displaying tldr-pages if no manpages are found.
To do so,
add the provided line to your shell's startup script (e.g. `~/.bash_profile`, `~/.zshenv`, `~/.config/fish/config.fish`)
to add this behavior to `man`:
### Bash and Zsh
```shell
export MANPATH="$MANPATH:$(tldr --manpath)"
```
### Fish
```shell
set -gxa MANPATH (tldr --manpath)
```
[tldr-pages]: https://github.com/tldr-pages/tldr
[client-spec]: https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md
[client-spec-language]: https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md#language
[xdg]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
Raw data
{
"_id": null,
"home_page": "https://tldr-man.superatomic.dev/",
"name": "tldr-man",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.10.4",
"maintainer_email": null,
"keywords": "tldr, tldr-pages, man, manpage, tldr-client",
"author": "Olivia Kinnear",
"author_email": "contact@superatomic.dev",
"download_url": "https://files.pythonhosted.org/packages/9e/d5/145efae76326bb9b53a08b67c45f315336f0e193821ecde22e21a94785a5/tldr_man-1.5.2.tar.gz",
"platform": null,
"description": "<div>\n <h1 align=\"center\">tldr-man</h1>\n <h5 align=\"center\">A tldr-pages client that works just like <code>man</code></h5>\n</div>\n\n`tldr-man` is a command-line client for [tldr-pages][tldr-pages],\na collection of community-maintained help pages for command-line tools.\nIt differs from other clients because it displays its pages as `man` pages.\n\nThis client is also able to integrate with the `man` command to fall back to displaying a tldr-page for a command when\nno manpage exists.\n\nFeatures:\n- Fully abides by the [tldr-pages client specification][client-spec].\n- Supports all page languages, not just English pages.\n- Displays tldr-pages in the same style as manpages.\n- Integrates with `man` to provide a fallback for missing manpages.\n- Supports rendering markdown formatted tldr-pages with `--render`.\n- Local cache abides by the [XDG base directory specification][xdg].\n- Supports shell completion for `bash`, `zsh`, and `fish` shells.\n- And much more!\n\n\n## Installation\n\n### With Homebrew\n\nInstall `tldr-man` with [Homebrew](https://brew.sh):\n\n```shell\nbrew install superatomic/tap/tldr-man\n```\n\n### With Pip\n\nInstall `tldr-man` with pip (version 3.10+):\n\n```shell\npip install tldr-man\n```\n\n`tldr-man` additionally depends on [`pandoc`](https://pandoc.org/installing.html) being installed.\n\nAfter installation, you can view a tldr-page with the `tldr` command.\n\n\n## Usage\n\n**Display a tldr-page for a command:**\n\n```shell\ntldr <COMMAND>\n```\n\n**Update the local page cache:**\n\n```shell\ntldr --update\n```\n\n**Render a page locally:**\n\n```shell\ntldr --render path/to/page.md\n```\n\n**Print tldr manpage paths as a colon-separated list (see the [Manpage Integration](#manpage-integration) section):**\n\n```shell\ntldr --manpath\n```\n\n**Display usage information:**\n\n```shell\ntldr --help\n```\n\n\n### Setting languages\n\n[As specified by the tldr-pages client specification][client-spec-language],\ntldr-pages from other languages can be displayed by this client\n(falling back to English if the page doesn't exist for that language).\n\nTo do so, set any of the environment variables `$LANG`, `$LANGUAGE`, or `$TLDR_LANGUAGE` to the two-letter language code\nfor your language (e.g. `export LANGUAGE=es`),\nor set the `--language` option when running `tldr` (e.g. `tldr <COMMAND> --language es`).\n\n\n### Setting platforms\n\nBy default, tldr-pages will be displayed based on your current platform.\nTo directly specify what platform's page to use, use the `--platform` flag.\n\nFor example, to display the macOS version of the `top` command's tldr-page, run `tldr top --platform macos`.\nThis is the default behavior on macOS,\nbut `--platform macos` is required to show the macOS version of this page on other platforms.\n\n\n## Manpage Integration\n\nThe command `man` can be set up to fall back to displaying tldr-pages if no manpages are found.\n\nTo do so,\nadd the provided line to your shell's startup script (e.g. `~/.bash_profile`, `~/.zshenv`, `~/.config/fish/config.fish`)\nto add this behavior to `man`:\n\n### Bash and Zsh\n\n```shell\nexport MANPATH=\"$MANPATH:$(tldr --manpath)\"\n```\n\n### Fish\n\n```shell\nset -gxa MANPATH (tldr --manpath)\n```\n\n[tldr-pages]: https://github.com/tldr-pages/tldr\n[client-spec]: https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md\n[client-spec-language]: https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md#language\n[xdg]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Command-line TLDR client that displays tldr-pages as manpages",
"version": "1.5.2",
"project_urls": {
"Bug Tracker": "https://github.com/superatomic/tldr-man/issues",
"Documentation": "https://github.com/superatomic/tldr-man#readme",
"Homepage": "https://tldr-man.superatomic.dev/",
"Repository": "https://github.com/superatomic/tldr-man"
},
"split_keywords": [
"tldr",
" tldr-pages",
" man",
" manpage",
" tldr-client"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e6dfd26829d57a919c3a239f4aa14c205bbdda1e81588b9c962d46257dad0bab",
"md5": "ac8d2a8f685f9bb21c5b63f54cfcaef5",
"sha256": "fdd185bb3f386c9f87b9ec94b6439c34f2ebcb8add0cb5d323b63eeff59a2b02"
},
"downloads": -1,
"filename": "tldr_man-1.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ac8d2a8f685f9bb21c5b63f54cfcaef5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.10.4",
"size": 25480,
"upload_time": "2024-03-30T03:48:03",
"upload_time_iso_8601": "2024-03-30T03:48:03.687301Z",
"url": "https://files.pythonhosted.org/packages/e6/df/d26829d57a919c3a239f4aa14c205bbdda1e81588b9c962d46257dad0bab/tldr_man-1.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9ed5145efae76326bb9b53a08b67c45f315336f0e193821ecde22e21a94785a5",
"md5": "c50b7d53c21c06497410bcd622dd7fb4",
"sha256": "9846937efea7e6c9505545f8725773bb2a68185dc015479207da0b185b797dc3"
},
"downloads": -1,
"filename": "tldr_man-1.5.2.tar.gz",
"has_sig": false,
"md5_digest": "c50b7d53c21c06497410bcd622dd7fb4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.10.4",
"size": 19867,
"upload_time": "2024-03-30T03:48:05",
"upload_time_iso_8601": "2024-03-30T03:48:05.871922Z",
"url": "https://files.pythonhosted.org/packages/9e/d5/145efae76326bb9b53a08b67c45f315336f0e193821ecde22e21a94785a5/tldr_man-1.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-30 03:48:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "superatomic",
"github_project": "tldr-man",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tldr-man"
}
JSON
