Javadoc2chm工具:转换文档与生成帮助文件的利器

需积分: 1 1 下载量 28 浏览量 更新于2024-10-08 收藏 2.89MB 7Z 举报
资源摘要信息:"Javadoc2chm工具是一个将Java源代码中的文档注释(Javadoc注释)转换成CHM( Compiled HTML Help)格式文件的工具。Javadoc注释是Java开发者用来描述类、方法、字段等详细信息的标准方式,这些注释通常放在源代码的特定位置,由Javadoc工具在编译时提取出来,并生成文档。CHM是微软推出的一种帮助文件格式,广泛用于软件的用户手册、产品文档等。 Javadoc2chm工具的出现,大大方便了Java开发者的文档输出工作。开发者只需要按照Javadoc的标准编写注释,然后通过这个工具,可以快速地将这些注释转换成结构化的、便于查阅的CHM文件。这样一来,开发者就能为自己的Java库或应用创建出专业、易用的文档。 使用Javadoc2chm工具一般包括以下步骤: 1. 准备Javadoc注释:开发者需要在Java源代码中按照Javadoc标准添加注释。 2. 运行Javadoc工具:首先使用Javadoc工具从源代码中提取注释,并生成标准的Javadoc HTML文档。 3. 使用Javadoc2chm转换:将生成的Javadoc HTML文件作为输入,通过Javadoc2chm工具转换成CHM文件。 Javadoc2chm工具支持多种自定义选项,例如可以自定义CHM文件的风格、目录结构、索引以及关键字搜索等,以满足不同开发者对文档格式和内容的个性化需求。 Javadoc2chm工具可能不是Java官方提供的工具,因此其具体使用方法和可调整的参数可能会因不同版本或具体实现而异。开发者可能需要查阅该工具的官方文档来了解如何使用它以及如何通过配置文件来自定义生成的CHM文档。 值得注意的是,虽然CHM文件在很多场景下仍然是文档发布的首选格式,但随着互联网技术的发展和移动设备的普及,PDF、Web页面以及在线文档等格式也日益受到开发者的青睐。因此,开发者在选择文档格式时,应考虑目标用户群体的需求以及文档的使用场景。 在Javadoc2chm的文件名称列表中,我们看到了“javadoc2help”这一文件名。这可能是该工具的可执行文件或者与之配套的脚本、批处理文件等。这表明该工具可能包括多个文件,例如,可能包括主执行文件、配置文件、库文件等。对于具体使用时,开发者需要关注如何正确调用这些文件,以及如何根据项目需求配置这些文件。" 由于文档的具体使用方法、配置细节等信息未在给定的文件信息中提供,因此无法提供更详尽的操作指南。建议开发者查找该工具的官方文档获取更深入的使用帮助。
2012-04-22 上传
2009-02-19 上传
avadocToCHM 最好用的javadoc 转换成chm格式的工具,编译出来的效果是所有同类中最好的。 改造自jd2chm 0.3,这个软件好像从04年后就一直没有更新了,但是0.3版存在一些问题,从06年第一次出j2se1.5 api spec中文版的时候,俺自己动手改了改代码编译了一份chm,编译的chm和工具后来也就小范围流转,自己查阅的各方面javadoc我都会编译成 chm,比htm来得方便很多。 最近编译1.6的api spec,又更新了一下,感觉这东东还是挺不错的,因此干脆发布出来大家同乐乐吧。希望对搞java的兄弟有点用。 已知问题:对于UTF-8编码的中文javadoc,编译成chm后无法搜索中文。 纳米盘下载(1.4M):http://www.namipan.com/d/e2392071317bb45ecdcfc31b5de493248d68909ea4dc1600 另外编译好的1.6的api spec也可以从纳米盘下载,自己编译一次还是比较耗时间的。 中文(08年5月的,比官方发布的、网上流传的中文chm新):http://www.namipan.com/d/0afe8c540ce8ca604515779941c051d1003043910b667602 英文:http://www.namipan.com/d/88535dc749ee0b9319f9dab59ada0c2691fb7f0269925402 我改的内容: ============================================ v0.34 1、英文版的保持原始jd2chm版本带的CSS 2、中文版本的javadoc可选择使用雅黑 ============================================ v0.33 1、可以不拷贝到临时目录 2、可以选择Language为中文:对于中文的javadoc,如果不能搜索中文,可以启用该参数试试 3、替换hhc文件的“]+>([^<]+)”为“\1” 4、替换hhc文件的“ ”为“ ” 5、默认doc字体设置为雅黑(css) 6、修正语言为非英文时,目录树字体难看的问题(-->Microsoft Sans Serif) 7、Interface节点换个书的图标,看得清楚些 ============================================ v0.32 1、兼容性问题:有些Javadoc没有index-all.html ============================================ v0.31 1、增加启动参数 start_dir 2、增加选项,完成后删除临时文件 3、绿化hhc