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 后,我们可以方便地查看中文帮助文档,这对于不熟悉英文的用户来说是非常有用的。

参考文档

  • manpages-zh
  • Manpages Zh Mac Os Installation