Difference between revisions of "Man page (简体中文)"

From ArchWiki
Jump to navigation Jump to search
Line 11: Line 11:
 
{{Article summary end}}
 
{{Article summary end}}
  
'''man手册页'''(manual pages,“手册”),是类UNIX系统最重要的手册工具。多数类UNIX都预装了它,这也包括Arch。使用man手册页的命令是:{{Codeline|man}}。
+
'''man手册页'''(manual pages,“手册”),是类UNIX系统最重要的手册工具。多数类UNIX都预装了它,这也包括Arch。使用man手册页的命令是:{{ic|man}}。
  
 
man手册页被设计成“自足”的文档库,即论述相关问题时无法通过类似超链接的东西引向其他手册页。GNU正努力改变原始的man手册页格式。
 
man手册页被设计成“自足”的文档库,即论述相关问题时无法通过类似超链接的东西引向其他手册页。GNU正努力改变原始的man手册页格式。
Line 34: Line 34:
 
  $ man 5 passwd
 
  $ man 5 passwd
  
会显示有关文件{{Codeline|/etc/passwd}},而非命令 {{Codeline|passwd}},的内容。
+
会显示有关文件{{ic|/etc/passwd}},而非命令 {{ic|passwd}},的内容。
  
通过{{Codeline|whatis}}命令,可以只显示需要的man手册页的简要信息。如果只是想获取对命令 ls 的简要说明,使用以下命令:
+
通过{{ic|whatis}}命令,可以只显示需要的man手册页的简要信息。如果只是想获取对命令 ls 的简要说明,使用以下命令:
  
 
  $ whatis ls
 
  $ whatis ls
Line 56: Line 56:
  
 
==搜索手册页==
 
==搜索手册页==
如果用户压根儿不知道要查阅的手册的名称,该怎么办呢?没事,通过 {{Codeline|-k}} 或者 {{Codeline|--apropos}} 参数就可以按给定关键词搜索相关手册。例如,要查阅有关密码的手册(“password”):
+
如果用户压根儿不知道要查阅的手册的名称,该怎么办呢?没事,通过 {{ic|-k}} 或者 {{ic|--apropos}} 参数就可以按给定关键词搜索相关手册。例如,要查阅有关密码的手册(“password”):
  
 
  $ man -k password
 
  $ man -k password
Line 64: Line 64:
 
  $ man --apropos password
 
  $ man --apropos password
  
还可以直接使用 {{Codeline|apropos}} 命令:
+
还可以直接使用 {{ic|apropos}} 命令:
  
 
  $ apropos password
 
  $ apropos password
Line 73: Line 73:
 
对很多人来说,彩色手册页比黑白的更加易于大脑消化吸收。
 
对很多人来说,彩色手册页比黑白的更加易于大脑消化吸收。
  
有两种常用的实现man手册页彩色显示的方法:使用 {{Codeline|most}} 或 {{Codeline|less}} (一“多”一“少”)。前者更加易于配置,但后者功能更强大。
+
有两种常用的实现man手册页彩色显示的方法:使用 {{ic|most}} 或 {{ic|less}} (一“多”一“少”)。前者更加易于配置,但后者功能更强大。
  
 
===方法一:使用most===
 
===方法一:使用most===
 
首先通过[[pacman (简体中文)|pacman]]安装{{package Official|most}}:
 
首先通过[[pacman (简体中文)|pacman]]安装{{package Official|most}}:
 
  # pacman -S most
 
  # pacman -S most
该工具类似{{Codeline|less}}和{{Codeline|more}},支持彩色化文本。
+
该工具类似{{ic|less}}和{{ic|more}},支持彩色化文本。
  
 
编辑文件{{Filename|/etc/man_db.conf}},去掉pager项的注释并修改为:
 
编辑文件{{Filename|/etc/man_db.conf}},去掉pager项的注释并修改为:
Line 90: Line 90:
 
  color underline yellow black
 
  color underline yellow black
 
  color overstrike brightblue black
 
  color overstrike brightblue black
以下示例配置{{Codeline|more}}的使用类似{{Codeline|less}}的快捷键:
+
以下示例配置{{ic|more}}的使用类似{{ic|less}}的快捷键:
 
  % less-like keybindings
 
  % less-like keybindings
 
  unsetkey "^K"
 
  unsetkey "^K"
Line 131: Line 131:
 
:<small>''来源: [http://nion.modprobe.de/blog/archives/572-less-colors-for-man-pages.html nion's blog - less colors for man pages]''</small>
 
:<small>''来源: [http://nion.modprobe.de/blog/archives/572-less-colors-for-man-pages.html nion's blog - less colors for man pages]''</small>
  
此外,还可以使用{{Codeline|less}}彩色输出man手册页。{{Codeline|less}}提供更多功能,但需要更复杂的配置,适用于高级用户。
+
此外,还可以使用{{ic|less}}彩色输出man手册页。{{ic|less}}提供更多功能,但需要更复杂的配置,适用于高级用户。
  
 
将以下内容加入shell配置文件(如[[Bash]]的是{{Filename|~/.bashrc}}):
 
将以下内容加入shell配置文件(如[[Bash]]的是{{Filename|~/.bashrc}}):
Line 162: Line 162:
 
  $ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html
 
  $ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html
  
此外,{{codeline|man2html}}还可以把man页转换为便于打印的文本文件:
+
此外,{{ic|man2html}}还可以把man页转换为便于打印的文本文件:
 
  $ man free | man2html -bare > ~/free.txt
 
  $ man free | man2html -bare > ~/free.txt
  
Line 168: Line 168:
 
  $ man -H free
 
  $ man -H free
  
由<code>BROWSER</code>环境变量决定使用的浏览器。也可以使用 {{codeline|man -Hlynx}}(H后无空格)这样的形式手动设置浏览器。
+
由<code>BROWSER</code>环境变量决定使用的浏览器。也可以使用 {{ic|man -Hlynx}}(H后无空格)这样的形式手动设置浏览器。
  
 
===使用在线手册页===
 
===使用在线手册页===

Revision as of 18:01, 12 February 2012

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Template:Article summary start Template:Article summary text Template:Article summary end

man手册页(manual pages,“手册”),是类UNIX系统最重要的手册工具。多数类UNIX都预装了它,这也包括Arch。使用man手册页的命令是:man

man手册页被设计成“自足”的文档库,即论述相关问题时无法通过类似超链接的东西引向其他手册页。GNU正努力改变原始的man手册页格式。

阅读手册页

通过以下命令阅读man手册页:

$ man 手册名

man手册页分为下面几个部分:

  1. 普通命令
  2. 内核提供的系统调用
  3. 库调用(C库函数)
  4. 特殊文件(大多在/dev目录下)和设备
  5. 文件格式规范
  6. 游戏
  7. 杂项(及其规范)
  8. 系统管理命令(通常需要root权限)和守护进程

man手册页通过名称和所属分类标识。有些不同分类的man手册页名字可能相同,比如 man(1) 和 man(7),这时需要额外指明分类以访问需要的手册。例如:

$ man 5 passwd

会显示有关文件/etc/passwd,而非命令 passwd,的内容。

通过whatis命令,可以只显示需要的man手册页的简要信息。如果只是想获取对命令 ls 的简要说明,使用以下命令:

$ whatis ls

然后会得到输出:“list directory contents.”(“列目录内容”)。

格式

所有man手册页都按照以下标准格式组织:

  • NAME - 手册叙述对象名称,及简要描述。
  • SYNOPSIS - 命令参数格式,或者函数调用格式等。
  • DESCRIPTION - 对叙述对象更加详细的描述。
  • EXAMPLES - 由浅入深的使用示例。
  • OPTIONS - 命令行或者函数调用参数的意义。
  • EXIT STATUS - 不同返回(退出)代码的含义。
  • FILES - 与叙述对象相关的文件。
  • BUGS - 已知的bug。
  • SEE ALSO - 相关内容列表。
  • AUTHOR, HISTORY, COPYRIGHT, LICENSE, WARRANTY - 历史、版权、编者信息。

搜索手册页

如果用户压根儿不知道要查阅的手册的名称,该怎么办呢?没事,通过 -k 或者 --apropos 参数就可以按给定关键词搜索相关手册。例如,要查阅有关密码的手册(“password”):

$ man -k password

或者:

$ man --apropos password

还可以直接使用 apropos 命令:

$ apropos password

关键字可以使用正则表达式。

彩色显示

对很多人来说,彩色手册页比黑白的更加易于大脑消化吸收。

有两种常用的实现man手册页彩色显示的方法:使用 mostless (一“多”一“少”)。前者更加易于配置,但后者功能更强大。

方法一:使用most

首先通过pacman安装Template:Package Official

# pacman -S most

该工具类似lessmore,支持彩色化文本。

编辑文件Template:Filename,去掉pager项的注释并修改为:

DEFINE     pager     most -s

然后测试一下吧。

通过修改Template:Filename(不存在的话请自行创建)或全局配置文件可以调整配色。例如:

% Color settings
color normal lightgray black
color status yellow blue
color underline yellow black
color overstrike brightblue black

以下示例配置more的使用类似less的快捷键:

% less-like keybindings
unsetkey "^K"
unsetkey "g"
unsetkey "G"
unsetkey ":"

setkey next_file ":n"
setkey find_file ":e"
setkey next_file ":p"
setkey toggle_options ":o"
setkey toggle_case ":c"
setkey delete_file ":d"
setkey exit ":q"

setkey bob "g"
setkey eob "G"
setkey down "e"
setkey down "E"
setkey down "j"
setkey down "^N"
setkey up "y"
setkey up "^Y"
setkey up "k"
setkey up "^P"
setkey up "^K"
setkey page_down "f"
setkey page_down "^F"
setkey page_up "b"
setkey page_up "^B"
setkey other_window "z"
setkey other_window "w"
setkey search_backward "?"
setkey bob "p"
setkey goto_mark "'"
setkey find_file "E"
setkey edit "v"

方法二:使用less

来源: nion's blog - less colors for man pages

此外,还可以使用less彩色输出man手册页。less提供更多功能,但需要更复杂的配置,适用于高级用户。

将以下内容加入shell配置文件(如Bash的是Template:Filename):

man() {
	env \
		LESS_TERMCAP_mb=$(printf "\e[1;37m") \
		LESS_TERMCAP_md=$(printf "\e[1;37m") \
		LESS_TERMCAP_me=$(printf "\e[0m") \
		LESS_TERMCAP_se=$(printf "\e[0m") \
		LESS_TERMCAP_so=$(printf "\e[1;47;30m") \
		LESS_TERMCAP_ue=$(printf "\e[0m") \
		LESS_TERMCAP_us=$(printf "\e[0;36m") \
			man "$@"
}

要调整颜色,参见:Wikipedia:ANSI escape code for reference.

使用浏览器阅读手册页

还可以通过LynxFirefox之类的浏览器阅读man手册页。由于使用浏览器,手册页可以支持超链接。

此外,KDE用户可以直接在Konqueror使用以下地址访问man手册:

man:<name>

使用本地手册页

首先,从AUR安装Template:Package AUR

然后使用它转换man手册页:

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

此外,man2html还可以把man页转换为便于打印的文本文件:

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

Arch提供的man也具有浏览器阅读功能:

$ man -H free

BROWSER环境变量决定使用的浏览器。也可以使用 man -Hlynx(H后无空格)这样的形式手动设置浏览器。

使用在线手册页

许多网站提供在线man手册页,详细列表参见:Wikipedia:Man_page#Repositories_of_manual_pages

中文man手册页

AUR中有简体、繁体中文的man手册页软件包:Template:Package AUR,提供了部分man手册的中文版本。

由于中文翻译计划已经停滞,内容可能跟不上英文版本更新。