问题标签 [maven-site-plugin]

我已经成功设置了一些使用 Maven 将 Maven 生成的站点自动部署到gh-pages其 git 存储库的分支的项目。然后 GitHub 在个人子域的公共 URL 上提供这些文件。我希望利用此功能为富客户端仅 GWT 应用程序提供服务。

我已经修改了我pom.xml的将 GWT 应用程序编译到target/site/目录中。我仍在努力实现的两个主要目标是：

• 如何防止标准 Maven 站点插件在该site阶段运行？
• 在该阶段gwt:compile执行什么要求？site

我有一个 Maven 管理的项目，其中包含一些模块，其中一个是实际感兴趣的库。其他模块只是从库构建的附加组件或示例。我希望为此库生成 Maven 站点并自动部署它（作为独立站点，而不是作为多模块站点的一部分），但我在使用 Javadoc 插件时遇到了问题。

执行javadoc:javadoc目标时，javadoc 插件正在尝试访问jar导致失败的其他模块。

我创建了一个简单的例子来演示这种现象。确保您clean在任何其他人之前运行目标，以便显示缺陷。虽然先执行打包会解决这个错误，但这无法解决，因为用例发生在 Maven 管理的发布过程中，该过程从干净状态开始。

有没有办法让我在 javadoc 插件中禁用此功能，以便我只获得库模块的文档？

我想使用 Maven 为我的应用程序创建站点。这是一个多模块app，父模块是简单的站点模块，第一个子是app的核心，第二个是GUI（Swing）。

我现在使用 follow 作为父 pom.xml

我核心的pom：

（我从两者中删除了不相关的部分）

问题：我尝试了 mvn site:stage，但没有从核心模块收集 javadoc。我错了什么？

我有一个包含很多子模块的 maven 项目，我使用父 pom 来控制插件，如下所示

因此src\site\site.xml包含如下自定义菜单

在我mvn site:stage以 root 运行后（从maven 站点插件建议），父网页很好，<sub-modules>\index.html而不包含任何菜单（没有项目信息和项目报告）

我还注意到，如果我mvn site在子模块下运行，则 index.html 左侧不包含任何菜单，而单个 html 存在于 pmd.html、license.html 等目录中

• 我需要添加src\site\site.xml每个子模块还是其他更好的方式？
• 还是我在pom.xml某个地方做了什么愚蠢的事情？

有什么提示吗？

[更新] 也喜欢横幅图像，如果我像这样在父级中设置

指向错误方向的子模块的站点，在 html 中，看起来像..\..\<submodule>，不是..\images\mylogo.png

我正在使用 maven（版本 3.0.3）的站点分发功能为我们的项目上传生成的内容。它在我们的 pom.xml 中配置如下：

它工作正常，但是我注意到页面的“上次发布：”部分仅在我物理删除目标文件夹的内容时才会更新。我想知道这是否是一个错误，如果是，是否可以配置 maven-site-plugin（版本 3.0-beta-3）在解压缩上传的文件以解决它之前清理目标文件夹?

任何帮助是极大的赞赏。

我想为快照和发布以不同的方式为 Maven 项目的层次结构部署一个站点（即http://example.org用于发布，http://dev.example.org用于快照）并保持项目层次结构（父母，孩子，模块）正确的链接。

我的尝试是分配属性来保存“当前”站点信息以及属性来保存每种可能的站点类型（即开发、稳定等）。然后我会使用配置文件在发布时切换站点信息。以下是我的意思的一个例子。

父 POM 片段：

示例父站点描述符：

示例子站点描述符：

它的分发管理部分完美地工作并按照我的预期部署文件（基于活动配置文件到目标机器上的正确目录）。

对于实际站点部分：

使用 2.2 版的站点插件，这对父站点运行良好，但即使指定的发布配置文件处于活动状态，所有后代站点也会恢复为快照或“开发”版本。使用 3.0 版的站点插件，将打印以下消息并且（如所述）不创建父菜单。链接部分的行为类似于 2.2 版。

使用 codehaus 的 properties-maven-plugin，我可以看到配置文件属性已正确应用，但站点插件似乎忽略了这一点。

有没有更好的方法来完成我想做的事情？这是一个错误，还是我在某个地方犯了错误？

我目前正在使用 Maven 3 使用maven-site-plugin 。

该插件按预期生成所有报告，但由于我的项目布局（如下所示），显示的主站点不显示报告。谁能建议我们如何共享内容或添加链接以显示如何将链接放入 site.xml 以显示内容。谢谢

site\site.xml 文件如下所示。

运行该站点没有问题，该站点出现，但没有任何链接起作用，并且报告不可见。我认为这是因为我的项目设置不标准。我有以下设置

出于某种未知原因，当我运行 site:run 并输入“localhost:8080”时，EAR\target\index.html 中的 index.html 出现了，而不是 PARENT_PROJECT\target\index.html 文件？

请注意， mvn:site 是从 PARENT_PROJECT 运行的

将 POM 更改为包括

由于它是一个多项目，现在按照此处的建议运行 site:stage http://maven.apache.org/plugins/maven-site-plugin/faq.html但注意到我无法运行该项目，因为 maven 声明“什么” mvn site”将为您做，在多项目构建中，为父级及其所有模块单独运行“mvn site”。父级和子级之间的链接在这里不起作用。但是，当您部署地点。”

我正在使用Maven 站点插件来创建和部署文档和资源站点。我想根据正在使用的配置文件过滤一些 javascript 文件。问题是，我不知道如何让过滤工作。有没有人遇到过这个？

我正在使用 Maven 3，我的资源都被站点插件/src/site/resources自动复制到其中。/target/site

谢谢！

配置了 maven-site-plugin 和 maven-javadoc-plugin （使用doclava doclet）后，我试图在由mvn site. 在我的代码中，我有几个 JUnit 测试类（位于src/test/java/my/package/*.java），其中 JavaDoc 注释链接源类（位于src/main/java/my/package/*.java） . 问题是在生成 Test JavaDocs 时，javadoc 找不到源类文档所在的位置。我试图通过使用maven-javadoc-plugin 的配置选项来告诉 javadoc 在哪里找到它（links在此处记录offlineLinks)，但没有运气。我希望 javadoc 生成相对链接，以便它们在离线查看生成的文档时可用（在浏览器中从/path/to/project/target/site/index.html浏览）。我不想禁用测试 JavaDocs 生成

我的 pom.xml | mvn 站点输出的摘录

另外，我是 Java 和 Maven 新手

为了澄清这个问题，这里有一个例子。我有一个GenerateATest位于src/test/java/name/earshinov/PrefixCircuits/GenerateATest.java的测试类（抱歉评论是俄语）：

链接的类PrefixCircuitGenerator位于src/main/java/name/earshinov/PrefixCircuits/PrefixCircuitGenerator.java中。运行后mvn site，我在 target/site/apidocs/index.html 获得源类的 JavaDocs，在target /site/testapidocs/index.html 获得测试 JavaDocs 。在Test JavaDocs 的文档中，我希望看到指向源类 JavaDocs 文档的链接。但是，javadoc 找不到我所指的，因此它不会生成链接，并且相应的警告在输出中可见：GenerateATestPrefixCircuitGeneratorPrefixCircuitGeneratormvn site

我的目标是（以某种方式）告诉 javadoc 如何生成链接。更改{@link name.earshinov.PrefixCircuits.PrefixCircuitGenerator}为{@link PrefixCircuitGenerator}不会改变任何内容。

这就是我面临的情况：目前我有两个 Maven 项目，一个只描述依赖项、存储库等（父级）和一个继承另一个 pom.xml 的子级。未来会创建更多的模块，遵循与孩子相同的模型。

我们决定将项目的站点（使用 maven-site-plugin 生成）部署到此时只能通过sftp访问的位置。而且我发现无法定义站点位置，<distributionManagement>因为我无法集成 sftp 协议（我尝试使用 wagon-ssh-external）。

结果，我创建了一个脚本，该脚本连接到远程机器并在站点部署阶段上传我们站点部署到的本地文件夹的内容：

这对父站点非常有效，在本地创建站点后立即上传站点，但是当子站点到达脚本末尾时，它无法正确完成，打印Terminating script execution..并停留在那里。

我正在使用 Eclipse，这是带有默认 Maven 插件（v. 3.0.2）的最新版本（3.7）。为了在 Eclipse 中生成和部署站点，我右键单击父项目 >​​ Run as > Maven build... > parent clean site-deploy。

这些是父母的部分pom.xml：

从孩子那里：

我尝试了不同的方法来配置exec插件（不使用pluginManagement，继承插件的父级配置，只重写参数部分等），它在完成脚本时总是被阻塞并且不会结束执行。

该站点已正确上传，但是当然，我不想在每次要更新站点时手动终止 Maven 构建执行（另外，计划将项目中的工件部署到 Jenkins 服务器，因此该站点部署希望届时能够工作）。