Mac系统安装man命令中文文档

man是类unix系统最重要的手册工具，安装中文文档有助于我们更好的了解命令行下的各个指令。

man中文文档下载地址，可以在页面中找到最新的manpages稳定版本进行下载，这里以 1.5.1 的安装进行举例：

安装

下载安装包

wget https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/manpages-zh/manpages-zh-1.5.1.tar.gz

解压

tar xf manpages-zh-1.5.1.tar.gz

安装

cd manpages-zh-1.5.1
# 不需要繁体中文版本
./configure --disable-zhtw 
make && make install

在执行./configure成功后看到如下信息：

manpages-zh configure summary
=============================
UTF-8 : true
zh_CN : true
zh_TW : false

配置alias

在用户目录中编辑~/.bash_profile，添加一个cman别名，添加上如下命令

alias cman='man -M /usr/local/share/man/zh_CN'

如果你是用了 zsh，那么可以在~/.zshrc中写入上面的命令

至此，cman命令已经安装完成，但是当我们执行cman git命令时，什么鬼？ 全是乱码，如下：

git(1)                                                                                     git(1)



NAME
       git - GNU aoxaoa.Ya.
 _
e ae3
       git [options] [path1] [path2]
       gitps [options]
       gitview [options] filename


ae3"ae                                       _                            _  _
       GIT  a  c_ a,>>e|  ec1/2(R)aea>>9|  ae_  .gitrc.TERM , ecec TERM ae  c acae 'TERM' c a1/4.
       a3/4a|, a 1ao Linux aeSa9|ao, a1/2 c c ac a,  ae  c+->>a1/41/4  'TERM=console'  c  aa(R)1,
       a aex _ec1/2(R)aea>>9|a  ae   .gitrc.console.   a1/2  e1/2ax (a1aoe Y) a,o a1/2cc"c ae a,a
       c>>c<< c+->>a e(R)3/4c1/2(R) a,a,a ec1/2(R)aea>>9|.


aeeco        _
       git ae  a.ae aeao shell ae1/2c aea>>9|c3>>c>>aeueSa" , a1/2c a.Ya1/2 ae'a(R)1ae a1ae'aeae.

接下来我们就需要解决中文乱码问题。

解决中文乱码

因为mac系统默认的groff版本比较老，所以我们需要更新下，这里是用brew命令安装

升级groff

brew install homebrew/dupes/groff
brew link homebrew/dupes/groff

配置man.conf

修改前建议备份原文件

编辑/etc/man.conf文件。

• 搜索NROFF，替换为

NROFF preconv -e utf8 | /usr/local/bin/groff -Wall -mtty-char -Tutf8 -mandoc -c

• 搜索PAGER，替换为

PAGER /usr/bin/less -isR

再看 cman git 命令

git(1)                               General Commands Manual                               git(1)



NAME
       git - GNU 交互工具

语法
       git [options] [path1] [path2]
       gitps [options]
       gitview [options] filename


注意
       GIT  包 的 主要 配置文件 是 .gitrc.TERM , 这里的 TERM 是 环境变量 'TERM' 的 值. 例如, 对于
       Linux 控制台, 你的 环境 中 有 类似 'TERM=console' 的 内容, 因此 配置文件名 是  .gitrc.con‐
       sole.  你 能够 (也应该) 为 使用的 每个 终端类型 设置 一个 配置文件.


描述
       git 是 具有 某些 shell 功能的 文件系统浏览器 , 使 工作 更容易 也更有效.

Yeah, How cool~