7

我正在尝试为我的项目生成 Javadoc HTML 文件。我通过 Maven Javadoc 插件 (maven-javadoc-plugin) 生成它们。我正在使用 Maven 2.2.1。一切都会生成，以便所有正确的信息都在那里，但 HTML 看起来很糟糕。太糟糕了，我不想那样发布它。这是一个屏幕截图：

（注意：是的，我看到“您的浏览器上禁用了 JavaScript”消息。即使我单击有关活动内容的 IE 8 警告并启用它，也没有什么区别）

混乱的 Javadoc 格式的屏幕截图

各种不必要的换行符，基本的格式都是废话。我错过了什么吗？如果我将鼠标悬停在一个类或方法上并看到弹出的 Javadoc 面板，我希望看到生成的 Javadocs 看起来与我在 Eclipse 中看到的类似。

我尝试在我的 POM 文件中添加设置，但在配置 Javadoc 生成器时我真的不知道我在做什么。这是我目前拥有的（在<reporting>元素内部）：

<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>

这是固定输出的样子：

正确生成的 Javadoc

4

1 回答 1

2

尝试maven-javadoc-plugin从reporting部分中删除。如果您使用的是 Maven 3，则报告部分已弃用，应删除。

尝试添加以下内容：

<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>

到你的 Mavenplugins部分并运行它。我maven-javadoc-plugin像这样使用它，它会生成正常的 javadocs。

希望这可以帮助。

于 2012-10-24T13:10:21.720 回答