man的用法及打造中文man手册

linux系统管理 struggling 1891次浏览 0个评论

新人刚开始学习linux时,需要学习很多命令的用法,用man命令是必不可少的,所以man的用法必须要知道,为了更好的帮助大家入门,博主从网上整理了关于man的中文用法设置以及man的一些用法,详细的请看下面:
一.man用法的详解
Linux的man手册共有以下几个章节:

<code>
  代号	             代表內容                                                  官方文档中的说明                                                            
   1	           用者在shell中可以操作的指令或可执行档                              标准命令                                                
   2	           系統核心可呼叫的函数与工具等                                       系统调用                                                    
   3	           一些常用的函数与函数库,大部分是C的函数库(libc)                      库函数
   4	           装置档案的说明,通常在/dev下的档案                                 设备说明                                                 
   5	           设定档或者是某些档案的格式                                         文件格式                                                      
   6	           游戏(games)                                                     游戏和娱乐                                                                     
   7               惯例与协定等,例如Linux档案系统、网络协定、ASCII code等等的說明        杂项
   8	           系統管理員可用的管理指令                                           管理员命令                                                        
   9	           跟kernel有关的文件                                                其他       </code>
<code>
查看命令包含在那几个章节,可以使用以下命令:

man -f  +comd相当于 whatis  +comd

当输入 man ls,它会在最左上角显示“LS(1)”,在这里,“LS”表示手册名称,而“(1)”表示该手册位于第一节章,其他标题含义如下:
    NAME                        :命令/函数功能的解释
    SYNOPSIS                    :命令/函数用法简单 概述
    DESCRIPTION                : 命令/函数的详细说明
    REPORTING BUGS              :报告的错误
    COPYRIGHT                   :版权
    SEE ALSO                    :可以参照其他的相关命令/函数</code>

man的一些参数:

<code>
-C config_file:指定设定文件man.conf,缺省值是/etc/man.conf。
-M path:指定了联机手册的搜寻路径, 如果没有指定则使用环境变数MANPATH的设定;如果没有使用 MANPATH,则会使用/usr/lib/man.conf内的设定;如果MANPATH是空字串,则表示使用缺省值。
-P pager:指定使用何种pager.man会优先使用此选项设定,然后是依环境变数MANPAGER设定,然后是环境变数PAGER;man缺省使用/usr/bin/less
-is。
-S section_list man:所搜寻的章节列表(以冒号分隔),此选项会覆盖环境变数MANSECT的设定。
-a man:缺省情况是在显示第一个找到的手册之后,就会停止搜寻,使用此选项会强迫man继续显示所有符合name的联机手册。
-c:即使有最新的cat page,也继续对联机手册重新作排版,本选项在屏幕的行列数改变时或已排版的联机手册损坏时特别有意义。
-d:不要真的显示联机手册,只显示除错讯息。
-D:同时显示联机手册与除错讯息。
-h:显示求助讯息然后结束程式 。
-K:对所有的联机手册搜寻所指定的字串。请注意,本功能回应速度可能很慢,如果指定section(区域)会对速度有帮助。
-m system:依所指定的system名称而指定另一组的联机手册。</code>

二.打造中文man手册

博主在网上找到了几种man的中文用法,望大家借鉴。

<code>

1.直接下载的一个man离线手册:

下载链接

2.设置中文man的在线手册,个人感觉这个不是多好的,有好多命令没有中文的:

先下载好以下文件

下载链接

[root@localhost ~]$ echo $LANG
zh_CN.GB2312

如果不是:通过 export LANG=zh_CN.GB2312

如果你发现上面执行不通过,你可以运行:locale -a 查一下你系统支持的字符集

[root@localhost~]$ cd ~                                     #进入当前目录
[root@localhost ~]$ mkdir -p man/zh_CN           #建立目录man 以及子目录zh_CN
[root@localhost ~]$ tree  man                             #目录以及子目录已经可以了,现在只需要将压缩包解压到zh_CN 中文目录即可
man
`-- zh_CN
[root@localhost ~]$ tar -xzvf manpages-zh-1.5.tar.gz               #......解压数据包
manpages-zh-1.5/src/mann/expr.n
manpages-zh-1.5/src/mann/fblocked.n
manpages-zh-1.5/src/mann/fconfigure.n
manpages-zh-1.5/src/mann/fcopy.n
manpages-zh-1.5/src/mann/file.n
manpages-zh-1.5/src/mann/fileevent.n
manpages-zh-1.5/src/mann/filename.n
manpages-zh-1.5/src/mann/flush.n
manpages-zh-1.5/src/mann/focusNext.n
manpages-zh-1.5/src/mann/for.n
manpages-zh-1.5/src/mann/foreach.n
 
[root@localhost ~]$ cd manpages-zh-1.5
[root@localhost manpages-zh-1.5]$ ls   #该目录结构 支持make安装的,可以通过make命令生成编译文件,也可以直接复制里面src目录安装
 
COPYING  debian  DOCS  Makefile  man-pages-zh_CN.spec  raw  README  README.GB  src  utils

[root@localhost manpages-zh-1.5]$ make  #已经生成了:UTF-8目录下面文件,只需要将该目录复制到~/man/zh_CN下面即可
mkdir UTF-8
cp -r src/man* UTF-8/

[root@localhost manpages-zh-1.5]$ cp -r UTF-8/* ~/man/zh_CN/   

通过上面几步已经将帮助手册安装到自己的工作目录下面的man/zh_CN下面了

下面检查下,看man中文手册是否加入到man路径里面了。

[root@localhost manpages-zh-1.5]$ man -w
/usr/kerberos/man:/usr/local/share/man:/usr/share/man/zh_CN:/usr/share/man:/home/chengmo/man/zh_CN:/home/chengmo/man:/usr/local/man
#发现已经在MANPATH路径加入了:/home/chengmo/man 以及:/home/chengmo/man/zh_CN
 
 
[root@localhost ~]$ man -aw passwd
/usr/share/man/man1/passwd.1.gz
/usr/share/man/man5/passwd.5.gz
/home/chengmo/man/zh_CN/man5/passwd.5
#发现已经找到中文手册了
 
[root@localhost ~]$ man 5 -aw passwd
/usr/share/man/man5/passwd.5.gz
/home/chengmo/man/zh_CN/man5/passwd.5
#读取领域5限定类型,这样系统原先的英文也保留了,看中英文也很方便
 
 
[root@localhost ~]$ man 5 -a passwd
#显示英文的,按q就会出来中文文档了



</code>

DevOps-田飞雨 》》转载请注明源地址
喜欢 (1)or分享 (0)
发表我的评论
取消评论
*

表情 贴图 加粗 链接 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址