Javadoc转换chm帮助文档的四种方法总结

Javadoc转换chm帮助文档的四种方法总结V1.0目录关键词..........................................................................................................1前言.............................................................................................................1预处理..........................................................................................................1第一种：使用jd2chm来生成chm帮助文档............................................................4使用原版jd2chm_exe_03转换成chm..................................................................4生成英文版本如下.............................................................................................4生成中文版本如下.............................................................................................5使用网上高手改进的版本jd2chm_0.34转换成chm..................................................7生成英文版本如下.............................................................................................7生成中文版本如下.............................................................................................8第二种：使用javadoc2chm来生成chm帮助文档...................................................11生成英文版本如下............................................................................................11生成中文版本如下............................................................................................12第三种：使用javadoc2help来生成chm帮助文档...................................................18生成英文版本如下............................................................................................18生成中文版本如下............................................................................................18第四种：使用googlecode里面的javadoc2chm项目构建........................................20生成英文版本如下............................................................................................20生成中文版本如下............................................................................................22总结............................................................................................................23李顺利[2010年1月6日]关键词Javadocchm转换jd2chmjavadoc2chmjavadoc2helpJavadoc2chm中文乱码李顺利前言朋友，当您在一个项目完成后，是不是需要把你的源码打包并且把注释打成Javadoc交给客户，Eclipse或者MyEclipse自动打成的Javadoc文档都是基于网页格式的，打开是很方便，不过真的用的时候，搜索每个方法或者什么的就很麻烦了，而chm帮助文档格式不但文件小，查阅都很方便，所以网上就出现了很多把Javadoc转换为chm格式的帮助文档的软件/工具或者方法。自己最近需要真的需要这个方面的需求，查阅了网上很多方法，发现很多都是写的很不详细，对于我这种刚接触的很是不清楚，经过我的学习和理解，现提供从网上总结的Javadoc转换chm帮助文档的四种方法，详细提供各个转换的步骤供大家学习，并且提供英文版本和中文版本Javadoc转换过程中出现的问题，特别是中文的时候出现的乱码现象，也提供一些解决方案。预处理转换之前需要了解的是chm是微软公司发布的一种帮助文档格式，所有，要使用下面的方法转换，请先安装HTMLHelpWorkshop（后面简称为HHW）（实际上后面的一些处理有些都是在上面操作的），下载完毕后就是安装了，很简单。还有一个很重要的问题，就是如何把项目打成Javadoc，这有人应该会说，很简单啊，就是使用Eclipse或者Myeclipse的Export功能，是的，这是可以，但是有些小的方面还是需要我们强烈注意的第一个问题就是Java代码的格式问题Java代码编写的使用有的使用GBK，有的使用UTF-8，这个时候就会有区别。使用GBK编码的时候生成Javadoc文档时没有太大问题的，但是，要是整个项目的默认编码格式是UTF-8的话，就会报警告：编码GBK的不可映射字符根本没有成功生成Javadoc文档，如何解决？解决方案就是在生成Javadoc的时候对VMoptions进行编码设置-encodingUTF-8-charsetUTF-8，设置如下：第二个问题就是如何把生成的Javadoc文档生成英语版本这个问题有的时候为了解决中文乱码是很重要的，我们生成英文版本的Javadoc（仅对生成的Javadoc框架的语言做限制，并没有对注释内容的格式做限制，也就是说这个时候注释还是可以是中文的）。解决方案也是在VMoptions中加入-localeen_US，但是此时注意的是，如果把-localeen_US设置在后面的话，会报一个错误，大致是-localeen_US在javadoc命令必须是在最前面，所有，正确的写法就是-localeen_US-encodingUTF-8-charsetUTF-8（整合上面），默认如果不写-locale的话，安装locale语言来进行设置，当然我们中国人就是中文的了。（当然如果你工程默认编码是GBK而且您想生成中文的帮助文档的话，这写都可以不要，使用默认即可）设置截图如下：做好了上面的工作，现在就请大家看我是如何转换成chm帮助文档的。（做完这些，请生成中文和英文各一份Javadoc文档，供后面测试使用）第一种：使用jd2chm来生成chm帮助文档使用原版jd2chm_exe_03转换成chm原版jd2chm_exe_03需要通过官网下载不过现在我这是不可以访问的，只能通过代理来访问下载工具。（不要担心，最后我会把所有的工具打包供大家下载）。下载解压后就是一个jd2chm.exe文件，怎么使用？很简单，就是把这个文件放到需要生成Javadoc的目录下，必须保证同一个目录下一定要有index.html，不然不可生成，单击，或者在cmd命令中打开exe，填写projectname和title即可。生成英文版本如下生成中文版本如下上面整个生成都很OK，中英文支持都非常的好，唯一遗憾的是，工具生成的时候加了About…和没有顺便生成.HHP,.HHK,.HHC文件，有的时候About我们并不需要或者换成其他的，这个时候可以使用其他的chm编辑器或者HHW反编译修改后重新编译生成，具体操作请大家尝试。使用网上高手改进的版本jd2chm_0.34转换成chm网上一个高手修改了一些很多有用的地方，如果想了解的话，请移步查看并下载。生成英文版本如下请注意最后一个一定要选择y，意思就是在原Javadoc文档里修改一点东西（就我看，就是加了一个about.html），是否同意？不同意如何生成？生成中文版本如下比原版本的好处是不需在放到Javadoc目录下了，还可以使用最新的微软雅黑字体，而且能够生成hhc、hhk、hhp文件，方便我们使用HHW进行编辑。遗憾还是about并且有点破坏了原Javadoc文档（加了一个about.html），这个时候通过HHW工具很方便的进行编辑（有了hhc、hhk、hhp文件）。修改一份给大家看看，打开hhp文件，并打开About…文件，修改部分内容（就是一个html语言写的网页了）修改完成后，保存并编译对比下面修改后的About第二种：使用javadoc2chm来生成chm帮助文档先下载工具javadoc2chm-1.1.0.7.msi，搜索下载（后面会提供），下载完成并安装，会在开始菜单里生成程序快捷方式。生成英文版本如下生成中文版本如下界面操作，很方便，英文支持非常好，中文有一处乱码（上面目录第一层），几乎很完美，遗憾是Title后面加了-Generatedbyjavadoc2chm和中文有点乱码，没有生成hhc、hhk、hhp文件(实际上在转换的时候是生成的这三个文件，后面被删除了，如果耍点小聪明的话，可以在生成过程中复制一份，如果速度快的话，会提示文件已经被删除，是否重试，这个时候再转换，看文件生成后点重试即可得到这三个文件，不要反编译多好)，这种方法建议使用英文版本。自己修改了一份中文版本的转换，现提供部分步骤看看修改后的效果吧第一次打开的首页个性化设置：加入Blog，请大家有空多踩踩我的博客：上面的两种方法也是我极力推荐大家使用的，下面的两种方法仅供学习，里面有很多问题，中文乱码什么的，都会出现。第三种：使用javadoc2help来生成chm帮助文档官方网站，下载解压即可，里面最重要的就是lib目录下面的Javadoc2Help.jar，注意我们就是使用这个jar文件进行生成。官网上也提供了如何使用。生成英文版本如下Cmd命令进入jar文件目录，写下面的命令回车java-jarJavadoc2Help.jar-chm-srcf:\docs\api_en_US-destf:\docs\api_en_US2（具体路径请根据需要修改）注意：-dest后面的目录请不要写原目录，不然生成不了chm并且覆盖了原目录文件。生成中文版本如下Cmd命