Javadoc 有一些好的和现代的替代品吗? [英] Are there some good and modern alternatives to Javadoc?

问题描述

让我们面对现实:你不需要成为设计师就能看到这一点默认Javadoc 看起来很丑.

Let's face it: You don't need to be a designer to see that default Javadoc looks ugly.

网络上有一些资源提供重新设计的 Javadoc.但默认行为代表产品，应该看起来相当漂亮.

There are some resources on the web which offer re-styled Javadoc. But the default behaviour represents the product and should be as reasonably good-looking.

另一个问题是，与其他类似资源相比，Javadoc 的可用性不是最新的.

Another problem is the fact that the usability of Javadoc is not up-to-date compared to other similar resources.

使用 Firefox 的快速搜索很难浏览大型项目.

Especially huge projects are hard to navigate using Firefox's quick search.

实际问题:
是否有任何能够浏览的独立(桌面)应用程序以比浏览器更有用的方式现有 Javadoc?
我正在考虑使用 Mono 的文档浏览器之类的东西.

理论问题:
有谁知道，如果有一些计划发展 Javadoc，在一个以某种方式标准化的方式?
有关此主题的 Sun wiki 的有用链接.

推荐答案

我已经创建了一个 Markdown(java) Doclet 它将采用 Markdown 格式文本中的源注释并创建相同的 HTML Javadocs.

I have created a Markdown (java) Doclet which will take source comments in Markdown formatted text and create the same HTML Javadocs.

新的 doclet 还对文本进行了一些重新设计，但在此阶段不会更改生成的 HTML.

The new doclet also does some restyling on the text, but the HTML generated is not changed at this stage.

这在某种程度上解决了 HTML-in-java-commenting 问题，这可能是当前 Javadoc 最大的可用性问题.

That goes some way to address the HTML-in-java-commenting issues which is probably the biggest usability problem with current Javadoc.

这篇关于Javadoc 有一些好的和现代的替代品吗?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！