From 3aa708e9b36dced1b7fd0fb3aabbadf7e8fcb071 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 19 Oct 2018 23:23:37 +0800 Subject: [PATCH] PRF:20181015 How To Browse And Read Entire Arch Wiki As Linux Man Pages.md @dianbanjiu --- ...ead Entire Arch Wiki As Linux Man Pages.md | 70 +++++++++---------- 1 file changed, 34 insertions(+), 36 deletions(-) diff --git a/translated/tech/20181015 How To Browse And Read Entire Arch Wiki As Linux Man Pages.md b/translated/tech/20181015 How To Browse And Read Entire Arch Wiki As Linux Man Pages.md index 5237307c94..9f274b4423 100644 --- a/translated/tech/20181015 How To Browse And Read Entire Arch Wiki As Linux Man Pages.md +++ b/translated/tech/20181015 How To Browse And Read Entire Arch Wiki As Linux Man Pages.md @@ -1,21 +1,22 @@ 在 Linux 手册页中查看整个 Arch Linux Wiki ====== + ![](https://www.ostechnix.com/wp-content/uploads/2018/10/arch-wiki-720x340.jpg) -不久之前，我写了篇关于一个名叫 [**arch-wiki-cli**][1] 的命令行脚本的文章，使用它可以在终端命令行中查看整个 Arch Linux Wiki。使用这个脚本，你可以很轻松的用你喜欢的文本浏览器查看整个 Arch Wiki。显然，使用这个脚本需要你有一个好的网络环境。我今天偶然发现了一个名为 **Arch-wiki-man** 的程序，与其有着相同的功能。就跟名字说的一样，它可以让你在命令行查看 Arch Wiki，但是无需联网。它可以以手册页的形式为你显示来自 Arch Wiki 的任何文章。它会下载整个 Arch Wiki，并每两天自动推送一次。因此，你的系统上总能有一份 Arch Wiki 最新的复印件。 +不久之前，我写了篇关于一个名叫 [arch-wiki-cli][1] 的命令行脚本的文章，使用它可以在终端命令行中查看 Arch Linux Wiki。使用这个脚本，你可以很轻松的用你喜欢的文本浏览器查看整个 Arch Wiki 网站。显然，使用这个脚本需要你有网络连接。我今天偶然发现了一个名为 Arch-wiki-man 的程序，与其有着相同的功能。就跟名字说的一样，它可以让你在命令行查看 Arch Wiki，但是无需联网。它可以以手册页的形式为你显示来自 Arch Wiki 的任何文章。它会下载整个 Arch Wiki 到本地，并每两天自动推送一次。因此，你的系统上总能有一份 Arch Wiki 最新的副本。 ### 安装 Arch-wiki-man -Arch-wiki-man 在 [**AUR**][2] 中可用，所以你可以通过类似[**Yay**][3] 的 AUR 帮助程序安装它。 +Arch-wiki-man 在 [AUR][2] 中可用，所以你可以通过类似[Yay][3] 的 AUR 帮助程序安装它。 ``` - $ yay -S arch-wiki-man +$ yay -S arch-wiki-man ``` -另外，它也可以使用 NPM 安装。首先确保你已经[**安装了 NoodJS**][4]，然后使用以下命令安装它。 +另外，它也可以使用 NPM 安装。首先确保你已经[安装了 NoodJS][4]，然后使用以下命令安装它。 ``` - $ npm install -g arch-wiki-man +$ npm install -g arch-wiki-man ``` ### 以手册页的形式查看整个 Arch Wiki @@ -23,83 +24,83 @@ Arch-wiki-man 在 [**AUR**][2] 中可用，所以你可以通过类似[**Yay**][ Arch-wiki-man 的典型语法如下： ``` - $ awman +$ awman ``` 下面看一些具体的例子： -**搜索一个或多个匹配项** +#### 搜索一个或多个匹配项 -只需要下面的命令，就可以搜索 [**Arch Linux 安装指南**][5]。 +只需要下面的命令，就可以搜索 [Arch Linux 安装指南][5]。 ``` - $ awman Installation guide +$ awman Installation guide ``` -上面的命令将会从 Arch Wiki 中搜索所有包含 “安装指南” 的条目。如果对于给出的搜索条目有很多的匹配项，将会展示为一个选择菜单。使用 **上下键** 或是 Vim 风格的方向键（**j/k**），移动到你想查看的指南上，点击回车打开。然后就会像下面这样，以手册页的形式展示指南的内容。 +上面的命令将会从 Arch Wiki 中搜索所有包含 “Installation guide” 的条目。如果对于给出的搜索条目有很多的匹配项，将会展示为一个选择菜单。使用上下方向键或是 Vim 风格的方向键（`j`/`k`），移动到你想查看的指南上，点击回车打开。然后就会像下面这样，以手册页的形式展示指南的内容。 ![][6] awman 指的是 arch wiki man 的首字母组合。 -它支持手册页的所有操作，所以你可以像使用手册页一样使用它。按 **h** 查看帮助选项。 +它支持手册页的所有操作，所以你可以像使用手册页一样使用它。按 `h` 查看帮助选项。 ![][7] -退出选择菜单不需要输入**man**，只需要按 **Ctrl+c**。 +要退出选择菜单而不显示手册页，只需要按 `Ctrl+c`。 -输入 **q** 返回或者/并且退出手册页。 +输入 `q` 返回或者/并且退出手册页。 -**在标题或者概述中搜索匹配项** +#### 在标题或者概述中搜索匹配项 -Awman 默认只会在标题中搜索匹配项。但是你也可以指定它同时在标题和概述中搜索匹配项。 +awman 默认只会在标题中搜索匹配项。但是你也可以指定它同时在标题和概述中搜索匹配项。 ``` - $ awman -d vim +$ awman -d vim ``` -或者, +或者， ``` - $ awman --desc-search vim +$ awman --desc-search vim ``` -**在目录中搜索匹配项** +#### 在目录中搜索匹配项 -不同于在标题和概述中搜索匹配项，它也能够扫描整个目录达到匹配的目的。不过请注意，这样将会使搜索进程明显变慢。 +不同于在标题和概述中搜索匹配项，它也能够扫描整个内容以匹配。不过请注意，这样将会使搜索进程明显变慢。 ``` - $ awman -k emacs +$ awman -k emacs ``` -或者, +或者， ``` - $ awman --apropos emacs +$ awman --apropos emacs ``` -**在 web 浏览器中打开搜索结果** +#### 在 web 浏览器中打开搜索结果 如果你不想以手册页的形式查看 Arch Wiki 指南，你也可以像下面这样在 web 浏览器中打开它。 ``` - $ awman -w pacman +$ awman -w pacman ``` -或者, +或者， ``` - $ awman --web pacman +$ awman --web pacman ``` 这条命令将会在 web 浏览器中打开匹配结果。请注意，使用这个选项需要网络连接。 -**在其他语言中搜索** +#### 在其他语言中搜索 -Awman 默认打开的是英文的 Arch Wiki 页面。如果你想用其他的语言查看搜索结果，例如 **西班牙语**，只需要像这样做： +awman 默认打开的是英文的 Arch Wiki 页面。如果你想用其他的语言查看搜索结果，例如西班牙语，只需要像这样做： ``` - $ awman -l spanish codecs +$ awman -l spanish codecs ``` ![][8] @@ -107,12 +108,10 @@ Awman 默认打开的是英文的 Arch Wiki 页面。如果你想用其他的语 使用以下命令查看可用的语言： ``` - - $ awman --list-languages - +$ awman --list-languages ``` -**升级本地的 Arch Wiki复印件** +#### 升级本地的 Arch Wiki 副本 就像我已经说过的，更新会每两天自动推送一次。或者你也可以使用以下命令手动更新。 @@ -127,7 +126,6 @@ arch-wiki-md-repo has been successfully updated or reinstalled. ：） - -------------------------------------------------------------------------------- via: https://www.ostechnix.com/how-to-browse-and-read-entire-arch-wiki-as-linux-man-pages/ @@ -135,7 +133,7 @@ via: https://www.ostechnix.com/how-to-browse-and-read-entire-arch-wiki-as-linux- 作者：[SK][a] 选题：[lujun9972][b] 译者：[dianbanjiu](https://github.com/dianbanjiu) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出