安装中文版 man 帮助命令

渊虹

工具介绍

        man 这个常用的命令相信大家应该都知道并且使用过吧,当你对一个命令不熟悉时,你可能要使用man来查看下针对命令的描述,相当于命令手册了,但是手册内容都是英文的,对于部分英语水平不是很高的国人来说,这是不友好的,所以 manpages-zh 产生了,它是由国人组织发起关于翻译 man 帮助命令的计划,目前已翻译大部分内容。

        对大多数现代 Linux 发行版用户来说,都可使用自带的安装工具进行一键安装,无需编译。 安装后,正常使用 man 命令即可。在您的系统设置为中文环境时, 如果有对应的中文手册页,则该手册页将显示中文版本。如系统并非中文环境,请临时调整您的环境变量以使用中文内容。

对苹果系统用户来说,并未做过充足的测试,以及没有相应的包来自动安装,所以需要编译安装。

安装成功后的命令描述信息示例如下:
man中文版

以下,给出各个系统的安装步骤。

Debian/Ubuntu 安装

$ sudo apt update
$ sudo apt install manpages-zh

Arch Linux

$ pacman -Syu
$ pacman -S man-pages-zh_cn man-pages-zh_tw

Red Hat/CentOS

$ yum update
$ yum install man-pages-zh-CN

Fedora

$ dnf update
$ dnf install man-pages-zh-CN

macOS 环境安装

前提

编译工具安装

因为需要编译安装,所以你电脑上需要安装 automake 和 opencc 这两个编译工具,如果已安装,可忽略。

$ brew install automake
$ brew install opencc

解压工具安装

可选。推荐使用atool来作为压缩工具来使用,统一了所有压缩文档的命令。

$ brew install atool

安装步骤

# 进入下载目录
$ cd ~/Downloads/
# 下载最新版本的源码包
$ wget https://github.com/man-pages-zh/manpages-zh/archive/v1.6.3.3.tar.gz
# 解压源码包
$ atool -x v1.6.3.3.tar.gz
# 或者使用这个命令解压
$ tar zxvf v1.6.3.3.tar.gz
# 进入源码包文件夹
$ cd manpages-zh-1.6.3.3/
# 编译步骤 1
$ autoreconf --install --force
# 编译步骤 2
$ ./configure
# 编译步骤 3
$ sudo make
# 安装
$ sudo make install
# 配置别名
$ echo "alias cman='man -M /usr/local/share/man/zh_CN'" >> ~/.bash_profile
# 使别名生效
$ source ~/.bash_profile
# 我们就安装上了中文版本的 man 工具了,但是运行命令会发现乱码。
$ cman ls

解决中文乱码问题

中文乱码问题主要是由于主机groff 版本比较低造成的,安装新版本即可解决。

# 进入下载目录
$ cd ~/Downloads/
# 下载1.22版本的源码包
$ wget http://git.savannah.gnu.org/cgit/groff.git/snapshot/groff-1.22.tar.gz
# 解压
$ atool -x groff-1.22.tar.gz
# 进入目录
$ cd groff-1.22
# 编译安装
$ ./configure
$ sudo make
$ sudo make install
# 打开配置文件
$ sudo vim /etc/man.conf
# 进入编辑器之后,在文件末尾添加
NROFF preconv -e UTF8 | /usr/local/bin/nroff -Tutf8 -mandoc -c
# 保存退出
# 运行命令,完美解决乱码问题
$ cman ls
阅读 3.5k
1 声望
0 粉丝
0 条评论
你知道吗?

1 声望
0 粉丝
宣传栏