Linux man中文手册的安装与使用教程

概要： 在 ubuntu 20.04 中下载、安装使用 man 中文手册。

目录- linux shell命令学习法宝 --- man 手册

• man中文手册的下载、安装及环境变量的配置

  • 下载
  • 安装
  • 环境变量配置及 cman 命令使用
• man 中文手册注意事项

linux shell命令学习法宝 --- man 手册

man 除了提供 shell 命令的帮助信息，还包括系统内核函数等帮助信息。

man 命令 使用格式如下：

# 查看命令的帮助信息
man 命令名

# 查看函数的帮助信息
man 函数名

Note: 当命令名和函数名（即上面提到的内核函数）相同时，默认查看的是命令的帮助信息，若需要查看函数的帮助信息，则加一个选项 2.即 man 2 函数名。

man 手册 功能齐备，然而全部是英文文档，若英语阅读能力不足，阅读理解存在一定困难。若每个帮助文档都用翻译软件转化后阅读也不便，因此推荐安装使用第三方的man手册中文包。

man中文手册的下载、安装及环境变量的配置

下载

man 中文手册下载地址：https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/

manpages-zh-1.5.2.tar.bz2 下载

官方下载图示：

安装

在安装包所在目录打开终端，然后输入、执行以下 shell 命令：

tar -jxvf manpages-zh-1.5.2.tar.bz2
cd manpages-zh-1.5.2
ls
./configure --disable-zhtw
make && make install

以上命令执行完毕，man中文手册已完成安装。

默认安装后的路径：/usr/local/share/man/ ，而 ubuntu 20.04 默认自带的 man 手册的位置在 /usr/share/man/。

接下来为man中文手册配置环境变量，以便在终端使用。

环境变量配置及 cman 命令使用

# 使用 vi编辑器 打开用户环境变量配置文件
vi ~/.bashrc

然后在 ~/.bashrc 文件最后添加：

# User specific environment and startup programs
alias cman='man -M /usr/local/share/man/zh_CN'
PATH=$PATH:$HOME/bin

export PATH

退出编辑模式,保存并关闭 ~/.bashrc 文件（：wq），然后终端执行 source ~/.bashrc 生效,或注销重新登录生效。

在终端 用 cman 代替 man 查看命令和函数的帮助文档：

# 查看 sleep 函数的用法
cman sleep

如果想让所有用户均可使用中文手册,环境变量配置时： 只需要将以上 ~/.bashrc 替换为 /etc/profile，用 vi编辑器打开时，使用 sudo vi /etc/profile 命令，其他步骤相同，如此操作即可。

man 中文手册注意事项

1. man 中文手册 包含 shell命令 和 系统内核函数 的帮助文档，但是并未提供 POSIX 标准函数的中文说明，如 pthread\_create(),fork() (但实际上man英文手册提供了)。
2. 如果安装了 ubuntu 20.04，在安装完整的中文语言包时，系统默认会下载安装 man 中文手册，其默认的安装路径： /usr/share/man/zh_CN 。当用 man 命令或函数名 时，系统先在 /usr/share/man/zh_CN 目录查找，如果存在，返回中文帮助文档信息；
   若不存在，再到 /usr/share/man/ 下其他文件和目录中（man 英文手册）查找，若存在，返回英文帮助文档信息；
   若不存在, 提醒不能发现。

(本文完)