Doclava是一个新的Javadoc工具,它允许你自定义一些javadoc标签。这个工具来自Google,并且在Google Guice项目中得到了广泛使用,你可以看一下Guice的javadoc,非常棒。Doclava使用JSilver(Clearsilver的Java实现)作为模板引擎。它可以实现多个相关项目文档之间的联合与互动。
下面是Doclava和传统的Javadoc的一些不同点:
- 新的外观样式,而且包含了搜索功能;
- 在文档中嵌入了版本信息;
- 用户可以通过模板引擎,方便的给定制文档的特性;
- 可以侦测一些简单的错误,在构建文档的时候抛出异常,比如@param标签不匹配函数的参数名;
- 可以从真正的源代码里加入Snippet;
- 联合多个不同网站的文档资源;
- 可以将javadocs内容嵌入到更大的网页当中去。