原文地址:MAC配置中文man手册
-
软件依赖
autotools (autoconf, automake) python3 opencc 1.x
可以通过homebrew自行安装:
brew install autotools brew install python3 brew install opencc
-
编译安装
git clone https://github.com/man-pages-zh/manpages-zh #下载文件 cd manpages-zh autoreconf --install --force #构建configure文件 ./configure make make install #需要超级用户权限
-
添加手册路径
sudo vim /etc/man.conf ... MANPATH /usr/local/share/man #line 44 MANPATH /usr/local/share/man/zh_CN #添加中文手册路径 ... :wq
可以通过查看是否中文文档已经加载
man -aw /usr/local/share/man:/usr/share/man:/usr/local/share/man/zh_CN #已经加载
-
查看中文文档按
man -aw ls <= 查看有几个中文文档 /usr/share/man/man1/ls.1 <= 默认文档 /usr/local/share/man/zh_CN/man1/ls.1 <= 中文文档
man -a ls <= 查看文档内容
LS(1) BSD General Commands Manual LS(1) NAME ls — list directory contents SYNOPSIS ls [-ABCFGHLOPRSTUW@abcdefghiklmnopqrstuwx1] [file ...]
按【q】进入中文文档
LS(1) General Commands Manual LS(1) NAME ls, dir, vdir - 列目录内容 提要 ls [选项] [文件名...] POSIX 标准选项: [-CFRacdilqrtu1]
【注】默认进入英文文档,按【q】可进入中文文档,再次按【q】则退出文档。
-a 用于显示所有的man手册配置,此参数不能少。
-
解决乱码
如果系统的groff版本太低,文档可能出现乱码,可以将groff更新到最新版本(1.22.3,可能的话请使用尚未发布的 1.22.4)。
brew install groff
安装完成后,配置man.conf
sudo vim /etc/man.conf ... #修改NROFF配置如下(将UTF8编码的MAN页面通过转码而被groff识别) #line 95 NROFF preconv -e utf8 | /usr/local/bin/groff -Wall -mtty-char -Tutf8 -mandoc -c ... #修改PAGER配置如下(这样可以避免MAN手册页面中的ANSI Escape字符序列干扰(用于控制显示粗体等格式)) #line 106 PAGER /usr/bin/less -isR ... :wq