Maven站点（Maven 3）生成空站点文件夹

我正在尝试使用maven网站插件创建一个基本的maven网站。 所以我把它添加到我的pom：

    org.apache.maven.plugins maven-javadoc-plugin 2.7  Leon Blakey ${project.version}  http://download.oracle.com/javase/6/docs/api      

并运行mvn site --errors

 [INFO] Error stacktraces are turned on. [INFO] Scanning for projects... [INFO] [INFO] ------------------------------------------------------------------------ [INFO] Building pircbotx 1.3-SNAPSHOT [INFO] ------------------------------------------------------------------------ [INFO] [INFO] --- maven-site-plugin:2.0.1:site (default-site) @ pircbotx --- [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 2.688s [INFO] Finished at: Wed Jan 12 18:08:00 EST 2011 [INFO] Final Memory: 5M/13M [INFO] ------------------------------------------------------------------------ W:\programming\pircbot-hg> 

嗯，奇怪的是没有输出。 所以当我检查目标/网站时，它是空的。 唯一的文件夹是images /，css /和WEB-INF /，填充了一些通用图片。 没有javadoc也没有网站。

这可以用mvn site:site和mvn org.apache.maven.plugins:maven-site-plugin:2.2:site重复mvn org.apache.maven.plugins:maven-site-plugin:2.2:site （显然maven只想默认使用2.0.1）

奇怪的是，我可以回到maven 2.2.1并成功生成一个网站。 但是当我使用3.0.1-RC1（恰好与Netbeans一起使用）时，它就失败了。

我做错了什么会导致网站插件在3.0.1中失败而不是2.2.1？

Answer 1

也许您可以尝试使用Maven Site Plugin 3.x. 您可以通过在pom.xml中添加以下内容来实现

  ...  ...  org.apache.maven.plugins maven-site-plugin 3.0-beta-3    

Answer 2

我遇到了同样的问题。 我发现了一篇关于这个主题的博客文章 。

引用博客（强调我的）：

如果您一直在使用pom.xml文件的报告部分来生成代码质量指标，javadoc报告等，那么您可能需要做一些工作才能将此function迁移到Maven 3.确实，报告和报告部分部分已被弃用（ 它不会导致Maven 3出现错误，只会被忽略 ），并且已被maven-site-plugin本身的配置块中的reportPlugins部分取代。

忽略旧的而没有任何关于它被弃用的警告似乎有点粗鲁，但无论如何……

所以你基本上只是将旧的报告插件移动到新的maven-site-plugin的配置部分。

maven-plugin-site的一部分解释说，他们从Maven核心中删除了所有报告逻辑，以“将Maven核心与Doxia分离，并允许开发任意报告系统”。 说得通。

Answer 3

最终似乎解决了与Maven 3一起使用Site Plugin（ http://maven.apache.org/plugins/maven-site-plugin/ ）的问题。 （非beta）版本已经发布，并且已经添加了在pom.xml声明中使用版本2样式结构的function。

虽然（通常）很难浏览关于Maven 3和网站插件的实质性但无组织且重叠的文档，但有一页 – http://maven.apache.org/plugins/maven-site-plugin/maven-3。 html – 声明旧的样式现在推荐使用新的“插件到网站插件”样式：

注意：在Maven 3中，新格式不支持报告插件配置inheritance：请参阅MSITE-484。 这种格式在技术上是从Maven 3中删除报告逻辑所必​​需的，但是仍需要在Maven 3中添加新的inheritance机制，使其与旧格式一样灵活。 因此，新格式目前尚未准备好直接使用。

用于配置报告的示例页面http://maven.apache.org/plugins/maven-site-plugin/examples/configuring-reports.html甚至没有提到“新”格式化方法。

不确定这是否是“最佳实践”forms，但是一个示例pom报告部分，对我来说有几个额外的报告，如下所示; 根据需要选择自己的插件。

  ...    org.apache.maven.plugins maven-site-plugin 3.0        org.apache.maven.plugins maven-project-info-reports-plugin 2.4    org.apache.maven.plugins maven-javadoc-plugin 2.8    org.apache.maven.plugins maven-jxr-plugin 2.3  ...   

另外，如果您使用Eclipse中的m2e插件来编辑POM，那么您可以在插件的版本部分中使用代码完成来为您提供其当前版本的列表。 非常便利。