Doxygen + Graphviz windows下图解安装与配置

有些时候对于中大型的工程源代码,阅读起来实在上让学生我啊,一个头两个大,突然想起以前学习H.264编解码的时候,一本书中提到过用Doxygen+Graphviz 通过html生成chm文档,即便于阅读代码的手册,图文并茂。今天自己弄手弄起来,才知道各种困难啊,查找各种资料,先总结如下,以后再用就不用那么痛苦了。

改变人生:http://blog.csdn.net/fly542/article/details/7164633

改为博主的方法很详细。再此我针对性的做一些修改,通过验证有效。Doxygen和Graphviz的软件可以到百度下载,安装和方便。

注意:安装目录不要有中文字符或其他奇怪字符

1、打开Doxygen,在Wizard/Topics/Project做简单的配置

Doxygen + Graphviz windows下图解安装与配置_第1张图片

2、Mode配置

Doxygen + Graphviz windows下图解安装与配置_第2张图片

3、Output配置

Doxygen + Graphviz windows下图解安装与配置_第3张图片

4、Diagrams配置

Doxygen + Graphviz windows下图解安装与配置_第4张图片

5、Expert/Project配置,DOXYFILE_ENCODING改为gb18030,OUTPUTLANGUAGE改为Chinese

Doxygen + Graphviz windows下图解安装与配置_第5张图片

6、Expert/Input配置,INPUT_ENCODING改为gn18030

Doxygen + Graphviz windows下图解安装与配置_第6张图片

7、Dot/Graphviz安装目录配置

Doxygen + Graphviz windows下图解安装与配置_第7张图片

完成以后,点击RUN->tun doxygen开始生成文件。

最后生成带中文目录的CHM文档

由于Doxygen统一采用UTF-8作为输出文件的编码格式,而HTML Help Workshop的CHM编译工具(hhc.exe)不支持UTF-8,如果直接用hhc.exe编译,中文不能正确的显示。因此在用hhc.exe编译前,必须将Doxygen输出的HTML文件以及CHM的项目文件(**.hhp)、目录文件(**.hhc)和索引文件(**.hhk)全部转换到GBK编码。

可以用iconv对文件做编码转换,将iconv解码到c:\windows\system32,然后将utf82gbk.bat和makechm.bat复制到Doxygen输出目录的根目录下,运行makechm.bat即可生成CHM文件。运行makechm.bat时,可以看到生成CHM文件的目录,就在HTML文件夹中。

iconv,utf82gbk.bat和makechm.bat三个文件网上可下载


你可能感兴趣的:(Doxygen + Graphviz windows下图解安装与配置)