为什么我生成的javadoc看起来很糟糕?
我正在尝试为我的项目生成JavadocHTML文件。我通过Maven Javadoc插件(Maven Javadoc插件)生成它们。我正在使用Maven 2.2.1。所有的东西都会生成所有正确的信息,但是HTML看起来很糟糕。太糟糕了,我不想那样发表。以下是一个屏幕截图: (注意:是的,我看到“浏览器上禁用JavaScript”消息。即使我单击IE 8关于活动内容的警告并启用它,也没有什么区别) 有各种不必要的换行符,基本的格式都是垃圾。我错过什么了吗?如果我将鼠标悬停在一个类或方法上并看到弹出的Javadoc面板,我希望看到生成的Javadoc与我在Eclipse中看到的类似 我曾尝试在POM文件中添加设置,但在配置Javadoc生成器时,我真的不知道自己在做什么。以下是我目前拥有的内容(在为什么我生成的javadoc看起来很糟糕?,java,maven,javadoc,Java,Maven,Javadoc,我正在尝试为我的项目生成JavadocHTML文件。我通过Maven Javadoc插件(Maven Javadoc插件)生成它们。我正在使用Maven 2.2.1。所有的东西都会生成所有正确的信息,但是HTML看起来很糟糕。太糟糕了,我不想那样发表。以下是一个屏幕截图: (注意:是的,我看到“浏览器上禁用JavaScript”消息。即使我单击IE 8关于活动内容的警告并启用它,也没有什么区别) 有各种不必要的换行符,基本的格式都是垃圾。我错过什么了吗?如果我将鼠标悬停在一个类或方法上并看到弹
元素中):
org.apache.maven.plugins
maven javadoc插件
2.9
C:\Java\jdk1.7.0\u 05\bin\javadoc.exe
1.7
恩努斯
包裹
有什么建议吗
更新: 保利乌斯提供的解决方案非常有效。我从
部分删除了上面的部分,因为它完全没有必要。我添加了新的
元素,如下所述。我的POM文件现在包含以下新块:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.8.1</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
...
</plugins>
</build>
org.apache.maven.plugins
maven javadoc插件
2.8.1
附加javadocs
罐子
...
以下是固定输出的外观:
尝试从
报告
部分删除maven javadoc插件
。如果您使用的是Maven 3,则reporting部分已被弃用,应该删除
尝试添加以下内容:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.8.1</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
org.apache.maven.plugins
maven javadoc插件
2.8.1
附加javadocs
罐子
转到maven插件部分并运行它。我像这样使用maven javadoc插件
,它生成普通的javadoc
希望这能有所帮助。这可能不是因为顶部的错误消息:“浏览器上禁用了Javascript”?看起来浏览器中实际上“更好”:Javadoc应该在不启用JS的情况下呈现…@petermm显然生成的html中有脚本可以在Javascript和非Javascript版本之间切换。我认为亚西莉亚的怀疑是正确的。@petermm是的,Oracle页面上的Javadocs看起来好多了。格式很完美。对不起,我应该提到我使用的是Maven 2.2.1。我本来根本没有这个街区。我添加它只是为了尝试解决这个问题。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.8.1</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>