man page (简体中文)

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

相关文章

翻译状态：本文是 Man page 的翻译。上次翻译日期：2020-06-29。如果英文版本有所更改，则您可以帮助同步翻译。

man 手册页，指 "manual pages"，是类 UNIX 系统的标准手册工具，Arch 也不例外。显示 man 手册页的命令是：man。

man手册页被设计成独立的文档，不能引用其它手册页面。这与支持超链接的 Info 文档形成鲜明对比，GNU正在将 man 手册替换成 info 文档。

安装

man-db 提供了 man 命令，less 是 man 的默认分页器。

man-pages 提供了 Linux man 页面的内容。

下面是一些语言的翻译版本:

下面程序也可以用来阅读手册:

  • GNOME Help — GNOME 帮助阅读程序。 通过 yelp man:<name> 或 Ctrl+L 快捷键阅读手册页面。
https://wiki.gnome.org/Apps/Yelp || yelp
  • KHelpCenter — KDE 帮助阅读程序，可以通过 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

使用浏览器阅读手册页

还可以通过 lynx或Firefox之类的浏览器阅读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

Arch提供的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。