如何將整個 Arch Wiki 當作 Linux 手冊頁瀏覽和閱讀

前一陣子，我寫了一篇指南，介紹如何使用名為 arch-wiki-cli 的命令行腳本，從終端瀏覽 Arch Wiki。使用這個腳本，任何人都可以輕鬆地瀏覽整個 Arch Wiki 網站，並使用你選擇的文字瀏覽器閱讀它。顯然，使用這個腳本需要有一個活躍的網際網路連線。今天，我偶然發現了一個類似的工具，名為 "Arch-wiki-man"。顧名思義，它同樣用於從命令行閱讀 Arch Wiki，但不需要網際網路連線。Arch-wiki-man 程式幫助你以 Linux man 頁面的形式瀏覽和閱讀整個 Arch Wiki。它會以 man 頁面的格式顯示 Arch Wiki 的任何文章。而且，你不需要上網就能瀏覽 Arch Wiki。整個 Arch Wiki 將會下載到本地，更新會每兩天自動推送一次。所以，你的系統上始終擁有最新的 Arch Wiki 本地副本。

安裝 Arch-wiki-man

Arch-wiki-man 可在 AUR 中取得，因此您可以使用任何 AUR 輔助程式安裝，例如 Yay。

$ yay -S arch-wiki-man

或者，也可以使用 NPM 套件管理工具安裝，如下所示。請確保你已經 安裝了 NodeJS，然後執行以下命令來安裝它：

$ npm install -g arch-wiki-man

以 Linux 手冊頁方式瀏覽和閱讀完整的 Arch Wiki

Arch-wiki-man 的典型語法是：

$ awman <search-query>

讓我給你看一些例子。

使用一個或多個匹配進行搜索

讓我們搜尋一個 Arch Linux 安裝指南。要做到這一點，只需執行：

$ awman Installation guide

上述指令將搜尋包含搜索詞「Installation guide」的 Arch Wiki 項目。如果對所給的搜索詞有多個匹配，將會出現一個選擇菜單。使用 上/下箭頭 或 Vim 風格的按鍵綁定（j/k）選擇您想閱讀的指南，然後按 ENTER 打開它。打開的指南將以類似下面的 man 頁格式顯示。

使用 Awman 從 CLI 閱讀 Arch Linux 安裝指南

這裡，awman 指的是 arch wiki man。

所有 man 指令選項皆受支援，所以你可以像閱讀 man 頁面一樣瀏覽指南。要查看幫助部分，請按 h。

若要在不輸入 man 的情況下退出選單，只需按 Ctrl+c。

要返回和/或退出，請輸入 q。

在標題和描述中搜尋匹配項

預設情況下，Awman 只會在標題中搜尋匹配項。不過，您也可以指示它同時在標題和描述中搜尋匹配項。

$ awman -d vim

或者，

$ awman --desc-search vim

在內容中搜尋匹配項

除了在標題和描述中搜尋匹配項之外，也可以掃描內容以尋找匹配項。請注意，這將顯著降低搜尋速度。

$ awman -k emacs

或者，

$ awman --apropos emacs

在網頁瀏覽器中打開搜尋結果

如果你不想以 man 頁面格式查看 Arch Wiki 指南，你可以在網頁瀏覽器中打開它。要做到這一點，請執行：

$ awman -w pacman

或者，

$ awman --web pacman

此命令將在預設的網頁瀏覽器中打開結果匹配，而不是使用 man command。請注意，使用此選項 需要網際網路連線。

以其他語言搜尋

預設情況下，Awman 將以英文打開 Arch wiki 頁面。如果你想以其他語言查看結果，例如 西班牙語，只需這樣做：

$ awman -l spanish codecs

西班牙語的 Arch Wiki

要查看可用語言選項的列表，請執行：

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

建議閱讀：

• 如何建立及維護自己的 man 頁面

資源：

• Arch-wiki-man GitHub 儲存庫