Mac 10.13 安装中文版 man 命令

为什么需要 man 以及 man 怎么使用

linux 或者 mac 系统的命令行工具非常多,可是我们不能记住所有的这些命令,通常只能记住一些我们常用的。遇到不常用的我们需要来查询一下这个命令是怎么使用的。这时候我们就需要使用到 man 命令了。

使用方法也非常简单,例如我们不清楚 ls 这个命令的使用方法,我们就可以在命令行中输入

1
man ls

来查看这个命令的详情。

但是默认情况下,输出的内容是英文的。可能很多英文不好的朋友希望有中文版本的 man ,这篇博文就是告诉大家,如何在 mac 上安装中文版本的的 man。

至于 linux 系统则非常简单,查看 https://github.com/man-pages-zh/manpages-zh 中对应的版本,即可用简单的命令安装。

下载 manpages-zh 编辑安装

首先,我们打开上面的 github 地址,点击 releases 下载最新版本的 tar.gz 源码包。目前我下载到的是 1.6.3.2 版本的。

因为需要编译安装,所以你电脑上需要有编译工具,运行下面两个命令安装

1
2
brew install automake
brew install opencc

我这边是需要安装这两个编译工具,如果你下面编译出错,会提示你需要安装说明编辑工具的。利用 brew 安装即可。

如果你电脑没有安装 brew 工具,请参考 http://blog.csdn.net/FungLeo/article/details/57567538 这篇博文安装

好,准备工作做好,我们接着来。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 进入下载目录
cd ~/Downloads/
# 下载最新版本的源码包
wget https://github.com/man-pages-zh/manpages-zh/archive/v1.6.3.2.tar.gz
# 解压源码包(atool命令,推荐安装这个工具,统一所有压缩文档的命令)
atool -x v1.6.3.2.tar.gz
# 或者使用这个命令解压
tar zxvf v1.6.3.2.tar.gz
# 进入源码包文件夹
cd manpages-zh-1.6.3.2/
# 编译安装 1
autoreconf --install --force
# 编译安装 2
./configure
# 编译安装 3
make
# 编译安装 4
sudo make install
# 配置别名
echo "alias cman='man -M /usr/local/share/man/zh_CN'" >> ~/.bash_profile
# 使别名生效
. ~/.bash_profile

这样,我们就安装上了中文版本的 man 工具了。我们可以使用

1
cman ls

来查看中文版本的解释了。但是由于 mac 上的 groff 工具比较老,所以中文会出现乱码。我们来解决一下这个问题。

安装 groff 新版本解决中文乱码的问题

首先,我们到 http://git.savannah.gnu.org/cgit/groff.git 这个页面下载 1.22 版本的 groff 安装包。我这边用命令行下载,你如果直接复制我的命令,不能下载,请到上面的地址去看看下载地址是否发生变化。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 进入下载目录
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

进入编辑之后,在文件末尾添加

1
NROFF preconv -e UTF8 | /usr/local/bin/nroff -Tutf8 -mandoc -c

最后 :wq保存退出

然后,我们在输入

1
cman ls