Linux man中文手册的安装与使用

深碍√TFBOYSˉ_ 2022-12-11 03:23 386阅读 0赞

**概要：** 在 ubuntu 20.04 中下载、安装使用 man 中文手册。

### 文章目录 ###

*   *  linux shell命令学习法宝 --- man 手册
     *  man中文手册的下载、安装及环境变量的配置
     *   *  下载
         *  安装
         *  环境变量配置及 cman 命令使用
     *  man 中文手册注意事项

## linux shell命令学习法宝 — man 手册 ##

man 除了提供 shell 命令的帮助信息，还包括系统内核函数等帮助信息。

man 命令 使用格式如下：

# 查看命令的帮助信息
    man 命令名
    
    # 查看函数的帮助信息
    man 函数名

**Note:** 当命令名和函数名（即上面提到的内核函数）相同时，**默认查看的是命令的帮助信息**，若需要查看函数的帮助信息，则加一个选项 2.即 `man 2 函数名`。

man 手册 功能齐备，然而全部是英文文档，若英语阅读能力不足，阅读理解存在一定困难。若每个帮助文档都用翻译软件转化后阅读也不便，因此推荐安装使用**第三方的man手册中文包**。

## man中文手册的下载、安装及环境变量的配置 ##

### 下载 ###

**man 中文手册下载地址**：[https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/][https_src.fedoraproject.org_repo_pkgs_man-pages-zh-CN]

**manpages-zh-1.5.2.tar.bz2** [下载][Link 1]

官方下载图示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2poc3dvcmQ_size_16_color_FFFFFF_t_70_pic_center]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2poc3dvcmQ_size_16_color_FFFFFF_t_70_pic_center 1]

### 安装 ###

在安装包所在目录打开终端，然后输入、执行以下 shell 命令：

tar -jxvf manpages-zh-1.5.2.tar.bz2
    cd manpages-zh-1.5.2
    ls
    ./configure --disable-zhtw
    make && make install

以上命令执行完毕，man中文手册已完成安装。

默认安装后的路径：`/usr/local/share/man/` ，而 ubuntu 20.04 默认自带的 man 手册的位置在 `/usr/share/man/`。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2poc3dvcmQ_size_16_color_FFFFFF_t_70_pic_center 2]  
接下来为man中文手册配置环境变量，以便在终端使用。

### 环境变量配置及 cman 命令使用 ###

# 使用 vi编辑器 打开用户环境变量配置文件
    vi ~/.bashrc

然后在 `~/.bashrc` 文件最后添加：

# User specific environment and startup programs
    alias cman='man -M /usr/local/share/man/zh_CN'
    PATH=$PATH:$HOME/bin
    
    export PATH

退出编辑模式,保存并关闭 `~/.bashrc` 文件（`：wq`），然后终端执行 `source ~/.bashrc` 生效,或注销重新登录生效。

在终端 用 `cman` 代替 `man` 查看命令和函数的帮助文档：

# 查看 sleep 函数的用法
    cman sleep

**如果想让所有用户均可使用中文手册,环境变量配置时：** 只需要将以上 `~/.bashrc` 替换为 `/etc/profile`，用 vi编辑器打开时，使用 `sudo vi /etc/profile` 命令，其他步骤相同，如此操作即可。

## man 中文手册注意事项 ##

1.  man 中文手册 包含 **shell命令** 和 **系统内核函数** 的帮助文档，但是**并未提供 POSIX 标准函数的中文说明**，如 pthread\_create(),fork() (**但实际上man英文手册提供了**)。
2.  如果安装了 ubuntu 20.04，在安装完整的中文语言包时，系统默认会下载安装 man 中文手册，其默认的安装路径： `/usr/share/man/zh_CN` 。当用 `man 命令或函数名` 时，系统先在 `/usr/share/man/zh_CN` 目录查找，如果存在，返回中文帮助文档信息；  
    若不存在，再到 `/usr/share/man/` 下其他文件和目录中（man 英文手册）查找，若存在，返回英文帮助文档信息；  
    若不存在, 提醒不能发现。

**(本文完)**

[https_src.fedoraproject.org_repo_pkgs_man-pages-zh-CN]: https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/
[Link 1]: https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/manpages-zh-1.5.2.tar.bz2/cab232c7bb49b214c2f7ee44f7f35900/manpages-zh-1.5.2.tar.bz2
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2poc3dvcmQ_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/a1dead89703e486c85f271c5e8403ccf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2poc3dvcmQ_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/12bae8c4cf0d4271b166b918bdd15214.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2poc3dvcmQ_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/098b4b7d66ba49368e62ce2a74937d26.png