我正在尝试为我的项目生成Javadoc HTML文件。我是通过Maven Javadoc插件(maven-javadoc-plugin)生成的。我使用的是Maven 2.2.1版本。所有必要的信息都已生成,但HTML格式非常糟糕,以至于我不想以这种方式发布它。这里是一个截图:
(注意:是的,我看到了“JavaScript在您的浏览器上被禁用”的消息。即使我点击IE 8关于活动内容的警告并启用它,也没有任何区别)
有各种不必要的换行符和基本格式很差。我错过了什么吗?我期望看到生成的Javadocs类似于在Eclipse中悬停在类或方法上并查看弹出的Javadoc面板时所见到的。
我尝试在我的POM文件中添加设置,但当涉及配置Javadoc生成器时,我确实不知道自己在做什么。这里是我目前拥有的设置(在元素内部):
(注意:是的,我看到了“JavaScript在您的浏览器上被禁用”的消息。即使我点击IE 8关于活动内容的警告并启用它,也没有任何区别)
有各种不必要的换行符和基本格式很差。我错过了什么吗?我期望看到生成的Javadocs类似于在Eclipse中悬停在类或方法上并查看弹出的Javadoc面板时所见到的。
我尝试在我的POM文件中添加设置,但当涉及配置Javadoc生成器时,我确实不知道自己在做什么。这里是我目前拥有的设置(在元素内部):
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9</version>
<configuration>
<javadocExecutable>C:\Java\jdk1.7.0_05\bin\javadoc.exe</javadocExecutable>
<javadocVersion>1.7</javadocVersion>
<locale>en_US</locale>
<show>package</show>
<verbose />
</configuration>
</plugin>
有什么建议吗?
更新:
Paulius提供的解决方案完全有效。我从我的<reporting>
部分中删除了上面的部分,因为它是完全不必要的。我按照他下面指定的添加了新的<plugin>
元素。现在,我的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>
Here is what the fixed output looks like:
<build/>
标签内,然后运行mvn javadoc:javadoc
,看看是否有所不同?理论上不应该有影响,但是站点插件可能会使用另一组CSS文件(也许)。我刚刚尝试了一下,得到了一些漂亮的API文档。 - maba