我只是将一些生成的 javadoc 粘贴到一个 eclipse 项目中,发现没有一个 HTML 是兼容的。
甚至有关闭标签从未打开的情况。
有没有办法解决这个问题?也许是“合规”的选择......
经过一番谷歌搜索,我发现了 XHTML Doclet 0.4。
XHTML Doclet 是Javadoc 标准HTML doclet 的符合标准的替代方案。该项目修改文档结构以排除过时的标签和内联样式,创建有效的 XHTML 标记,并为更灵活的 CSS 操作提供更好的挂钩。
好像有人做了一个插件。
有更好的选择吗?
编辑:这是Sun 的 Javadoc FAQ链接到的插件的官方页面。
简短的回答是 JavaDocs 早于 XHTML。
Java Posse 组最近有一个有趣的线程,您可能会觉得有趣: 为什么 javadoc 停留在 1997 年?