由 Maven 构建

迁移

站点插件进行了几次升级，需要用户对其环境、文档或配置进行调整。以下是这些更改的列表以及您作为用户需要注意的事项。

从 3.4 到 3.5.1

  • 由于Velocity已从 1.5 版升级到 1.7 版，这会更改转义规则，因此您可能需要更新.vm文档和/或外观中的转义序列。如果您无法立即更新内容和/或皮肤，您可以通过配置对 Maven 站点插件的依赖项来手动降级 Velocity 版本： 
        <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-site-plugin</artifactId>
      <dependencies>
        <dependency>
          <groupId>org.apache.velocity</groupId>
          <artifactId>velocity</artifactId>
          <version>1.5</version>
        </dependency>
      </dependencies>
    </plugin>
  • 站点装饰模型 1.7.0 已将页眉和页脚的类型从 DOM 更改为String ：如果您的site.xml（或一个父级）包含 XML 内容，您需要对其进行转义，通常通过添加<![CDATA[和] ]>围绕内容： 
    <project xmlns="http://maven.apache.org/DECORATION/1.7.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/DECORATION/1.7.0 http://maven.apache.org/xsd/decoration-1.7.0.xsd">
    <body>
        <head>
            <![CDATA[<anyHeadElement/>]]>
        </head>
        <footer>
            <![CDATA[<anyFooterElement/>]]>
        </footer>
    ...
    </body>
</project>
  • site.xml中${project.*}和${*}表达式的插值已更改为与 Maven pom.xml中的等效功能一致：现在在继承后进行插值。对于site.xml，这可能会导致 url 失败（通常在${project.url}表达式上），预计在继承期间会重新设置：Maven Site Plugin 3.5.1 中添加了一个新的早期插值功能到$ {this.*}表达式（参见Doxia 集成工具参考文档）。使用此功能（例如${this.url}或${this.customProperty}表达式），你会得到以前的site.xml插值结果。

从 2.x 到 3.x

  • 插件版本 3 至少需要Maven 2.2.0才能运行。
  • 如果您使用Maven 3，请阅读有关相关问题的Maven 3指南。

从 2.2.x 到 2.3.x

  • site : stage和site:stage-deploy目标已与站点生成分离。在不首先生成站点的情况下执行这些目标将导致构建失败。

从 2.1.x 到 2.2.x

  • 该插件现在至少需要Maven 2.2.0才能运行，您不能将它与旧 Maven 版本一起使用。
  • 该插件现在至少需要Java 5才能运行，您不能将它与旧 Java 版本一起使用。

从 2.0.x 到 2.1.x