终于成功的使用doxygen生成chm文档了,发了两天时间,头都痛了。深刻的教训:要学好英文!
doxygen使用文档:《
使用DOXYGEN生成CHM帮助文档 使用详解》
出现的几个问题:
1、在程序注释中画示意图,但是doxygen会将多行作为details进行合成一行,完全打乱了视觉效果,尝试若干总不行,终于没办法读他自带的英文帮助文档,找到\verbatim 和 \endverbatim ,解决问题。效果如下:
2、在为函数写注释时,doxygen有时没有将 \param 或 \return正确处理,怎么修改都没用,最后全删了重新写,注意在中文前后留空格,解决问题。猜测是中文解析的时候导致doxygen产生混乱、
3、最严重的一个问题,就是生成的chm文档没有导航栏!而doxygen的日志上没有什么异常,自己用HTML Help WorkShop编译,产生错误:
HHC6000: Error: An internal file could not be created. Make certain there is enough disk space on the drive where you are compiling your file.
HHC5007: Error: Fatal navigational compilation error. This is likely the result of an invalid contents (.hhc) file.
绞尽脑汁,没有进展。发英雄帖也没回应。由百度转到google,读了一些英文贴,但是自己的英语太差,找不出想要的信息。最后,终于很偶然的找到救星:
《制作 CHM 时出现 HHC6000 和 HHC5007 错误的解决办法》:“
后来还是靠着 Google 的强大威力找了个英文的帖子,看了半天总结出一句话,重新注册一下 itircl.dll ,这个文件在 C:\WINDOWS\system32\ 目录下,具体方法如下
打开命令行(在 “运行” 里面输入 “cmd”)
用 cd 命令进入以上文件夹
输入 regsvr32 itircl.dll
回车后会提示注册成功,然后再编译 CHM 文件就OK了,以上错误都没有了。
以防万一把原帖地址放在下面,有需要的可以去看原文,原帖 12 楼就是我说的方法
http://www.ms-news.net/f1616/html-help-workshop-errors-7767224.html
”
实在惭愧呀!只能说:必须要学好英语呀!