随笔档案

最近看到一篇文章，其中讲述了各种Javadoc生成chm的方法及工具。

其实我一直以来都是使用自己写的一个工具来生成的，不过这个工具只是生成了.hhp、.hhc和.hhk文件，最后还需要使用FAR进行简单的编辑和压缩。不过我的工具可以配置并识别目录中包含多个API目录的情况，并能够将非API的部分生成TOC文件(之所以要使用FAR进行简单的编辑，也是因为非API的TOC部分需要根据情况自己修改或增减)。

上图是我是用这个工具生成的Eclipse 3.5的chm文档。

其实这个过程很简单，我们只需要构造自己的文档解析器，并按照hhp、hhc和hhk格式规范生成相应的文件就行了。其中文档解析器我使用了Java的正则表达式来解析，其解析式的核心如下：


其中第一行是索引文件条目的表达式，这里我是使用了index-files来生成索引的，当然在没有index-files的时候是使用TOC解析出来的条目构建。
第二行是TOC条目的表达式，第三行是提取文件title时使用的表达式。
当然这里表达式是有缺陷的，比如不能解析不严格的HTML标签等等，不过对于我自己而言已经足够应付绝大多数Javadoc了。




无人分享的快乐不是真快乐，没人分担的痛苦是真痛苦。