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
    
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容