怎样生成开源项目源代码的CHM文档

目前开源项目越来越多,例如Linux、Android、OpenCV、PCL等等。这些项目代码规模非常大,文件多,要一个个查看费时费力,而且类、函数对象之间的调用关系难以直观分析。这里向大家介绍一种通过Doxygen、Graphviz和HTML Help SDK来生成包含代码Call Graph等信息的CHM文档,实现All-in-One的代码阅读与分析。

具体地:

1、在这里下载最新的 Doxygen :
http://www.stack.nl/~dimitri/doxygen/

2、另外还有要下载 Graphviz 和 Microsoft HTML Help SDK :
——Graphviz
http://www.graphviz.org/About.php
——Microsoft HTML Help
http://www.microsoft.com/en-us/download/details.aspx?id=21138

3、安装好上面3个软件后,打开 Doxygen

4、在 Step1 指定Doxygen的工作目录,即最终生成html文件夹和chm文档的路径

5、在 Step2 的标签Wizard 或 Expert 里依次设定各项参数。Wizard标签里是项目的总体关键参数设置,一般设置完Wizard的参数即可生成一个包含代码基本信息的chm文档;如果你需要更全面、更深入的代码分析信息,例如类内部成员函数的Call Graph等等,就要在Expert标签中进行定制。

注:以OpenCV项目(https://github.com/Itseez/opencv)代码为例,第4、5步的设置,可下载我在新浪微盘共享的Doxyfile文件(http://t.cn/zYDKs0l),在Doxygen的file-open中导入该文件,然后修改下图红框处的参数或文件夹路径即可。

6、在标签 Run 点击 Run doxygen,在你指定的输出路径会生成一个 html 文件夹

7、打开 HTML Help Workshop,在 File - Open 里选择上述的 html 文件夹中的 index.hhp 打开,按下图点击Project的Option按钮,在弹出窗口中修改Compiled file到你所需的chm生成路径;然后再点击 File - Compile,这样就可以得到所需的 chm 文档了 O(∩_∩)O~

下面是我生成的OpenCV项目代码CHM文档,所用的设置就是上面提到的微盘共享文件,因为设置了对整个项目所有函数对象(包括public/protected/private)的Call Graph都进行分析,生成了大量的图片文件,所以最终得到的CHM文档大小超过了 1.5 G,大家在导入设置文件后、可以试情况在Expert标签中对个别参数进行调整,得到大小适中的CHM文档。

猜你喜欢

转载自blog.csdn.net/chenyusiyuan/article/details/8696224