document/TranslateProject
2
0
Fork 0
mirror of https://github.com/LCTT/TranslateProject.git synced 2025-01-25 23:11:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

PRF

Browse Source 
@ddl-hust
This commit is contained in:
Xingyu Wang 2021-07-11 20:47:11 +08:00
parent 4e418bf9d0
commit 7321ffff43
1 changed files with 43 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
translated/tech/20210621 Replace man pages with Tealdeer on Linux.md
View File

@ -2,40 +2,42 @@
[#]: via: (https://opensource.com/article/21/6/tealdeer-linux) [#]: via: (https://opensource.com/article/21/6/tealdeer-linux)
[#]: author: (Sudeshna Sur https://opensource.com/users/sudeshna-sur) [#]: author: (Sudeshna Sur https://opensource.com/users/sudeshna-sur)
[#]: collector: (lujun9972) [#]: collector: (lujun9972)
[#]: translator: (ddl-hust ) [#]: translator: (ddl-hust)
[#]: reviewer: ( ) [#]: reviewer: (wxy)
[#]: publisher: ( ) [#]: publisher: ( )
[#]: url: ( ) [#]: url: ( )
在Linux上使用Tealdeer 替代 man 手册 在 Linux 上使用 Tealdeer 替代手册页
====== ======
Tealder 是 Rust 版本的tldr(too long dnot's read)，对常用的命令提供了易于理解的说明信息。 > Tealder 是 Rust 版本的 tldr，对常用的命令提供了易于理解的说明信息。
![computer screen ][1]
Man 手册是我开始探索Linux时最常用的资源。当然，对于初学者熟悉命令行指令而言，`man` 是最频繁使用的指令。但是 man 手册有大量的选项和参数列表，很难被解码，这使得你很难理解你想知道的东西。如果你想要一个更简单的解决方案，有基于例子的输出，我认为[tldr][2]是最好的选择。 ![](https://img.linux.net.cn/data/attachment/album/202107/11/204638catii1ro21jmjzmi.jpg)
### Tealdeer是什么? 手册页是我开始探索 Linux 时最常用的资源。当然，对于初学者熟悉命令行指令而言，`man` 是最频繁使用的指令。但是手册页中有大量的选项和参数列表，很难被解读，这使得你很难理解你想知道的东西。如果你想要一个更简单的解决方案，有基于例子的输出，我认为 [tldr][2] （<ruby>太长不读<rt>too long dnot's read</rt></ruby>）是最好的选择。
[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 包管理器来编译和安装此工具: 同样，你可以使用 Rust 的 Cargo 包管理器来编译和安装此工具:
``` ```
`$ cargo install tealdeer` $ cargo install tealdeer
``` ```
### 使用 Tealdeer ### 使用 Tealdeer
输入 `tldr-list` 返回 tldr 所支持的书册，比如` touch`, `tar`, `dnf`, `docker`, `zcat`, `zgrep `等; 输入 `tldr-list` 返回 tldr 所支持的手册页，比如 `touch`、`tar`、`dnf`、`docker`、`zcat`、`zgrep` 等：
``` ```
$ tldr --list $ tldr --list
@ -53,56 +55,58 @@ a2ensite
a2query a2query
[...] [...]
``` ```
使用 `tldr` 接具体的命令（比如 `tar` ）能够显示基于案例的手册页，描述了你可以用该命令做的所有选项。
使用 `tldr` 跟上具体的命令（比如 `tar` ）能够显示基于示例的手册页，描述了你可以用该命令做的所有选项。
``` ```
$ tldr tar $ tldr tar
  Archiving utility. Archiving utility.
  Often combined with a compression method, such as gzip or bzip2. Often combined with a compression method, such as gzip or bzip2.
  More information: &lt;[https://www.gnu.org/software/tar\&gt;][7]. More information: <https://www.gnu.org/software/tar>.
  [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 --update
    $ tldr --clear-cache $ 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] 作者：[Sudeshna Sur][a]
选题：[lujun9972][b] 选题：[lujun9972][b]
译者：[ddl-hust](https://github.com/ddl-hust) 译者：[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/) 荣誉推出 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出