在 Linux 手冊頁中檢視整個 Arch Linux Wiki | Linux 中國

不久之前，我寫了篇關於一個名叫 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 幫助程式安裝它。

$ yay -S arch-wiki-man

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

$ npm install -g arch-wiki-man

以手冊頁的形式檢視整個 Arch Wiki

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

$ awman <search-query>

下麵看一些具體的例子：

搜尋一個或多個匹配項

只需要下麵的命令，就可以搜尋 Arch Linux 安裝指南[5]。

$ 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.