问题标签 [maven-site-plugin]

作为我们应用程序开发的一部分，我们正在使用 Maven 站点插件创建文档。我们的 apt 文件位于src/site/apt. 我知道可以使用 {{xxx}} 语法在 apt 中创建链接，但我想知道是否有一种简单的方法可以创建指向 java 文件和/或包的链接？

是使用相对路径的唯一方法（即：../../main/java/com/pkg/MyFile.java）吗？

有没有办法链接到包名？

我是第一次使用 maven checkstyle 插件。我在父 pom 中添加了 checkstyle 插件，并在 checkstyle.xml 中指定了一些规则列表。

我运行“mvn clean site”来生成报告。每件事都运行良好，但它也会生成许多不需要的报告。我该如何预防。

我尝试了“mvn clean checkstyle:checkstyle”，但它没有考虑我的 checkstyle.xml 规则。IE。它还会生成所有违反默认规则的报告。

而且网页也显示不正确。IE。它生成没有样式（.css 文件）的 .html 文件，所以看起来很糟糕。

在我的 pom.xml 中是

我正在尝试使用 maven-site-plugin 为我的项目生成一个站点。现在，我刚刚添加了插件，并mvn site从我的多模块项目的根目录运行。

每次运行时，我都会在日志中看到以下错误mvn site。

该Unable to connect to消息在日志中重复了数十次。

该项目的 pom 可以在这里找到：https ://github.com/justinhrobbins/FlashCards_App 但如上所述，我刚刚为 maven-site-plugin 添加了 pom 插件

尽管我看到了这些错误，但构建成功并且我确实在生成的站点的 Dependency Convergence 页面上看到了依赖关系。

我尝试用谷歌搜索错误，但只发现一些具有相同错误的 CI 构建日志。

我正在尝试通过一个可以在 Jenkins 中执行的命令为我的多模块项目构建一个完整的站点。但是，当我构建它时，子模块 javadocs 出现在站点根目录中（站点/apidocs 而不是站点/子模块/apidocs）。从父模块到子模块的所有链接也都断开了。

组织是标准

父 POM 包含：

子模块 POM 仅包含 pluginManagement 的骨架插件定义。

当我尝试构建一个站点（在我的本地机器和 Jenkins 上）时，我从父级运行

通过上述设置，什么会导致子模块将其站点文件转储到站点根目录 (site/) 而不是子模块目录 (site/submodule) 中？我是否需要使用 staging 命令（我避免使用它，因为它会破坏发布过程）？是否根本不可能在一个命令中构建一个多模块站点？

我目前正在努力使用 Maven 站点插件。我有一个公司/超级 pom（包装类型 pom），它定义了所有依赖版本并配置了站点插件。此外，我在 /src/site/resources/images 下放置了一些图像资源，这些资源在自定义 site.xml 中引用（例如 ./images/logo.jpg）。

另一个模块引用了这个父 pom，当我调用 mvn site 时，似乎 site.xml 正在被拾取。但不幸的是，图像的链接不起作用。当我查看目标/站点文件夹时，图像丢失了。我还尝试创建一个额外的“企业”资源模块，在其中放置站点资源（也在 /src/site/resources 下），并将该模块作为 maven-site-plugin 中的依赖项引用，如下所示：

但这似乎也不起作用。它适用于其他报告模块，例如具有特殊配置的 pmd，但这些配置位于 /src/main/resources 下……站点资源似乎没有被拾取并发布到存储库。

所以问题是：如何将图像和样式表附加到 maven 超级 pom 中？我正在使用 Maven 3 顺便说一句...

我试图在我的目标目录中编辑我的 index.html 文件。不知什么原因，在编辑后，它切换回旧版本。

我正在为一个结构如下的 3 级多模块 Maven 项目创建一个 Maven 站点：

我在跑步mvn site site:stage

Maven 站点模块链接适用于 child-a，但对于嵌套模块 child-b 无效。（如果我首先单击指向 child-a 的链接，则指向 child-b 的链接确实有效。）

在这里自己看看：http: //justinhrobbins.github.io/multi-module-site-report-test/site/0.0.1-SNAPSHOT/

我的父母 pom 中有以下内容：

为了使链接适用于此 Maven 站点报告中的所有项目模块，需要做什么？（我知道这<url>不是真的，目前我希望它在舞台上工作）

我向 Github 添加了一个简单的测试用例项目来演示该问题： https ://github.com/justinhrobbins/multi-module-site-report-test

编辑：我正在使用以下插件版本：

我有一个关于使用父 POM 文件和子模块构建 Maven 站点的问题。当菜单从父 POM 继承时，我无法在继承的模块站点中获取相关链接。

我有一个项目结构如下：

因此，通过这种配置，我最终得到了一个如下所示的站点：

从 modules/pom.xml 构建的 reactor 生成顶级网站，每个模块也生成一个网站。

每个模块都从父模块继承这个 site.xml 文件（例如）：

引用标准 Maven 生成的“报告”的菜单工作正常。

但是 project-summary.html 的 href 最终指向顶部站点而不是子站点。

我在 Stackoverflow 上看到了一些与构建继承菜单有关的类似问题，但我没有找到有关如何让这些链接指向子站点而不是父站点中的内容的确切信息。我可能误解了菜单继承在这里应该完成的工作。

基本上，我希望子站点中生成的内容的菜单链接如下所示：

好的，所以我想，让我尝试使用过滤来完成这个，就像我的父 POM 使用类似的东西：

但这不起作用，因为父 POM 的名称在此处被替换，而不是子项目的名称。

在这种情况下，也许我需要为每个模块创建一个自定义 site.xml，但我想避免这种情况，因为其中有 15 个，并且它们在共享大约 8 或 9 个不同（相对) 菜单链接。大多数项目不需要自己的 site.xml 文件。所以理想情况下，我希望父级定义所有默认值，子级 POM 添加一些额外的菜单。

为了做到这一点，我是否坚持使用“报告”参考及其默认布局？或者我可以在父的 site.xml 文件中将这些明确列为菜单项并让这些引用以某种方式工作吗？

我希望这很清楚。谢谢。

我正在尝试为具有父项目的项目生成一个站点并收到以下错误。

我并不惊讶它在 repo1 中找不到它。对我们公司存储库的检查表明 site_en 文件尚未部署到我们的工件中。

该站点确实从我们进行大部分构建的机器生成。事实证明，因为它为 parent 和 java-parent 构建了实际版本，所以它在其本地存储库（本地磁盘上的那个）中有 site_en.xml 文件。

我想开始我需要 2 种可能的解决方案中的 1 种：

1. 一种告诉子项目停止尝试查找父项目site.xml 的方法。

2. 一种将 site.xml 文件部署到工件的方法。

我试图找到任何一种解决方案都失败了。我可以将站点 xml 文件放入本地工件的唯一方法是运行完整的 mvn release:prepare release:perform。我不知道如何使它将这些文件部署到工件或如何在不实际发布的情况下生成这些文件。

有任何想法吗？

我下载了 Jetty 源代码并尝试运行以下 maven 命令：

但问题是 maven-site-plugin 不起作用。我使用 Maven 3.0.5（也尝试过最新的）和 maven-site-plugin 3.3。

错误如下所示：

插件配置如下所示：

所以看起来 maven-site-plugin 似乎仍然有一些错误，它不适用于 Maven 3。有没有人知道任何解决方法？