Javadoc的替代方案?
我已经使用Java多年了,除了javadoc,我真的很喜欢这种语言。 javadoc生成的文档让我感觉自己是在浏览90年代的网页。为了制作一些美丽的文档,你必须在生成html文件之前插入模糊的html标签,这些标签使得你的评论几乎不可读 我正在寻找javadoc的一些替代方案,StructuredText是我的第一选择,但它没有doclet。另一种选择是降价,但它主要针对html,所以如果我想不出其他方法,我就把它当作最后的手段 我也在考虑将注释从java文件中分离出来,但这会困扰在IDE中浏览代码的开发人员Javadoc的替代方案?,java,javadoc,Java,Javadoc,我已经使用Java多年了,除了javadoc,我真的很喜欢这种语言。 javadoc生成的文档让我感觉自己是在浏览90年代的网页。为了制作一些美丽的文档,你必须在生成html文件之前插入模糊的html标签,这些标签使得你的评论几乎不可读 我正在寻找javadoc的一些替代方案,StructuredText是我的第一选择,但它没有doclet。另一种选择是降价,但它主要针对html,所以如果我想不出其他方法,我就把它当作最后的手段 我也在考虑将注释从java文件中分离出来,但这会困扰在IDE中浏览
有什么好主意吗?您可能不需要使用Javadoc的替代品。 如果您使用的是Java7,那么Javadoc的新版本已经过重新设计
下面是一个输出示例:看看我在几个项目中使用过它,发现它非常强大,对于文档来说也非常好看。我不得不承认javadoc 6很无聊,但javadoc 7很不错。javadoc8()甚至更好。谢谢,重新设计使它变得更好