MacOS/Linux 配置中文man手册

因为要短时间内学习linux开发，但是之前只会一些简单的linux命令，也知道用man去查看帮助手册，但是因为是英文，想要看的很自如还是得花点时间。所以就想着配置下中文的man手册。但是又不想放弃英文的man手册，故分开中文用cman命令，英文用man命令，这样后期有时间，也可以多看看英文版的，因为大佬说想要学好总是依靠中文是不行的，英文文献难啃也要啃，不可避免的。

MacOS下安装

编译工具安装

$ brew install automake
$ brew install opencc

安装

# 进入下载目录
$ cd ~/Downloads/
# 下载最新版本的源码包
$ wget https://github.com/man-pages-zh/manpages-zh/archive/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
# 编译安装 4
$ sudo make install
# 配置别名（如果是 zsh 对应处理即可）
$ 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
# 解压
$ tar zxvf groff-1.22.tar.gz
# 进入目录
$ cd groff-1.22
# 编译安装
$ ./configure
$ sudo make
$ sudo make install
# 打开配置文件
$ sudo vim /etc/man.conf
...
#修改NROFF配置如下（将UTF8编码的MAN页面通过转码而被groff识别）
#line 94
NROFF preconv -e utf8 | /usr/local/bin/groff -Wall -mtty-char -Tutf8 -mandoc -c  
...
#修改PAGER配置如下（这样可以避免MAN手册页面中的ANSI Escape字符序列干扰（用于控制显示粗体等格式））
#line 105
PAGER /usr/bin/less -isR
...
# 保存退出
# 运行命令，完美解决乱码问题
cman ls

以下就是上述命令成功之后cman ls的截图，已经变成中文啦。

cman_ls_中文界面.png

不过你man ls还是英文的哦，是不是很方便呢。