今天试了一下几种生成chm帮助文件的方法,很遗憾,基本上每种工具都有缺点,先MARK一下,有时间继续研究:
目标:对struts2源代码生成chm格式帮助文件。
生成html我使用的javadoc参数是:-locale en_US -encoding UTF-8 -charset UTF-8
jd2chm是个好工具,我这里下载的jd2chm 0.3和jd2chm 0.34,分别使用docs\struts2-core\apidocs和docs\xwork-apidocs目录生成两个独立的API文档没有问题;
如果直接针对docs目录生成,jd2chm 0.3版本会生成失败,而jd2chm 0.34生成的文件中没有任何可用页面),对于自己生成的html页面同样如此;
javadoc2help这个工具生成的文档中直接没有索引这个选项,PASS;
javadoc2chm这个工具整了半天终于生成了chm,坑爹的是页面出现“此程序无法显示网页”错误;
最后使用PowerCHM这个工具完美解决,我用了struts2\docs目录下带的 html帮助生成了chm帮助,很好用。(利用代码生成的html同样可以编译成chm,我试过了。)
生成的chm地址文件如下:http://download.csdn.net/detail/cockroach/5088089