macOS 安装 manpages-zh

在 macOS 上，man 命令用于查看系统中安装的程序的帮助文档。然而，默认情况下，这些帮助文档都是英文的，对于不熟悉英文的用户来说可能会有些困难。幸运的是，我们可以安装 manpages-zh 来获取中文帮助文档。

安装依赖

在安装之前，我们需要先安装一些依赖项，依赖项有三个：cmake，python3，opencc，在 macOS 上我们使用 brew 安装这些依赖。

1
2
3
$ brew install cmake
$ brew install python
$ brew install opencc

编译安装

  1. clone 项目

    1
    $ git clone git@github.com:man-pages-zh/manpages-zh.git

  2. 查看最新的 tag

    1
    2
    3
    $ git describe --tags --abbrev=0
    # 或者执行 git tag -l 查看 tag 列表
    # 写这篇博客时，最近的 tag 是 v1.6.4.0

  3. 切换到最新的 tag

    1
    $ git checkout tags/v1.6.4.0

  4. 编译安装

    1
    2
    3
    4
    5
    6
    7
    $ cd manpages-zh
    $ mkdir build && cd build/
    $ cmake ..
    $ make
    $ sudo make install

    # 安装完成后，我们会在 /usr/local/share/man 目录下看到两个目录 zh_CN zh_TW

  5. 添加 zh_CN 到配置文件，本人环境为 zsh，我是将环境添加到 .zshrc 中。

    1
    MANPATH=/usr/local/share/man/zh_CN:$MANPATH; export MANPATH

  6. 重启终端尝试 man 命令

    1
    $ man ls

结论

安装 manpages-zh 后，我们可以方便地查看中文帮助文档，这对于不熟悉英文的用户来说是非常有用的。

参考文档