site:stage

Full name:

org.apache.maven.plugins:maven-site-plugin:3.3:stage

Description:

Deploys the generated site to a local staging or mock directory based on the site URL specified in the <distributionManagement> section of the POM.

It can be used to test that links between module sites in a multi-module build work.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • Since version: 3.3.

Required Parameters

Name Type Since Description
inputDirectory File 3.3 Directory containing the generated project sites and report distributions.
Default value is: ${project.reporting.outputDirectory}.

Optional Parameters

Name Type Since Description
chmod boolean 2.1 Whether to run the "chmod" command on the remote site after the deploy. Defaults to "true".
Default value is: true.
User property is: maven.site.chmod.
chmodMode String 2.1 The mode used by the "chmod" command. Only used if chmod = true. Defaults to "g+w,a+rX".
Default value is: g+w,a+rX.
User property is: maven.site.chmod.mode.
chmodOptions String 2.1 The options used by the "chmod" command. Only used if chmod = true. Defaults to "-Rf".
Default value is: -Rf.
User property is: maven.site.chmod.options.
inputEncoding String 3.3 Specifies the input encoding.
Default value is: ${project.build.sourceEncoding}.
User property is: encoding.
locales String 3.3 A comma separated list of locales supported by Maven. The first valid token will be the default Locale for this instance of the Java Virtual Machine.
User property is: locales.
outputEncoding String 3.3 Specifies the output encoding.
Default value is: ${project.reporting.outputEncoding}.
User property is: outputEncoding.
siteDirectory File 3.3 Directory containing the site.xml file and the source for apt, fml and xdoc docs.
Default value is: ${basedir}/src/site.
skip boolean 3.2 Set this to 'true' to skip site generation and staging.
Default value is: false.
User property is: maven.site.skip.
skipDeploy boolean 3.0 Set this to 'true' to skip site deployment.
Default value is: false.
User property is: maven.site.deploy.skip.
stagingDirectory File 3.3 Staging directory location. This needs to be an absolute path, like C:\stagingArea\myProject\ on Windows or /stagingArea/myProject/ on Unix. If this is not specified, the site will be staged in ${project.build.directory}/staging.
User property is: stagingDirectory.
topSiteURL String 3.3 Top distribution management site url, for manual configuration when auto-calculated value doesn't match expectations. Relative module directory will be calculated from this url.
User property is: topSiteURL.

Parameter Details

chmod:

Whether to run the "chmod" command on the remote site after the deploy. Defaults to "true".
  • Type: boolean
  • Since: 2.1
  • Required: No
  • User Property: maven.site.chmod
  • Default: true

chmodMode:

The mode used by the "chmod" command. Only used if chmod = true. Defaults to "g+w,a+rX".
  • Type: java.lang.String
  • Since: 2.1
  • Required: No
  • User Property: maven.site.chmod.mode
  • Default: g+w,a+rX

chmodOptions:

The options used by the "chmod" command. Only used if chmod = true. Defaults to "-Rf".
  • Type: java.lang.String
  • Since: 2.1
  • Required: No
  • User Property: maven.site.chmod.options
  • Default: -Rf

inputDirectory:

Directory containing the generated project sites and report distributions.
  • Type: java.io.File
  • Since: 3.3
  • Required: Yes
  • Default: ${project.reporting.outputDirectory}

inputEncoding:

Specifies the input encoding.
  • Type: java.lang.String
  • Since: 3.3
  • Required: No
  • User Property: encoding
  • Default: ${project.build.sourceEncoding}

locales:

A comma separated list of locales supported by Maven. The first valid token will be the default Locale for this instance of the Java Virtual Machine.
  • Type: java.lang.String
  • Since: 3.3
  • Required: No
  • User Property: locales

outputEncoding:

Specifies the output encoding.
  • Type: java.lang.String
  • Since: 3.3
  • Required: No
  • User Property: outputEncoding
  • Default: ${project.reporting.outputEncoding}

siteDirectory:

Directory containing the site.xml file and the source for apt, fml and xdoc docs.
  • Type: java.io.File
  • Since: 3.3
  • Required: No
  • Default: ${basedir}/src/site

skip:

Set this to 'true' to skip site generation and staging.
  • Type: boolean
  • Since: 3.2
  • Required: No
  • User Property: maven.site.skip
  • Default: false

skipDeploy:

Set this to 'true' to skip site deployment.
  • Type: boolean
  • Since: 3.0
  • Required: No
  • User Property: maven.site.deploy.skip
  • Default: false

stagingDirectory:

Staging directory location. This needs to be an absolute path, like C:\stagingArea\myProject\ on Windows or /stagingArea/myProject/ on Unix. If this is not specified, the site will be staged in ${project.build.directory}/staging.
  • Type: java.io.File
  • Since: 3.3
  • Required: No
  • User Property: stagingDirectory

topSiteURL:

Top distribution management site url, for manual configuration when auto-calculated value doesn't match expectations. Relative module directory will be calculated from this url.
  • Type: java.lang.String
  • Since: 3.3
  • Required: No
  • User Property: topSiteURL