在 Linux 手冊頁中查看整個 Arch Linux Wiki

不久之前，我寫了篇關於一個名叫 arch-wiki-cli 的命令行腳本的文章，使用它可以在終端命令行中查看 Arch Linux Wiki。使用這個腳本，你可以很輕鬆的用你喜歡的文本瀏覽器查看整個 Arch Wiki 網站。顯然，使用這個腳本需要你有網路連接。我今天偶然發現了一個名為 Arch-wiki-man 的程序，與其有著相同的功能。就跟名字說的一樣，它可以讓你在命令行查看 Arch Wiki，但是無需聯網。它可以以手冊頁的形式為你顯示來自 Arch Wiki 的任何文章。它會下載整個 Arch Wiki 到本地，並每兩天自動推送一次。因此，你的系統上總能有一份 Arch Wiki 最新的副本。

安裝 Arch-wiki-man

Arch-wiki-man 在 AUR 中可用，所以你可以通過類似Yay 的 AUR 幫助程序安裝它。

$ yay -S arch-wiki-man

另外，它也可以使用 NPM 安裝。首先確保你已經安裝了 NoodJS，然後使用以下命令安裝它。

$ npm install -g arch-wiki-man

以手冊頁的形式查看整個 Arch Wiki

Arch-wiki-man 的典型語法如下：

$ awman <search-query>

下面看一些具體的例子：

搜索一個或多個匹配項

只需要下面的命令，就可以搜索 Arch Linux 安裝指南。

$ awman Installation guide

上面的命令將會從 Arch Wiki 中搜索所有包含 「Installation guide」 的條目。如果對於給出的搜索條目有很多的匹配項，將會展示為一個選擇菜單。使用上下方向鍵或是 Vim 風格的方向鍵（j/k），移動到你想查看的指南上，點擊回車打開。然後就會像下面這樣，以手冊頁的形式展示指南的內容。

awman 指的是 arch wiki man 的首字母組合。

它支持手冊頁的所有操作，所以你可以像使用手冊頁一樣使用它。按 h 查看幫助選項。

要退出選擇菜單而不顯示手冊頁，只需要按 Ctrl+c。

輸入 q 返回或者/並且退出手冊頁。

在標題或者概述中搜索匹配項

awman 默認只會在標題中搜索匹配項。但是你也可以指定它同時在標題和概述中搜索匹配項。

$ awman -d vim

或者，

$ awman --desc-search vim

在目錄中搜索匹配項

不同於在標題和概述中搜索匹配項，它也能夠掃描整個內容以匹配。不過請注意，這樣將會使搜索進程明顯變慢。

$ awman -k emacs

或者，

$ awman --apropos emacs

在 web 瀏覽器中打開搜索結果

如果你不想以手冊頁的形式查看 Arch Wiki 指南，你也可以像下面這樣在 web 瀏覽器中打開它。

$ awman -w pacman

或者，

$ awman --web pacman

這條命令將會在 web 瀏覽器中打開匹配結果。請注意，使用這個選項需要網路連接。

在其他語言中搜索

awman 默認打開的是英文的 Arch Wiki 頁面。如果你想用其他的語言查看搜索結果，例如西班牙語，只需要像這樣做：

$ awman -l spanish codecs

使用以下命令查看可用的語言：

$ awman --list-languages

升級本地的 Arch Wiki 副本

就像我已經說過的，更新會每兩天自動推送一次。或者你也可以使用以下命令手動更新。

$ awman-update
arch-wiki-man@1.3.0 /usr/lib/node_modules/arch-wiki-man
└── arch-wiki-md-repo@0.10.84

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/

作者：SK 選題：lujun9972 譯者：dianbanjiu 校對：wxy

本文由 LCTT 原創編譯，Linux中國 榮譽推出

本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive