标签 TLDR 下的文章

Tealder 是 Rust 版本的 tldr,对常用的命令提供了易于理解的说明信息。

 title=

手册页是我开始探索 Linux 时最常用的资源。当然,对于初学者熟悉命令行指令而言,man 是最频繁使用的指令。但是手册页中有大量的选项和参数列表,很难被解读,这使得你很难理解你想知道的东西。如果你想要一个更简单的解决方案,有基于例子的输出,我认为 tldr 太长不读 too long dnot's read )是最好的选择。

Tealdeer 是什么?

Tealdeer 是 tldr 的一个基于 Rust 的实现。它是一个社区驱动的手册页,给出了非常简单的命令工作原理的例子。Tealdeer 最棒的地方在于它几乎包含了所有你通常会用到的命令。

安装 Tealdeer

在 Linux 系统,你可以从软件仓库安装 Tealdeer,比如在 Fedora 上:

$ sudo dnf install tealdeer

在 macOS 可以使用 MacPorts 或者 Homebrew。 同样,你可以使用 Rust 的 Cargo 包管理器来编译和安装此工具:

$ cargo install tealdeer

使用 Tealdeer

输入 tldr-list 返回 tldr 所支持的手册页,比如 touchtardnfdockerzcatzgrep 等:

$ tldr --list
2to3
7z
7za
7zr
[
a2disconf
a2dismod
a2dissite
a2enconf
a2enmod
a2ensite
a2query
[...]

使用 tldr 跟上具体的命令(比如 tar )能够显示基于示例的手册页,描述了你可以用该命令做的所有选项。

$ tldr tar

  Archiving utility.
  Often combined with a compression method, such as gzip or bzip2.
  More information: <https://www.gnu.org/software/tar>.

  [c]reate an archive and write it to a [f]ile:

      tar cf target.tar file1 file2 file3

  [c]reate a g[z]ipped archive and write it to a [f]ile:

      tar czf target.tar.gz file1 file2 file3

  [c]reate a g[z]ipped archive from a directory using relative paths:

      tar czf target.tar.gz --directory=path/to/directory .

  E[x]tract a (compressed) archive [f]ile into the current directory [v]erbosely:

      tar xvf source.tar[.gz|.bz2|.xz]

  E[x]tract a (compressed) archive [f]ile into the target directory:

      tar xf source.tar[.gz|.bz2|.xz] --directory=directory

  [c]reate a compressed archive and write it to a [f]ile, using [a]rchive suffix to determine the compression program:

      tar caf target.tar.xz file1 file2 file3

如需控制缓存:

$ tldr --update
$ tldr --clear-cache

你能够控制 Tealdeer 输出的颜色选项,有三种模式选择:一直、自动、从不。默认选项是自动,但我喜欢颜色提供的额外信息,所以我在我的 ~/.bashrc文件中增加了这个别名:

alias tldr='tldr --color always'

结论

Tealdeer 的美妙之处在于不需要网络连接就可以使用,只有更新缓存的时候才需要联网。因此,即使你处于离线状态,依然能够查找和学习你新学到的命令。更多信息,请查看该工具的 说明文档

你会使用 Tealdeer 么?或者你已经在使用了?欢迎留言让我们知道。


via: https://opensource.com/article/21/6/tealdeer-linux

作者:Sudeshna Sur 选题:lujun9972 译者:ddl-hust 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

这一标题可能看起来很粗略且吸睛。请允许我解释一下我在本教程中将要阐释的内容。假设你想下载一个压缩文件,将其解压缩,并从命令行中将文件从一个位置移动到另一个位置。根据上面的场景,我们可能需要至少三个 Linux 命令,一个用于下载文件,一个用于提取下载的文件,一个用于移动文件。如果你是中高级 Linux 用户,你可以通过一行命令或脚本在几秒钟/分钟内轻松完成这一任务。但是,如果你是一个不懂得太多 Linux 命令的菜鸟你可能就需要一些帮助了。

当然,谷歌的快速搜索可能会找到很多结果。或者,你可以使用 手册页。但是有些手册页实在很长,很全面,但缺少有用的示例。当你在特定的标志/选项上寻找特定的信息时,你可能需要向下检索相当长的时间。值得庆幸的是,有一些 好的手册页替代品,它们主要关注于实用的命令。一个很好的选择是 TLDR 手册。使用 TLDR 手册,我们可以通过实际示例快速轻松地学习一个 Linux 命令。要使用 TLDR 手册,我们需要 TLDR 客户端。有很多客户。今天我们就来了解一个这样的客户端,名为 “Tldr++”

Tldr++ 是一个快速和交互式的 Tldr 客户端,用 Go 编程语言编写。与其他 Tldr 客户端不同,它是完全交互式的。这意味着,你可以选择一个命令,读取所有示例,并立即运行任何命令,而不必在终端中重新键入或复制/粘贴每个命令。还是不明白?没有问题。请继续阅读,以便动态学习和实践 Linux 命令。

安装 Tldr++

安装 Tldr++ 非常简单。从 发布页面 下载 Tldr++ 最新版本。解压它并将 Tldr++ 二进制文件移动到你的 $PATH 中。

$ wget https://github.com/isacikgoz/tldr/releases/download/v0.5.0/tldr_0.5.0_linux_amd64.tar.gz
$ tar xzf tldr_0.5.0_linux_amd64.tar.gz
$ sudo mv tldr /usr/local/bin
$ sudo chmod +x /usr/local/bin/tldr

现在,运行 tldr 二进制代码将 TLDR 手册部署到本地系统中。

$ tldr

示例输出:

Enumerating objects: 6, done.
Counting objects: 100% (6/6), done.
Compressing objects: 100% (6/6), done.
Total 18157 (delta 0), reused 3 (delta 0), pack-reused 18151
Successfully cloned into: /home/sk/.local/share/tldr

Tldr++ 可以在 AUR 中使用。如果你使用 Arch Linux 上,你可以使用任何 AUR 助手来安装它,例如 YaY。确保你已经从系统中删除了任何现有的 TLDR 客户端,并运行以下命令安装 Tldr++。

$ yay -S tldr++

或者,你也可以像下面描述的那样从源代码进行编译。因为 Tldr++ 是用 Go 语言编写的,所以请确保你 Linux 系统中已经安装了 Go 语言。如果还没有安装,请参考下面的指南。

在安装好 Go 语言之后, 运行以下的命令来安装 Tldr++。

$ go get -u github.com/isacikgoz/tldr

该命令在当前工作目录中下载 tldr 代码库中的内容并存储到 go 文件夹中。

现在,运行 tldr 二进制代码将 TLDR 手册部署到本地系统中。

$ go/bin/tldr

示例输出:

最后,将 tldr 二进制文件复制到你的路径中。

$ sudo mv tldr /usr/local/bin

现在是时候看一些例子了。

Tldr++ 用法

输入不带任何选项的 tldr 命令,以字母顺序显示所有命令示例。

使用 向上/向下箭头 来浏览命令,键入任何字母来搜索或键入命令名称来查看相应命令的示例。 ? 以浏览更多消息,按 Ctrl+c 返回/退出。

要显示特定命令的示例命令,例如 apt,可以这样做:

$ tldr apt

从列表中选择任意示例命令并按回车键。在选定的命令前会看到一个 * 符号。例如,我选择第一个命令即 sudo apt update。现在,它会问你是否继续。如果命令正确,只需键入 y 继续,并输入 sudo 密码运行所选命令。

看到了吗?你不需要在终端中复制/粘贴或键入实际的命令。只需从列表中选择它,并极速运行!

Tldr 手册中有数百个 Linux 命令示例。你可以每天选择一个或两个命令,并彻底学习它们。每天坚持这样的练习,尽可能多的掌握。

使用 Tldr++ 动态学习和实践 Linux 命令

现在回到我在第一段中提到的场景。你需要下载一个文件,将其解压缩并将其移动到不同的位置,并使其可执行。让我们看看如何使用 Tldr++ 客户端进行交互。

第一步 – 从网上下载文件

要使用命令行下载文件,我们主要使用 curlwget 命令。让我使用 wget 下载文件。要打开 wget 命令的 TLDR 页面,只需执行以下命令:

$ tldr wget

下面是 wget 命令的示例。

你可以使用 向上/向下箭头 来浏览命令列表。一旦你选择了你所选择的命令,按回车键。这里我选择了第一个命令。

现在,输入路径来下载文件。

然后将要求你确认该命令是否正确。如果命令正确,只需键入 yesy 就可以开始下载文件。

我们已经下载了文件。让我们继续解压这个文件。

第二步 – 解压已下载的文件

我们下载了 tar.gz 文件。所以我将打开 TLDR 手册的 tar 页面。

$ tldr tar

你将看到示例命令列表。浏览这些示例,找出哪个命令适合提取 tar.gz(gzip 格式)文件,按回车键。在我们的例子中,它是第三个命令。

现在,系统将提示你输入 tar.gz 文件的路径。只需输入路径并按回车键。Tldr++ 支持智能文件提示。这意味着它会在你键入时自动补全文件名。只需按 TAB 键自动完成。

如果将文件下载到其他位置,只需键入完整路径,例如 /home/sk/Downloads/tldr_0.5.0_linux_amd64.tar.gz

输入要解压的文件的路径后,按回车键,然后输入 y 进行确认。

第三步 – 将文件从一个目录移动到另一个目录

我们解压了文件。现在我们需要将文件移动到另一个位置。为了将文件从一个位置移动到另一个位置,我们使用 mv 命令。所以,让我们打开 TLDR 手册的 mv 命令。

$ tldr mv

选择正确的命令将文件从一个位置移动到另一个位置。在我们的例子中,第一个命令可以工作,所以让我们选中它。

输入要移动的文件路径,并输入目标路径并按回车键。

附注: 输入 y!yes! 来以 sudo 权限运行命令。

正如你在上面的截图中看到的,我将名为 `tldr的文件移动到/usr/local/bin/

要了解更多细节,请参考项目最后给出的 GitHub 页面。

总结

别误会,毫无疑问 手册页 是伟大的!但是,正如我已经说过的,许多手册页都很全面,缺少有用的示例。我不可能记住带有复杂标志的冗长的所有命令。有时,我花了很多时间在手册页上,却还是一窍不通。Tldr 手册帮助我在几分钟内找到了我需要的东西。而且,我们偶尔会使用一些命令,然后就会完全忘记它们。另一方面,Tldr 手册实际上在使用那些使用率很低的命令时很有帮助。Tldr++ 客户端通过智能的用户交互使这个任务变得更容易。试试吧,在下面的评论区告诉我们你对这个工具的看法。

(LCTT 译注:我们也开发了一个 TLDR 客户端,是基于微信小程序的,大家在微信中搜索“Linux”小程序即可找到。虽然微信小程序版的 TLDR 客户端不能像这个客户端一样实际运行 Linux,但是它是中文的,而且中文翻译是由使用者来贡献和修正的。顺便说一句,全部一千多个命令已经翻译完毕,感谢我们的贡献者们! )

以上,更多的好的分享将会陆续推出,请继续保持关注!

祝好!


via: https://www.ostechnix.com/search-study-and-practice-linux-commands-on-the-fly/

作者:SK 选题:lujun9972 译者:qfzy1233 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

一个月前,我们发布了一个小程序“Linux”,可以用来快速查找 Linux 中的命令常用语法。这个小程序中我们收录了上千条 Linux 命令(严格地说,几乎包含了 Unix/BSD 乃至于 OSX 等的全部命令)。该小程序的数据来源于国外的一个著名开源项目:tldr.sh,其项目托管于 GitHub

这个小程序在推出前并没有特别周密的产品设计,我们在推出后,对这个产品进行了频繁的打磨和改进。几乎每天都会发布新的更新版本。甚至连小程序的 Logo 都换了两次。现在是这个:

Linux 小程序 Logo

这一个月来,这个小程序得到了大家的踊跃支持,很多命令都得到了大家的翻译贡献。应该说,这个小程序寄托着我们的一个实验性想法:我们希望提供一种众包式的机制,可以使大家可以利用碎片式时间来为开源文档提供碎片式的翻译。大家可能知道,我们的翻译组 LCTT 采用了和一些国际化翻译平台及其它一些开源翻译组织不同的模式,我们通常要求一个译者完成全篇文章的翻译,而非按段落切分,这样可以保证全文的质量和用语稳定。但是,这种模式在我们试图翻译 man 手册时遇到了困难——这可能是文章类和手册类的内容性质不同所造成的。

通过这次的实验,我们发现这种模式在对手册类的内容进行翻译还是有效的。因此,我们接下来会推出针对 man 手册的小程序,会同样采用这种众包方式进行翻译。

当然,在某个条目/手册的翻译成熟后,我们会将其推送会上游,以使更多人受惠。

这一个月来,这个小程序得到了八千多人的使用,一百多位贡献者实际参与了翻译贡献,其中贡献最高的“Datura stramonium L.”一个人就提交了 646 条翻译!

下面我来总结一下这一个月来我们的“Linux”小程序的改进要点:

  • 除了可以搜索命令名之外,还可以按描述搜索命令
  • 贡献排行榜
  • 首页随机推荐命令,显示最新更新动态
  • 显示风格调整
  • 强化贡献者呈现
  • 增加了命令的延伸阅读文章
  • 增加了中英文切换显示功能

接下来,我们计划进行如下改进:

  • 对命令页面中的占位符进行特殊渲染
  • 标定某个页面的翻译成熟,可以推送到上游
  • 添加评论框,以发表评论和丰富用法示例
  • 添加更新提示消息——当你编辑过的消息被再次更新,你可以收到提醒

最后,欢迎大家都来体验一下“Linux”小程序:

Linux 小程序码

学习和使用 Linux 时,你是否觉得 Linux 命令的 man 手册过于冗长,不能及时告诉你所需要的命令该怎么写?其实,遇到这种苦恼的不是你一个人,往往在你突然想不起某个命令参数时,你需要的就是一个简单的命令提示。所以,针对这种情况,有人开发出了 info 命令来补充丰富的命令案例,也有人觉得 man 手册实在太长了,开发出了 tldr (太长不看)命令来提供更简洁的最常用命令用法。

就如我们之前介绍过的,tldr 有很多客户端,支持命令行、Web、iOS、安卓等等。

经过一个春节的开发,在“编码使我快乐”的 Bestony 同学的努力下,我们基于 tldr 的数据推出了一款小程序版的 tldr,并且考虑到现有 tldr 数据以英文为主,还提供了由社区驱动的开放式翻译模式来改进内容。

下面我来介绍一下。

Linux 命令速查小程序

请用微信识别如下小程序码,找到小程序 “Linux” ——没错,这个名字就是这么直指人心 :D,你也可以在本公众号的菜单中找到它。此外,以后我们也会在推送的文章中,对出现的 Linux 命令直接链接其这个小程序。

扫描或长按识别

首页就是一个简洁的输入框,显然,输入你要查找的命令就行。目前我们已经收录了 TLDR 数据库中上千条命令的数据。

Linux 命令速查小程序 首页

Linux 命令速查 ls 页面

开放式翻译贡献

你可以看到,命令页面的下方,列出了对该页面做出了翻译贡献的贡献者头像。

这其中大部分命令还没有进行翻译。你可以长按待翻译的文本,跳到翻译输入页面。在输入框中,可以输入新的翻译。第一次提交会请求你的微信授权,只是为了显示你的名字和头像。

提交翻译贡献

下方还列出了历次翻译的历史,所以你的贡献是所有人都看得到的 —— 切勿胡乱提交。输入翻译提交之后,会返回该命令页面,你可以下拉该页面强制刷新,即可看到翻译效果。

为什么采用开放式翻译贡献模式呢?我们希望社区的项目,由社区来驱动,通过社区的自我进化能力来完善。这也是我们为之后的社区驱动项目做一个尝试。

希望这个触手可及的小程序可以帮到你。好了,这篇 TLDR 的文章就这么短吧~

最后,致谢 TLDR 项目,感谢 Bestony。另外,能够快速开发此小程序也要感谢腾讯云开发所提供的快捷开发支持。

在终端上使用各种命令执行重要任务是 Linux 桌面体验中不可或缺的一部分。Linux 这个开源操作系统拥有丰富的命令,任何用户都无法全部记住所有这些命令。而使事情变得更复杂的是,每个命令都有自己的一组带来丰富的功能的选项。

为了解决这个问题,人们创建了 手册页 man page ,(手册 —— man 是 manual 的缩写)。首先,它是用英文写成的,包含了大量关于不同命令的深入信息。有时候,当你在寻找命令的基本信息时,它就会显得有点庞杂。为了解决这个问题,人们创建了TLDR 页

什么是 TLDR 页?

TLDR 页的 GitHub 仓库将其描述为简化的、社区驱动的手册页集合。在实际示例的帮助下,努力让使用手册页的体验变得更简单。如果还不知道,TLDR 取自互联网的常见俚语: 太长没读 Too Long Didn’t Read

如果你想比较一下,让我们以 tar 命令为例。 通常,手册页的篇幅会超过 1000 行。tar 是一个归档实用程序,经常与 bzipgzip 等压缩方法结合使用。看一下它的手册页:

tar man page

而另一方面,TLDR 页面让你只是浏览一下命令,看看它是如何工作的。 tar 的 TLDR 页面看起来像这样,并带有一些方便的例子 —— 你可以使用此实用程序完成的最常见任务:

tar tldr page

让我们再举一个例子,向你展示 TLDR 页面为 apt 提供的内容:

tldr-page-of-apt

如上,它向你展示了 TLDR 如何工作并使你的生活更轻松,下面让我们告诉你如何在基于 Linux 的操作系统上安装它。

如何在 Linux 上安装和使用 TLDR 页?

最成熟的 TLDR 客户端是基于 Node.js 的,你可以使用 NPM 包管理器轻松安装它。如果你的系统上没有 Node 和 NPM,请运行以下命令:

sudo apt-get install nodejs
sudo apt-get install npm 

如果你使用的是 Debian、Ubuntu 或 Ubuntu 衍生发行版以外的操作系统,你可以根据自己的情况使用yumdnfpacman包管理器。

现在,通过在终端中运行以下命令,在 Linux 机器上安装 TLDR 客户端:

sudo npm install -g tldr 

一旦安装了此终端实用程序,最好在尝试之前更新其缓存。 为此,请运行以下命令:

tldr  --update 

执行此操作后,就可以阅读任何 Linux 命令的 TLDR 页面了。 为此,只需键入:

tldr  <commandname> 

tldr kill command

你还可以运行其帮助命令,以查看可与 TLDR 一起使用的各种参数,以获取所需输出。 像往常一样,这个帮助页面也附有例子。

TLDR 的 web、Android 和 iOS 版本

你会惊喜地发现 TLDR 页不仅限于你的 Linux 桌面。 相反,它也可以在你的 Web 浏览器中使用,可以从任何计算机访问。

要使用 TLDR Web 版本,请访问 tldr.ostera.io 并执行所需的搜索操作。

或者,你也可以下载 iOSAndroid 应用程序,并随时随地学习新命令。

tldr app ios

你觉得这个很酷的 Linux 终端技巧很有意思吗? 请尝试一下,让我们知道您的反馈。


via: https://fossbytes.com/tldr-pages-linux-man-pages-alternative/

作者:Adarsh Verma 译者:wxy 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出