man page

出自 Arch Linux 中文维基

man 手冊頁,指 "manual pages",是類 UNIX 系統的標準手冊工具,Arch 也不例外。顯示 man 手冊頁的命令是:man

man手冊頁被設計成獨立的文檔,不能引用其它手冊頁面。這與支持超連結的 Info 文檔形成鮮明對比,GNU正在將 man 手冊替換成 info 文檔。

安裝[編輯 | 編輯原始碼]

man-db 提供了 man 命令,lessman 的默認分頁器。

man-pages 提供了 Linux man 頁面的內容。

下面是一些語言的翻譯版本:

下面程序也可以用來閱讀手冊:

  • GNOME HelpGNOME 幫助閱讀程序。 通過 yelp man:<name>Ctrl+L 快捷鍵閱讀手冊頁面。
https://wiki.gnome.org/Apps/Yelp || yelp
  • KHelpCenterKDE 幫助閱讀程序,可以通過 khelpcenter man:<name> 閱讀手冊。
https://userbase.kde.org/KHelpCenter || khelpcenter
  • Konqueror — KDE 文件和網頁瀏覽器,也可以通過 man:<name> 顯示手冊。
https://konqueror.org/ || konqueror
  • xman — 可以分類查看手冊。
https://xorg.freedesktop.org/ || xorg-xman

閱讀手冊頁[編輯 | 編輯原始碼]

通過以下命令閱讀man手冊頁:

$ man 手册名

man手冊頁分為很多段落。完整的列表可以參考: man-pages(7).

man手冊頁通過名稱和所屬分類標識。有些不同分類的man手冊頁名字可能相同,比如 man(1) 和 man(7),這時需要額外指明分類以訪問需要的手冊。例如:

$ man 5 passwd

會顯示有關文件/etc/passwd,而非命令 passwd,的內容。

搜索手冊頁[編輯 | 編輯原始碼]

如果用户壓根兒不知道要查閱的手冊的名稱,該怎麼辦呢?沒事,通過 -k 或者 --apropos 參數就可以按給定關鍵詞搜索相關手冊。例如,要查閱有關密碼的手冊(「password」):

關鍵詞搜索特性是從一個專用的緩存生成的。默認情況下你沒有這個緩存,所以無論你搜什麼,都會提示你nothing appropriate。你可以通過下面的命令來生成這個緩存:

# mandb

每當你安裝新的manpage之後都需要運行這個命令,緩存才會更新。

現在你可以開始搜索了。 例如,要查閱有關密碼的手冊(「password」),可以使用下面的命令:

$ man -k password
$ man --apropos password
$ apropos password

關鍵字可以使用正則表達式。

如果你想全文搜索的話,你可以用-K選項:

$ man -K password

通過whatis命令,可以只顯示需要的man手冊頁的簡要信息。如果只是想獲取對命令 ls 的簡要説明,使用以下命令:

$ whatis ls
ls (1p)              - list directory contents
ls (1)               - list directory contents

使用瀏覽器閱讀手冊頁[編輯 | 編輯原始碼]

還可以通過 lynxFirefox之類的瀏覽器閱讀man手冊頁。由於使用瀏覽器,手冊頁可以支持超連結。

此外,KDE用户可以直接在Konqueror使用以下地址訪問man手冊:

man:<name>

轉換為 HTML[編輯 | 編輯原始碼]

man2html[編輯 | 編輯原始碼]

首先,安裝軟件包man2html

然後使用它轉換man手冊頁:

$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

此外,man2html還可以把man頁轉換為便於打印的文本文件:

$ man free | man2html -bare > ~/free.txt

man -H[編輯 | 編輯原始碼]

man-db提供的man也具有瀏覽器閱讀功能:

$ man -H free

BROWSER環境變量決定使用的瀏覽器。也可以使用 man -Hlynx(H後無空格)這樣的形式手動設置瀏覽器。

轉換為 PDF[編輯 | 編輯原始碼]

man pages 是可以打印的,遵循 troff 格式,本來就是一種打印設置語言,安裝 ghostscript 後,可以用下面命令將 man 頁面轉換為 PDF man -t <manpage> | ps2pdf - <pdf>.

注意這裏僅能使用 Times 字體,沒有超連結,有些手冊是轉為終端設計,PS 或 PDF 格式看起來不太正常。

使用在線手冊頁[編輯 | 編輯原始碼]

許多網站提供在線man手冊頁,詳細列表參見:Wikipedia:Man_page#Repositories_of_manual_pages