Linux中 cmake-3.x 编译安装以及man page添加

Posted 2020-10-05 李学文

首先回顾一下 cmake-2.x 的编译安装。

================ cmake-2.x编译安装说明 ================
编译安装的命令：

./bootstrap --prefix=安装目录（默认为/usr/local）
make
make install（根据安装目录的不同，可能需要root权限）

执行脚本文件bootstrap时加上参数“--qt-gui”，可编译生成GUI版cmake程序。

编译、安装完成后，编辑文件 /etc/profile ，将“安装目录/bin”加入环境变量PATH。

安装好的cmake自带man文档，只要将“安装目录/bin”加入环境变量PATH，即可使用man查看cmake的使用帮助，无需修改 /etc/man.config 。

echo "export PATH=$PATH:/usr/local/cmake/bin" >> /etc/bashrc

================ cmake-3.x编译安装说明 ================
安装步骤基本同cmake-2.x，主要区别在于帮助文档的构建方式。

cmake-2.x的帮助文档其实是嵌在源代码中，并编译进可执行文件，通过“--help-full、--help-html、--help-man”等参数分别输出文本格式、html格式、man格式的帮助文档。

cmake-3.x只保留了“--help-full”用于输出文本格式的帮助文档，另外两种格式需要借助文档生成工具sphinx（一个Python插件）。

在执行脚本文件bootstrap时，通过如下参数指定要构建的帮助文档：

--sphinx-man 构建man帮助文档
--sphinx-html 构建html帮助文档
--sphinx-qthelp 构建qch帮助文档
--sphinx-build=/path/to/sphinx-build 设置sphinx-build程序的路径

执行make前需要安装sphinx。调用Python提供的pip命令（Python3中为pip3）进行安装：

详见：https://github.com/sphinx-doc/sphinx/

README for Sphinx

This is the Sphinx documentation generator, see http://www.sphinx-doc.org/.

Installing

Install from PyPI to use stable version:

pip install -U sphinx

Install from PyPI to use beta version:

pip install -U --pre sphinx
Install from newest dev version in stable branch:

pip install git+https://github.com/sphinx-doc/sphinx@stable
Install from newest dev version in master branch:

pip install git+https://github.com/sphinx-doc/sphinx
Install from cloned source:

pip install .
Install from cloned source as editable:

pip install -e .

 

在安装过程中，pip需要联网下载安装一堆别的Python插件。为了在无法联网的计算机上安装cmake-3.x，建议先在一台能访问互联网的计算机上安装sphinx，构建cmake-3.x及其帮助文档。执行make install后，将安装好的文件部署到无法联网的计算机。

最后要将帮助文档路径写到/etc/man_db.conf文件中。

 

cmake下载地址 https://cmake.org/files/

sphinx下载地址 https://github.com/sphinx-doc/sphinx/

---------------------------------------------------------------------------------------------

转自：http://blog.csdn.net/zhawk/article/details/74276175