随心所欲——javadoc转chm

 

如果您用过JDK API的chm文档,那么您一定不会拒绝接受其它第三方API的chm文档,比起普通的javadoc网页,chm更无疑更合适用作手册。

可是虽然将html转换成chm的软件多不胜举,却没有合适的软件可以将javadoc转换成像JDK API那种模式。JDK的chm文档可以层叠展开到类和方法,能相当漂亮提供这个功能的我只找到了JavadocToCHM。

JavadocToCHM的作者André Burgaud,
主目录:http://www.burgaud.com/jd2chm.html
下载地址:http://www.burgaud.com/download/jd2chm_exe_03.zip

下载后解压,会得到一个文件jd2chm.exe,这是一个没有界面的dos程序。
我的做法是将此文件扔到 C:/WINDOWS/system32 目录,
那样可以直接使用jd2chm命令操作(为了便于记忆,我将其改为jchm)。

如果你没有安装过Microsoft HTML Help Workshop,那你需要下载一个HTML Help Workshop安装。

好了,准备工作就这么多,下面是具体用法,很简单(如附图):
1)在CMD控制台中进入到需转换的javadoc的主目录,如X:/xx/commons-lang-2.1/docs/api/,注意,此目录必须包括index.html文件。
2)输入jd2chm(此处默认你已经已经将jd2chm.exe放到系统路径)。确定会提示你要输入项目名称和chm文件名称。输入确定完毕即可坐等收成。生成的文件跟index.html一个目录。

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
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值