Java：如何使用Javadoc創建外觀漂亮的類文檔？

Question

我想為包含的Java類庫創建HTML文檔

• 編程指南信息 - 不僅僅是一個類參考
• 參考文檔中的代碼示例
• 可折疊區域

我希望它看起來很好看。 像這樣的東西：

我認為 Javadoc公開了一個doclet API，允許其他方提供集成在Javadoc中的doc生成。 是否有一個doclet選項，我可以使用（免費）做一些比標准的javadoc輸出更好的東西？

我試着谷歌搜索但沒有運氣。 建議？

附錄
我找到了doclet.com，但我不知道如何評估這些選項。 建議？

特別是， XHtmlDoclet聽起來像是要解決這些問題。 有人用過嗎？ 我無法讓它發揮作用 。 此外， XHTML Doclet人員提供的示例看起來並不比從c.1998 javadoc生成的文檔更好。

---

有關：
為什么Javadoc會生成不兼容的XHTML？

Answer 1

也許您正在考慮使用Java doclet API：

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

您似乎在添加示例和一些文本。 我認為現有的javadoc完全有可能。 問題將是內容而不是渲染。

Castor使用doclet來減輕配置負擔。 EJB 1.0也是如此 。 如果你願意，看看那些。

Answer 2

這個問題讓我思考（好吧，谷歌搜索），我偶然發現了這組標簽 。 沒試過，但看起來很有前途。