From 7321ffff43a4526596d05199e4aac00f003c3e9f Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Sun, 11 Jul 2021 20:47:11 +0800 Subject: [PATCH] PRF @ddl-hust --- ...eplace man pages with Tealdeer on Linux.md | 82 ++++++++++--------- 1 file changed, 43 insertions(+), 39 deletions(-) diff --git a/translated/tech/20210621 Replace man pages with Tealdeer on Linux.md b/translated/tech/20210621 Replace man pages with Tealdeer on Linux.md index 4b43fbc8de..c00b821d11 100644 --- a/translated/tech/20210621 Replace man pages with Tealdeer on Linux.md +++ b/translated/tech/20210621 Replace man pages with Tealdeer on Linux.md @@ -2,40 +2,42 @@ [#]: via: (https://opensource.com/article/21/6/tealdeer-linux) [#]: author: (Sudeshna Sur https://opensource.com/users/sudeshna-sur) [#]: collector: (lujun9972) -[#]: translator: (ddl-hust ) -[#]: reviewer: ( ) +[#]: translator: (ddl-hust) +[#]: reviewer: (wxy) [#]: publisher: ( ) [#]: url: ( ) -在Linux上使用Tealdeer 替代 man 手册 +在 Linux 上使用 Tealdeer 替代手册页 ====== -Tealder 是 Rust 版本的tldr(too long dnot's read),对常用的命令提供了易于理解的说明信息。 -![computer screen ][1] +> Tealder 是 Rust 版本的 tldr,对常用的命令提供了易于理解的说明信息。 -Man 手册是我开始探索Linux时最常用的资源。当然,对于初学者熟悉命令行指令而言,`man` 是最频繁使用的指令。但是 man 手册有大量的选项和参数列表,很难被解码,这使得你很难理解你想知道的东西。如果你想要一个更简单的解决方案,有基于例子的输出,我认为[tldr][2]是最好的选择。 +![](https://img.linux.net.cn/data/attachment/album/202107/11/204638catii1ro21jmjzmi.jpg) -### Tealdeer是什么? +手册页是我开始探索 Linux 时最常用的资源。当然,对于初学者熟悉命令行指令而言,`man` 是最频繁使用的指令。但是手册页中有大量的选项和参数列表,很难被解读,这使得你很难理解你想知道的东西。如果你想要一个更简单的解决方案,有基于例子的输出,我认为 [tldr][2] (太长不读too long dnot's read)是最好的选择。 -[Tealdeer][3]是基于Rust,对tldr的一个很好的实现。它是一个社区驱动的手册页,给出了非常简单的命令工作原理的例子。Tealdeer最棒的地方在于它几乎包含了所有你通常会用到的命令。 +### Tealdeer 是什么? -### 安装Tealdeer +[Tealdeer][3] 是 tldr 的一个基于 Rust 的实现。它是一个社区驱动的手册页,给出了非常简单的命令工作原理的例子。Tealdeer 最棒的地方在于它几乎包含了所有你通常会用到的命令。 -在 Linux 系统,你可以从软件仓库安装 Tealdeer ,比如在on [Fedora][4]上: +### 安装 Tealdeer + +在 Linux 系统,你可以从软件仓库安装 Tealdeer,比如在 [Fedora][4] 上: ``` -`$ sudo dnf install tealdeer` +$ sudo dnf install tealdeer ``` -在 macOS 使用[ MacPorts ][5] 或者 [ Homebrew ][6]. + +在 macOS 可以使用 [MacPorts][5] 或者 [Homebrew][6]。 同样,你可以使用 Rust 的 Cargo 包管理器来编译和安装此工具: ``` -`$ cargo install tealdeer` +$ cargo install tealdeer ``` + ### 使用 Tealdeer -输入 `tldr-list` 返回 tldr 所支持的书册,比如` touch`, `tar`, `dnf`, `docker`, `zcat`, `zgrep `等; - +输入 `tldr-list` 返回 tldr 所支持的手册页,比如 `touch`、`tar`、`dnf`、`docker`、`zcat`、`zgrep` 等: ``` $ tldr --list @@ -53,56 +55,58 @@ a2ensite a2query [...] ``` -使用 `tldr` 接具体的命令(比如 `tar` )能够显示基于案例的手册页,描述了你可以用该命令做的所有选项。 + +使用 `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\>][7]. + Archiving utility. + Often combined with a compression method, such as gzip or bzip2. + More information: . -  [c]reate an archive and write it to a [f]ile: + [c]reate an archive and write it to a [f]ile: -      tar cf target.tar file1 file2 file3 + tar cf target.tar file1 file2 file3 -  [c]reate a g[z]ipped archive and write it to a [f]ile: + [c]reate a g[z]ipped archive and write it to a [f]ile: -      tar czf target.tar.gz file1 file2 file3 + tar czf target.tar.gz file1 file2 file3 -  [c]reate a g[z]ipped archive from a directory using relative paths: + [c]reate a g[z]ipped archive from a directory using relative paths: -      tar czf target.tar.gz --directory=path/to/directory . + tar czf target.tar.gz --directory=path/to/directory . -  E[x]tract a (compressed) archive [f]ile into the current directory [v]erbosely: + E[x]tract a (compressed) archive [f]ile into the current directory [v]erbosely: -      tar xvf source.tar[.gz|.bz2|.xz] + tar xvf source.tar[.gz|.bz2|.xz] -  E[x]tract a (compressed) archive [f]ile into the target directory: + E[x]tract a (compressed) archive [f]ile into the target directory: -      tar xf source.tar[.gz|.bz2|.xz] --directory=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: + [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 + tar caf target.tar.xz file1 file2 file3 ``` -控制缓存: +如需控制缓存: ``` -    $ tldr --update -    $ tldr --clear-cache +$ tldr --update +$ tldr --clear-cache ``` -你能够控制 Tealdeer 输出的颜色选项,有三种模式选择:总是,自动,从不。默认选项是自动,但我喜欢颜色提供的额外信息,所以我在我的`~/.bashrc `文件中增加了这个别名 +你能够控制 Tealdeer 输出的颜色选项,有三种模式选择:一直、自动、从不。默认选项是自动,但我喜欢颜色提供的额外信息,所以我在我的 `~/.bashrc `文件中增加了这个别名: ``` -`alias tldr='tldr --color always'` +alias tldr='tldr --color always' ``` ### 结论 -Tealdeer 的美妙之处在于不需要网络连接就可以使用,只有更新缓存的时候才需要联网。因此,即使你处于离线状态,依然能够查找和学习你新学到的命令。更多信息,请查看该工具的[说明文档][8]。 -你会使用 Tealdeer么?或者你已经在使用了?欢迎留言让我们知道。 +Tealdeer 的美妙之处在于不需要网络连接就可以使用,只有更新缓存的时候才需要联网。因此,即使你处于离线状态,依然能够查找和学习你新学到的命令。更多信息,请查看该工具的 [说明文档][8]。 + +你会使用 Tealdeer 么?或者你已经在使用了?欢迎留言让我们知道。 -------------------------------------------------------------------------------- @@ -111,7 +115,7 @@ via: https://opensource.com/article/21/6/tealdeer-linux 作者:[Sudeshna Sur][a] 选题:[lujun9972][b] 译者:[ddl-hust](https://github.com/ddl-hust) -校对:[校对者ID](https://github.com/校对者ID) +校对:[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出