MAC 系统中显示中文MAN手册

October 25, 2013

最近在做中文MAN手册的翻译，发现MAC系统中的MAN命令不能像多数Linux发行版那样很好的显示中文MAN手册。

根据查找的资料，找到了解决方法：

1、首先要更新你的系统中的 groff 包，MAC中（10.8和10.9）的groff是1.18，是几年的版本了，需要升级，可以下载最新的groff 1.22 编译或者通过 port 来安装。

2、需要修改MAN的配置文件：

sudo vi /private/etc/man.conf

修改NROFF配置为：

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

这样就可以将UTF8编码的MAN页面通过转码而被groff识别。

修改PAGER配置为：

PAGER /usr/bin/less -isR

这样可以避免MAN手册页面中的ANSI Escape字符序列干扰（用于控制显示粗体等格式）

保存即可。

顺便，也说下如何彩色显示MAN的方法。

在环境变量中增加如下：

export GROFF_NO_SGR=1
export LESS_TERMCAP_mb=$'\E[01;36m'
export LESS_TERMCAP_md=$'\E[01;36m'
export LESS_TERMCAP_me=$'\E[0m'
export LESS_TERMCAP_se=$'\E[0m'
export LESS_TERMCAP_so=$'\E[01;44;33m'
export LESS_TERMCAP_ue=$'\E[0m'
export LESS_TERMCAP_us=$'\E[01;33m'

这样MAN就是彩色了，如果希望调整颜色，可以相应修改上述的Escape代码。

不过这种方法有个副作用就是，会扰乱env这样的命令输出的显示。

所以，更好的解决方式是，使用env命令来重新定义man命令的环境：

man() {
  env GROFF_NO_SGR=1 \
    LESS_TERMCAP_mb=$'\E[1;36m' \
    LESS_TERMCAP_md=$'\E[1;36m' \
    LESS_TERMCAP_me=$'\E[0m' \
    LESS_TERMCAP_se=$'\E[0m' \
    LESS_TERMCAP_so=$'\E[1;44;33m' \
    LESS_TERMCAP_ue=$'\E[0m' \
    LESS_TERMCAP_us=$'\E[1;33m' \
    man "$@"
}

以上可以放到你的/etc/bashrc 里面。