Skip to content

macOS 安装 manpages-zh

轩辕十四
Published date:

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

Table of contents

Open Table of contents

安装依赖

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

$ brew install cmake
$ brew install python
$ brew install opencc

编译安装

  1. clone 项目

    $ git clone git@github.com:man-pages-zh/manpages-zh.git
  2. 查看最新的 tag

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

    $ git checkout tags/v1.6.4.0
  4. 编译安装

    $ 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 中。

    MANPATH=/usr/local/share/man/zh_CN:$MANPATH; export MANPATH
  6. 重启终端尝试 man 命令

    $ man ls

结论

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

参考文档

Previous
C 语言重拾【八】结构和其他数据形式
Next
GitHub 使用命令行同步 fork 仓库