MAC 系统中显示中文MAN手册

MAC 系统中显示中文MAN手册

最近在做中文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 里面。