无我

让内心永远燃烧着伟大的光明的精神之火!
灵活的思考,严谨的实现
豪迈的气魄、顽强的意志和周全的思考

使用doxygen生成chm

      终于成功的使用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
      
      实在惭愧呀!只能说:必须要学好英语呀!

posted on 2013-03-28 15:25 Tim 阅读(2346) 评论(0)  编辑 收藏 引用 所属分类: 资源共享程序人生


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理


<2011年7月>
262728293012
3456789
10111213141516
17181920212223
24252627282930
31123456

导航

统计

公告

本博客原创文章,欢迎转载和交流。不过请注明以下信息:
作者:TimWu
邮箱:timfly@yeah.net
来源:www.cppblog.com/Tim
感谢您对我的支持!

留言簿(9)

随笔分类(173)

IT

Life

搜索

积分与排名

最新随笔

最新评论

阅读排行榜