下面是在Ubuntu 14.04 64bit上生成ats本地离线文档的方法
首先请安装配置好sphinx环境,参见我前面的博文
安装命令如下
sudo pip install sphinx
进入ATS源码顶层目录下面,运行
./configure
目的就是生成doc目录下面的Makefile文件
然后在doc目录观察,发现config.py原来就提供了,免去繁杂的工程配置,直接运行
make html
就会在doc/docbuilds/html下生成各种网页
找到index.html,使用浏览器,比如chrome打开,就可以看了
从效果看,这里没有使用流行的模板,比如sphinx_bootstrap_theme,sphinx_rtd_theme等,通过修改config.py的配置,应该也能生成ATS官网文档
的风格,但是这里已经够用了,下次再折腾吧。