3

我想为一个 Java 类库创建 HTML 文档，其中包括

  • 编程指南信息——不仅仅是类参考
  • 参考文档中的代码示例
  • 可折叠区域

我希望它看起来很有风格。像这样的东西：

替代文字

我认为Javadoc 公开了一个 doclet API，允许其他方提供集成在 Javadoc 中的文档生成。是否有一个我可以（免费）使用的 doclet 选项，它比标准的 javadoc 输出做得更好？

我试着用谷歌搜索，但没有运气。建议？

附录
我找到了 doclet.com，但我不知道如何评估这些选项。建议？

特别是，XHtmlDoclet听起来像是要解决这些问题。有人用过吗？ 我无法让它工作。此外，XHTML Doclet 人员提供的示例看起来并不比从 c.1998 javadoc 生成的文档好。

相关：
为什么 Javadoc 会生成不兼容的 XHTML？

4

2 回答 2

1

也许您正在考虑 Java doclet API：

http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html

您似乎正在添加示例和一些文本。我认为现有的 javadocs 完全有可能。问题将是内容而不是渲染。

Castor使用 doclet 来减轻其配置负担。EJB 1.0也是如此。如果你愿意，可以看看那些。

于 2010-03-28T15:44:44.450 回答
1

这个问题让我思考（好吧，谷歌搜索），我偶然发现了这组 taglets。从未尝试过，但看起来很有希望。

于 2010-03-28T18:24:03.467 回答