Arch-Wiki-Man：一个以 Linux Man 手册样式离线浏览 Arch Wiki 的工具

现在上网已经很方便了，但技术上会有限制。看到技术的发展，我很惊讶，但与此同时，各种地方也都会出现衰退。

当你搜索有关其他 Linux 发行版的某些东西时，大多数时候你会得到的是一个第三方的链接，但是对于 Arch Linux 来说，每次你都会得到 Arch Wiki 页面的结果。

因为 Arch Wiki 提供了除第三方网站以外的大多数解决方案。

到目前为止，你也许可以使用 Web 浏览器为你的 Arch Linux 系统找到一个解决方案，但现在你可以不用这么做了。

一个名为 arch-wiki-man 的工具提供了一个在命令行中更快地执行这个操作的方案。如果你是一个 Arch Linux 爱好者，我建议你阅读 Arch Linux 安装后指南，它可以帮助你调整你的系统以供日常使用。

arch-wiki-man 是什么？

arch-wiki-man 工具允许用户从命令行（CLI）中离线搜索 Arch Wiki 页面。它允许用户以 Linux Man 手册样式访问和搜索整个 Wiki 页面。

而且，你无需切换到 GUI。更新将每两天自动推送一次，因此，你的 Arch Wiki 本地副本页面将是最新的。这个工具的名字是 awman， awman 是 “Arch Wiki Man” 的缩写。

我们之前写过一篇类似工具 Arch Wiki 命令行实用程序（arch-wiki-cli）的文章。这个工具允许用户从互联网上搜索 Arch Wiki。但你需要在线使用这个实用程序。

如何安装 arch-wiki-man 工具？

arch-wiki-man 工具可以在 AUR 仓库（LCTT 译注：AUR 即 Arch 用户软件仓库 Arch User Repository ）中获得，因此，我们需要使用 AUR 工具来安装它。有许多 AUR 工具可用，而且我们曾写了一篇关于流行的 AUR 辅助工具： Yaourt AUR helper 和 Packer AUR helper 的文章。

1	`$ yaourt -S arch-wiki-man`

或

1	`$ packer -S arch-wiki-man`

或者，我们可以使用 npm 包管理器来安装它，确保你已经在你的系统上安装了 NodeJS。然后运行以下命令来安装它。

1	`$ npm install -g arch-wiki-man`

如何更新 Arch Wiki 本地副本？

正如前面更新的那样，更新每两天自动推送一次，也可以通过运行以下命令来完成更新。

$ sudo awman-update
[sudo] password for daygeek:
[email protected] /usr/lib/node_modules/arch-wiki-man
└── [email protected]

arch-wiki-md-repo has been successfully updated or reinstalled.

awman-update 是一种更快、更方便的更新方法。但是，你也可以通过运行以下命令重新安装 arch-wiki-man 来获取更新。

1	`$ yaourt -S arch-wiki-man`

或

1	`$ packer -S arch-wiki-man`

如何在终端中使用 Arch Wiki ？

它有着简易的接口且易于使用。想要搜索，只需要运行 awman 加搜索项目。一般语法如下所示。

1	`$ awman Search-Term`

如何搜索多个匹配项？

如果希望列出包含 “installation” 字符串的所有结果的标题，运行以下格式的命令，如果输出有多个结果，那么你将会获得一个选择菜单来浏览每个项目。

1	`$ awman installation`

详细页面的截屏：

在标题和描述中搜索给定的字符串

-d 或 --desc-search 选项允许用户在标题和描述中搜索给定的字符串。

1	`$ awman -d mirrors`

或

$ awman --desc-search mirrors
? Select an article: (Use arrow keys)
❯ [1/3] Mirrors: Related articles
  [2/3] DeveloperWiki-NewMirrors: Contents
  [3/3] Powerpill: Powerpill is a pac

在内容中搜索给定的字符串

-k 或 --apropos 选项也允许用户在内容中搜索给定的字符串。但须注意，此选项会显著降低搜索速度，因为此选项会扫描整个 Wiki 页面的内容。

1	`$ awman -k openjdk`

或

$ awman --apropos openjdk
? Select an article: (Use arrow keys)
❯ [1/26] Hadoop: Related articles
 [2/26] XDG Base Directory support: Related articles
 [3/26] Steam-Game-specific troubleshooting: See Steam/Troubleshooting first.
 [4/26] Android: Related articles
 [5/26] Elasticsearch: Elasticsearch is a search engine based on Lucene. It provides a distributed, mul..
 [6/26] LibreOffice: Related articles
 [7/26] Browser plugins: Related articles
(Move up and down to reveal more choices)

在浏览器中打开搜索结果

-w 或 --web 选项允许用户在 Web 浏览器中打开搜索结果。

1	`$ awman -w AUR helper`

或

1	`$ awman --web AUR helper`

以其他语言搜索

想要查看支持的语言列表，请运行以下命令。

$ awman --list-languages
arabic
bulgarian
catalan
chinesesim
chinesetrad
croatian
czech
danish
dutch
english
esperanto
finnish
greek
hebrew
hungarian
indonesian
italian
korean
lithuanian
norwegian
polish
portuguese
russian
serbian
slovak
spanish
swedish
thai
ukrainian