在 macOS 上,man 命令用于查看系统中安装的程序的帮助文档。然而,默认情况下,这些帮助文档都是英文的,对于不熟悉英文的用户来说可能会有些困难。幸运的是,我们可以安装 manpages-zh 来获取中文帮助文档。
Table of contents
安装依赖
在安装之前,我们需要先安装一些依赖项,依赖项有三个:cmake,python3,opencc,在 macOS 上我们使用 brew 安装这些依赖。
$ brew install cmake
$ brew install python
$ brew install opencc
编译安装
-
clone项目$ git clone git@github.com:man-pages-zh/manpages-zh.git -
查看最新的 tag
$ git describe --tags --abbrev=0 # 或者执行 git tag -l 查看 tag 列表 # 写这篇博客时,最近的 tag 是 v1.6.4.0 -
切换到最新的 tag
$ git checkout tags/v1.6.4.0 -
编译安装
$ cd manpages-zh $ mkdir build && cd build/ $ cmake .. $ make $ sudo make install # 安装完成后,我们会在 /usr/local/share/man 目录下看到两个目录 zh_CN zh_TW -
添加
zh_CN到配置文件,本人环境为zsh,我是将环境添加到.zshrc中。MANPATH=/usr/local/share/man/zh_CN:$MANPATH; export MANPATH -
重启终端尝试
man命令$ man ls
结论
安装 manpages-zh 后,我们可以方便地查看中文帮助文档,这对于不熟悉英文的用户来说是非常有用的。