Warning: file_get_contents(/data/phpspider/zhask/data//catemap/9/java/397.json): failed to open stream: No such file or directory in /data/phpspider/zhask/libs/function.php on line 167

Warning: Invalid argument supplied for foreach() in /data/phpspider/zhask/libs/tag.function.php on line 1116

Notice: Undefined index: in /data/phpspider/zhask/libs/function.php on line 180

Warning: array_chunk() expects parameter 1 to be array, null given in /data/phpspider/zhask/libs/function.php on line 181
Javadoc的替代方案?_Java_Javadoc - Fatal编程技术网

Javadoc的替代方案?

Javadoc的替代方案?,java,javadoc,Java,Javadoc,我已经使用Java多年了,除了javadoc,我真的很喜欢这种语言。 javadoc生成的文档让我感觉自己是在浏览90年代的网页。为了制作一些美丽的文档,你必须在生成html文件之前插入模糊的html标签,这些标签使得你的评论几乎不可读 我正在寻找javadoc的一些替代方案,StructuredText是我的第一选择,但它没有doclet。另一种选择是降价,但它主要针对html,所以如果我想不出其他方法,我就把它当作最后的手段 我也在考虑将注释从java文件中分离出来,但这会困扰在IDE中浏览

我已经使用Java多年了,除了javadoc,我真的很喜欢这种语言。 javadoc生成的文档让我感觉自己是在浏览90年代的网页。为了制作一些美丽的文档,你必须在生成html文件之前插入模糊的html标签,这些标签使得你的评论几乎不可读

我正在寻找javadoc的一些替代方案,StructuredText是我的第一选择,但它没有doclet。另一种选择是降价,但它主要针对html,所以如果我想不出其他方法,我就把它当作最后的手段

我也在考虑将注释从java文件中分离出来,但这会困扰在IDE中浏览代码的开发人员


有什么好主意吗?

您可能不需要使用Javadoc的替代品。 如果您使用的是Java7,那么Javadoc的新版本已经过重新设计


下面是一个输出示例:

看看我在几个项目中使用过它,发现它非常强大,对于文档来说也非常好看。我不得不承认javadoc 6很无聊,但javadoc 7很不错。javadoc8()甚至更好。谢谢,重新设计使它变得更好