工具介绍

        man 这个常用的命令相信大家应该都知道并且使用过吧，当你对一个命令不熟悉时，你可能要使用man来查看下针对命令的描述，相当于命令手册了，但是手册内容都是英文的，对于部分英语水平不是很高的国人来说，这是不友好的，所以 manpages-zh 产生了，它是由国人组织发起关于翻译 man 帮助命令的计划，目前已翻译大部分内容。

        对大多数现代 Linux 发行版用户来说，都可使用自带的安装工具进行一键安装，无需编译。 安装后，正常使用 man 命令即可。在您的系统设置为中文环境时， 如果有对应的中文手册页，则该手册页将显示中文版本。如系统并非中文环境，请临时调整您的环境变量以使用中文内容。

对苹果系统用户来说,并未做过充足的测试，以及没有相应的包来自动安装，所以需要编译安装。

安装成功后的命令描述信息示例如下:

以下，给出各个系统的安装步骤。

Debian/Ubuntu 安装

$ sudo apt update
$ sudo apt install manpages-zh

Arch Linux

$ pacman -Syu
$ pacman -S man-pages-zh_cn man-pages-zh_tw

Red Hat/CentOS

$ yum update
$ yum install man-pages-zh-CN

Fedora

$ dnf update
$ dnf install man-pages-zh-CN

macOS 环境安装

前提

编译工具安装

因为需要编译安装，所以你电脑上需要安装 automake 和 opencc 这两个编译工具，如果已安装，可忽略。

$ brew install automake
$ brew install opencc

解压工具安装

可选。推荐使用atool来作为压缩工具来使用，统一了所有压缩文档的命令。

$ brew install atool

安装步骤

# 进入下载目录
$ cd ~/Downloads/
# 下载最新版本的源码包
$ wget https://github.com/man-pages-zh/manpages-zh/archive/v1.6.3.3.tar.gz
# 解压源码包
$ atool -x v1.6.3.3.tar.gz
# 或者使用这个命令解压
$ tar zxvf v1.6.3.3.tar.gz
# 进入源码包文件夹
$ cd manpages-zh-1.6.3.3/
# 编译步骤 1
$ autoreconf --install --force
# 编译步骤 2
$ ./configure
# 编译步骤 3
$ sudo make
# 安装
$ sudo make install
# 配置别名
$ echo "alias cman='man -M /usr/local/share/man/zh_CN'" >> ~/.bash_profile
# 使别名生效
$ source ~/.bash_profile
# 我们就安装上了中文版本的 man 工具了，但是运行命令会发现乱码。
$ cman ls

解决中文乱码问题

中文乱码问题主要是由于主机groff 版本比较低造成的，安装新版本即可解决。

# 进入下载目录
$ cd ~/Downloads/
# 下载1.22版本的源码包
$ wget http://git.savannah.gnu.org/cgit/groff.git/snapshot/groff-1.22.tar.gz
# 解压
$ atool -x groff-1.22.tar.gz
# 进入目录
$ cd groff-1.22
# 编译安装
$ ./configure
$ sudo make
$ sudo make install
# 打开配置文件
$ sudo vim /etc/man.conf
# 进入编辑器之后，在文件末尾添加
NROFF preconv -e UTF8 | /usr/local/bin/nroff -Tutf8 -mandoc -c
# 保存退出
# 运行命令，完美解决乱码问题
$ cman ls