不久之前,我寫了篇關於一個名叫 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
[email protected] /usr/lib/node_modules/arch-wiki-man
└── [email protected]

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

:)


via: ostechnix.com/how-to-br

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

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


推薦閱讀:
查看原文 >>
相关文章