Arch-Wiki-Man：一個以 Linux Man 手冊樣式離線瀏覽 Arch Wiki 的工具

Prakash Subramanian發表於2019-04-08

Linux

現在上網已經很方便了，但技術上會有限制。看到技術的發展，我很驚訝，但與此同時，各種地方也都會出現衰退。

當你搜尋有關其他 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 的文章。

$ yaourt -S arch-wiki-man

或

$ packer -S arch-wiki-man

或者，我們可以使用 npm 包管理器來安裝它，確保你已經在你的系統上安裝了 NodeJS。然後執行以下命令來安裝它。

$ 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 來獲取更新。

$ yaourt -S arch-wiki-man

或

$ packer -S arch-wiki-man

如何在終端中使用 Arch Wiki ？

它有著簡易的介面且易於使用。想要搜尋，只需要執行 awman 加搜尋專案。一般語法如下所示。

$ awman Search-Term

如何搜尋多個匹配項？

如果希望列出包含 “installation” 字串的所有結果的標題，執行以下格式的命令，如果輸出有多個結果，那麼你將會獲得一個選擇選單來瀏覽每個專案。

$ awman installation

詳細頁面的截圖：

在標題和描述中搜尋給定的字串

-d 或 --desc-search 選項允許使用者在標題和描述中搜尋給定的字串。

$ 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 頁面的內容。

$ 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 瀏覽器中開啟搜尋結果。

$ awman -w AUR helper

或

$ 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

使用你的首選語言執行 awman 命令以檢視除英語以外的其他語言的結果。