站点:站点

全名

org.apache.maven.plugins:maven-site-plugin:2.0.1:site

说明

为单个项目生成站点。

请注意,多模块构建中的模块站点之间的链接将不起作用

属性

  • 需要执行 Maven 2.0 项目。
  • 需要范围内工件的依赖关系解析:test.

必需参数

姓名 类型 自从 描述
生成的站点目录 File - 包含生成文档的目录。
输出目录 File - 包含生成的项目站点和报告分发的目录。
默认值为${project.reporting.outputDirectory}
站点目录 File - 包含 site.xml 文件和 apt、fml 和 xdoc 文档源的目录。

可选参数

姓名 类型 自从 描述
属性 Map - 用于呈现站点的模板属性。
生成报告 boolean - 允许您禁用报告生成的便利参数。
默认值为true
输入编码 String - 指定输入编码。
默认值为${project.build.sourceEncoding}
本地存储库 ArtifactRepository - 本地存储库。
语言环境 String - Maven 支持的以逗号分隔的语言环境列表。第一个有效令牌将是此 Java 虚拟机实例的默认语言环境。
模块排除 Map - 模块类型排除映射例如:(fml -> **/*-m1.fml递归排除以“-m1.fml”结尾的 fml 文件)

配置如下所示:
<moduleExcludes>
<moduleType>filename1.ext,**/*sample.ext</moduleType>
<!-- moduleType can be one of 'apt', 'fml' or 'xdoc'. -->
<!-- The value is a comma separated list of -->
<!-- filenames or fileset patterns. -->
<!-- Here's an example: -->
<xdoc>changes.xml,navigation.xml</xdoc>
</moduleExcludes>

输出编码 String - 指定输出编码。
默认值为${project.reporting.outputEncoding}
存储库 List - 用于项目的远程存储库。
模板 String - 已弃用。改用 templateFile 或蒙皮
模板目录 File - 已弃用。改用 templateFile 或 skinning
默认值为: src/site
模板文件 File 2.0-beta-5 要使用的 Velocity 模板文件的位置。使用时,皮肤和默认模板、CSS 和图像被禁用。强烈建议您将其打包为皮肤。
xdoc目录 File - xdoc 源的替代目录,对 m1 到 m2 迁移很有用
默认值是: ${basedir}/xdocs

参数详情

属性

用于呈现站点的模板属性。
  • 类型java.util.Map
  • 必需No
  • 表达式${attributes}

生成报告

允许您禁用报告生成的便利参数。
  • 类型boolean
  • 必需No
  • 表达式${generateReports}
  • 默认true

生成站点目录

包含生成文档的目录。
  • 类型java.io.File
  • 必需Yes
  • 表达式${project.build.directory}/generated-site

输入编码

指定输入编码。
  • 类型java.lang.String
  • 必需No
  • 表达式${encoding}
  • 默认${project.build.sourceEncoding}

本地存储库

本地存储库。
  • 类型org.apache.maven.artifact.repository.ArtifactRepository
  • 必需No
  • 表达式${localRepository}

语言环境

Maven 支持的以逗号分隔的语言环境列表。第一个有效令牌将是此 Java 虚拟机实例的默认语言环境。
  • 类型java.lang.String
  • 必需No
  • 表达式${locales}

模块排除

模块类型排除映射例如:(fml -> **/*-m1.fml递归排除以“-m1.fml”结尾的 fml 文件)

配置如下所示:
<moduleExcludes>
<moduleType>filename1.ext,**/*sample.ext</moduleType>
<!-- moduleType can be one of 'apt', 'fml' or 'xdoc'. -->
<!-- The value is a comma separated list of -->
<!-- filenames or fileset patterns. -->
<!-- Here's an example: -->
<xdoc>changes.xml,navigation.xml</xdoc>
</moduleExcludes>
  • 类型java.util.Map
  • 必需No

输出目录

包含生成的项目站点和报告分发的目录。
  • 类型java.io.File
  • 必需Yes
  • 表达式${siteOutputDirectory}
  • 默认${project.reporting.outputDirectory}

输出编码

指定输出编码。
  • 类型java.lang.String
  • 必需No
  • 表达式${outputEncoding}
  • 默认${project.reporting.outputEncoding}

存储库

用于项目的远程存储库。
  • 类型java.util.List
  • 必需No
  • 表达式${project.remoteArtifactRepositories}

站点目录

包含 site.xml 文件和 apt、fml 和 xdoc 文档源的目录。
  • 类型java.io.File
  • 必需Yes
  • 表达式${basedir}/src/site

模板

已弃用。改用 templateFile 或蒙皮
默认模板页面。
  • 类型java.lang.String
  • 必需No
  • 表达式${template}

模板目录

已弃用。改用 templateFile 或蒙皮
包含模板页面的目录。
  • 类型java.io.File
  • 必需No
  • 表达式${templateDirectory}
  • 默认src/site

模板文件

要使用的 Velocity 模板文件的位置。使用时,皮肤和默认模板、CSS 和图像被禁用。强烈建议您将其打包为皮肤。
  • 类型java.io.File
  • 2.0-beta-5
  • 必需No
  • 表达式${templateFile}

xdoc目录

xdoc 源的替代目录,对 m1 到 m2 迁移很有用
  • 类型java.io.File
  • 必需No
  • 默认${basedir}/xdocs