Apache Maven PDF 插件 – 过滤文档描述符

过滤文档描述符

文档描述符（又名 src/site/pdf.xml）可以通过系统属性、Maven 项目属性和一些日期属性进行过滤。

表达样本	描述
${JAVA_HOME}	JAVA_HOME 环境值。
${项目名称}	pom.xml 中的 <name/> 标签定义的项目名称。
${project.developers[0].email}	pom.xml 中的 <developers/> 标签定义的第一个开发者的电子邮件。
${日期}	`以 ISO-8601 格式（即yyyy-MM-dd` ）显示的当前日期，例如`2009-06-22`。
${时间}	以 ISO-8601 格式显示的当前时间（即`HH:mm:ss'Z`），例如`12:26:48Z`。
${日期时间}	以 ISO-8601 格式显示的当前日期时间（即`yyyy-MM-dd'T'HH:mm:ss'Z`），例如`2009-06-22T12:24:17Z`。
${年} ${月} ${日}	单一日期信息。
${小时} ${分钟} ${秒}	单次信息。

例子

例如，如果您定义了以下 pom.xml 和 pdf.xml：

<project>
  <modelVersion>4.0.0</modelVersion>

  <version>1.0-SNAPSHOT</version>
  <name>Your project</name>

  ...

  <developers>
    <developer>
      <email>your@email.com</email>
      ...
    </developer>
  </developers>

  ...
</project>

<document xmlns="http://maven.apache.org/DOCUMENT/1.0.1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/DOCUMENT/1.0.1 http://maven.apache.org/xsd/document-1.0.1.xsd"
  outputName="maven-pdf-plugin-doc-${project.version}">

  <meta>
    <title>User guide of ${project.name} version ${project.version}</title>
    <author>${project.developers[0].email}</author>
  </meta>

  <toc name="Table of Contents">
    ...
  </toc>

  <cover>
    <coverdate>${date}</coverdate> <!-- current date in ISO 8601 format -->
    <!-- <coverdate>${day}/${month}/${year}</coverdate> current date in French format -->
    ...
  </cover>
</document>

标题将是您的项目版本 1.0-SNAPSHOT的用户指南，作者将是your@email.com。