首先回顾一下 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 。
================ 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/[email protected] 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