Java：我如何用Javadoc創建好看的類文檔？

Question

我想爲Java類庫，包括

• 節目指南信息創建HTML文件 - 不僅僅是一類參考
• 代碼示例的參考文檔
• 可摺疊地區

我希望它看起來很好。事情是這樣的：

alt text http://i40.tinypic.com/25qqjbq.jpg

我認爲是公開的Javadoc的doclet一個API，允許其他各方提供的文檔生成集成的Javadoc。是否有一個doclet選項，我可以使用（免費），比標準的javadoc輸出更好一點？

我嘗試了谷歌搜索，但沒有運氣。 建議？

附錄
我發現doclet.com，但我不知道如何評價的選項。建議？

特別是，XHtmlDoclet聽起來像是想解決這些問題。任何人使用它？ I can't get it to work。 example offered by the XHTML Doclet guys也不比the docs generated from c.1998 javadoc好看。

---

相關：
Why does Javadoc generate non-compliant XHTML?

Answer 1

這個問題讓我想到了（好吧，谷歌搜索），我偶然發現了this set of taglets。從來沒有嘗試過，但它看起來很有希望。

Answer 2

也許你會想的Java API的doclet的：

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

看來，您要添加的實例和一些文字。我認爲現有的javadoc完全有可能。問題將是內容而不是渲染。

Castor使用doclet來緩解其配置負擔。 EJB 1.0也是如此。如果你願意的話，請看看這些。