插件文档

此插件可用的目标:

目标 描述
站点:附加描述符 将站点描述符 ( site.xml) 添加到要安装/部署的文件列表中。

对于 Maven-2.x,默认情况下仅在项目pom打包时启用,因为它将被模块继承使用,但如果需要,可以为其他项目打包启用。

此默认执行已从 Maven 3.x for pom-projects 的内置生命周期中删除。实际使用这些项目为子模块提供公共站点描述符的用户将需要明确定义此目标执行以恢复预期行为。

站点:部署 使用wagon 支持的协议将生成的站点部署<distributionManagement>到 POM 部分中 指定的站点 URL 。

对于scp协议,网站文件由 wagon 打包成 zip 存档,然后将存档传输到远程主机,然后取消存档,这比逐个文件复制要快得多。

站点:有效站点 site.xml在继承和插值之后,对于第一个语言环境,将有效站点描述符显示为此构建的 XML 。
网站:帮助 显示有关 maven-site-plugin 的帮助信息。
调用mvn site:help -Ddetail=true -Dgoal=<goal-name>以显示参数详细信息。
站点:jar 将站点输出捆绑到 JAR 中,以便可以将其部署到存储库。
站点:运行 启动站点,根据要求呈现文档以加快编辑速度。它使用 Jetty 作为 Web 服务器。
站点:站点 为单个项目生成站点。

请注意,多模块构建中的模块站点之间的链接将不起作用,因为本地构建目录结构与部署的站点不匹配。

现场:舞台 <distributionManagement>根据POM 部分中 指定的站点 URL,将生成的站点部署到本地暂存或模拟目录 。

它可用于测试多模块构建工作中模块站点之间的链接。

此目标要求站点已经使用站点目标生成,例如通过调用mvn site.

站点:阶段部署 使用wagon 支持的协议<distributionManagement>将生成的站点部署到 POM 部分中指定的站点 URL 的暂存或模拟 URL

系统要求

以下指定了运行此 Maven 插件的最低要求:

maven 3.0.5
JDK 1.7
记忆 没有最低要求。
磁盘空间 没有最低要求。

用法

您应该在项目的插件配置中指定版本:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-site-plugin</artifactId>
          <version>3.11.0</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.11.0</version>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

有关详细信息,请参阅“配置插件指南”