man中文手册

admin

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

man中文手册的下载、安装及环境变量的配置
下载
man 中文手册下载地址：https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/




manpages-zh-1.5.2.tar.bz2 下载
https://src.fedoraproject.org/re ... es-zh-1.5.2.tar.bz2



安装

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

[C++] 纯文本查看 复制代码

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 命令使用

[C++] 纯文本查看 复制代码

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

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

[C++] 纯文本查看 复制代码

# 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 查看命令和函数的帮助文档：

[C++] 纯文本查看 复制代码

# 查看 sleep 函数的用法
cman sleep

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

[C++] 纯文本查看 复制代码

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

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