man page (简体中文) - ArchWiki

Jump to content

相关文章

- Color output in console#man

翻译状态：本文是 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 页面的内容。

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

- man-pages-cs for Czech
- man-pages-de for German
- man-pages-zh_cn for Simplified Chinese
- man-pages-zh_tw for Traditional Chinese

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

- 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。

- Arch manual pages—contains man pages from Arch Linux packages. Used for man page links from the wiki. You can also use the `!archman` DuckDuckGo bang to search through the Arch manual pages directly.
- man7.org—The Linux man-pages project. Upstream of the man-pages package.
- manned.org—collection from various Linux distributions, BSD, etc., with multiple package versions
- linux.die.net
- man.cx
- Debian man pages
- Ubuntu man pages
- DragonFlyBSD man pages
- FreeBSD man pages
- NetBSD man pages
- OpenBSD man pages
- Plan 9 Manual — Volume 1
- Inferno Manual — Volume 1
- The UNIX and Linux forums man page repository

Category:

- Command-line (简体中文)