# man page (简体中文)

From ArchWiki
Jump to navigation Jump to search
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.

相关文章

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

- Man7.org. Upstream for Arch Linux's man-pages.
- Debian GNU/Linux man pages
- DragonFlyBSD manual pages
- FreeBSD Hypertext Man Pages
- Linux and Solaris 10 Man Pages
- Linux/FreeBSD Man Pages[失效链接 2020-08-04 ⓘ] with user comments
- Linux man pages at die.net
- The Linux man-pages project at kernel.org
- NetBSD manual pages[失效链接 2021-05-17 ⓘ]
- Mac OS X Manual Pages[失效链接 2020-08-04 ⓘ]
- On-line UNIX manual pages
- OpenBSD manual pages
- Plan 9 Manual — Volume 1
- Inferno Manual — Volume 1
- Storage Foundation Man Pages[失效链接 2020-08-04 ⓘ]
- The Missing Man Project [dead link as of 9 July 2010]
- Gobuntu Manual Pages[失效链接 2020-08-04 ⓘ] [dead link as of 9 July 2010]
- The UNIX and Linux Forums Man Page Repository
- Ubuntu Manpage Repository

Category:

- Command-line (简体中文)

Hidden category:

- Pages with dead links