MAC配置中文man手册

原文地址：MAC配置中文man手册

1. 软件依赖

   autotools (autoconf, automake)
   python3
   opencc 1.x
   

   可以通过homebrew自行安装:

   brew install autotools
   brew install python3
   brew install opencc
   

2. 编译安装

   git clone  https://github.com/man-pages-zh/manpages-zh    #下载文件 
   cd manpages-zh
   autoreconf --install --force     #构建configure文件
   ./configure
   make
   make install                     #需要超级用户权限
   

3. 添加手册路径

   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         #已经加载
   

4. 查看中文文档按

   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手册配置，此参数不能少。

5. 解决乱码

   如果系统的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