tldr.py: 妈妈再也不用担心我使用命令行了

[xvid73]

tldr.py 实际上是 tldr 的一个命令行程序，帮助你快速查看命令的常用用法。tldr 是什么呢？按照官方的说法：

Simplified and community-driven man pages.

也就是说，是精简版的 man 。相比大而全的 man ， tldr 是把常用和命令和选项提炼了出来方便你使用。之前也有一个很火的项目: the-art-of-command-line, 它的介绍是:

Master the command line, in one page

tldr 现在已经有很多大家贡献的命令，或许有些没有，或许有些不够好，这也许是一个诟病。但是不用担心，因为你完全可以自己总结，使用并维护自己的那一份，感觉不错的也可以去官方 repo 提个 PR 分享一下。当然，这是方便使用而已，需要深入使用或者其他场景使用的，那就使用 man 吧。

---

下面说说这个 tldr.py ， 具体的安装和初始化工作这里不再赘述，请前往 github 了解更为详细的说明

具体日常的使用, 比如说想知道 du 这个命令的常用用法,

$ tldr find du

Estimate file space usage

- get a sum of the total size of a file/folder in human readable units

  du -sh {{file/directory}}

- list file sizes of a directory and any subdirectories in KB

  du -k {{file/directory}}

- get recursively, individual file/folder sizes in human readable form

  du -ah {{directory}}

- list the KB sizes of directories for N levels below the specified directory

  du --max-depth=1

当然，实际上的显示是有颜色的，你也可以在配置文件中自行修改调整。基本的使用就是这样。

---

详细的用法和说明都在 github 上。

• github: tldr.py

有问题和新的想法可以提。有兴趣的试用一下吧~期待测试回馈和使用感受
就酱。

[jukka]

其实很多人看不懂 man 不是因为长，是因为英文不好。

[MCVector]

@jukka 我觉得 man 的可读性确实不高，相对于 HowTo 文档。

[jiang42]

@jukka 看不懂有啥办法呢-。-反正我是因为太长不想看

[SharkIng]

cheat 是不是也一样这功能？

[imn1]

man 对我来说更多不是英文，而是完全没有例子，很多命令要自己试
但有部分命令是不能试的，一试可能会很惨

[iambic]

这个跟 cheat 有什么区别呢？

[iambic]

就是这个项目
https://github.com/chrisallenlane/cheat

[hqs123]

一堆鸡肠看不懂感觉楼主很厉害...

[xiaket]

顺着这个 thread 说句, 个人觉得没有耐心读完 man 的人不太适合做技术工作...

[xvid73]

@iambic 噗，之前我不知道这个项目 _(:3
粗看了下，要是说区别的话， tldr 是只提供 man page ，对应的其他语言的客户端是其他开发者开发的， cheat 则自身有 cli 的同时还附带了默认的 man page 。看了下项目的起始时间， cheat 要稍微要早点。两者的思想基本是差不多的，都是提供简化常用的命令说明，但是 tldr 更注重提供原始的 man page ，把 man page 和具体实现剥离开来，开发其他平台和不同语言的都可以使用它。个人看法是这样。

[demo]

没有 cheat 反应快

[joshz]

@xiaket 不大赞同，你如果没看过书，直接从 man page 学的，那我无话可说。但很显然大部分人都是通过书籍来度过最难过的入门阶段才可能去关注具体某个命令的个别参数的。把 man page 当 api 文档都挺难看，更别说通过这个来学习 shell 。重要的是 example 太少。

[joshz]

不过 man page 维护者写的书 Linux programming interface 口碑爆棚，很奇怪，可能是定位问题。

[xvid73]

@demo 是说敲好命令后的反应么？ tldr.py 是使用本地的文件的，应该速度不会太慢的，基本都没有延迟这种感觉的吧。求详细说明。

[demo]

@xvid73 很明显就感觉得到，你在 shell 里试试：

tldr :

t1=`date +%s`;s1=`tldr tar`;t2=`date +%s`;echo ${t1}'\n'${t2};

cheat :

t3=`date +%s`;s2=`cheat tar`;t4=`date +%s`;echo ${t3}'\n'${t4};

[xvid73]

@demo 我这里的测试情况都是 1 秒之内的。
另外， tldr.py 的命令是 `tldr find tar` 而不是 `tldr tar`。之前已经有过一个 python 版本的叫做 tldr ，它是直接发请求的。 tldr.py 是使用本地文件的，命令执行速度理论上应该察觉不到延迟。
你是在用 tld.py 么 _(:3

[xvid73]

@demo 准确来说， tldr.py 的确要比 cheat 速度慢，但是这个级别是在 0.05 秒左右，对于一般用户来说使用时是感觉不到速度差别的吧。 _(:3

[kamushin]

赞

[kamushin]

@xiaket
不,我觉得这个和 man 不冲突. 我们既需要大辞典也需要小词典不是么?
有时候 man 里选项多的实在不想去看. 而有些选项是重要的, 有些选项则几乎用不到.

[wyf88]

我也感觉反应速度好慢，然后发现要联网才能使用，只有我是这样吗？我是用 homebrew 安装的。