site:stage-deploy

Full name:

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

Description:

Deploys the generated site to a staging or mock directory to the site URL specified in the <distributionManagement> section of the POM. It supports scp and file protocols for deployment.

Attributes:

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

Required Parameters

Name Type Since Description
generatedSiteDirectory File - Directory containing generated documentation.
outputDirectory File - Directory containing the generated project sites and report distributions.
Default value is: ${project.reporting.outputDirectory}.
siteDirectory File - Directory containing the site.xml file and the source for apt, fml and xdoc docs.

Optional Parameters

Name Type Since Description
attributes Map - The template properties for rendering the site.
generateReports boolean - Convenience parameter that allows you to disable report generation.
Default value is: true.
inputEncoding String - Specifies the input encoding.
Default value is: ${project.build.sourceEncoding}.
localRepository ArtifactRepository - The local repository.
locales String - 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.
moduleExcludes Map - Module type exclusion mappings ex: fml -> **/*-m1.fml (excludes fml files ending in '-m1.fml' recursively)

The configuration looks like this:
<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>

outputEncoding String - Specifies the output encoding.
Default value is: ${project.reporting.outputEncoding}.
repositories List - Remote repositories used for the project.
stagingDirectory File - Staging directory location. This needs to be an absolute path, like C:\stagingArea\myProject\ on Windows or /stagingArea/myProject/ on Unix.
stagingRepositoryId String 2.0.1 The identifier of the repository where the staging site will be deployed. This id will be used to lookup a corresponding <server> entry from the settings.xml. If a matching <server> entry is found, its configured credentials will be used for authentication.
Default value is: stagingSite.
stagingSiteURL String - The staged site will be deployed to this URL. If you don't specify this, the default-value will be "${project.distributionManagement.site.url}/staging", where "project" is either the current project or, in a reactor build, the top level project in the reactor.
template String - Deprecated. use templateFile or skinning instead
templateDirectory File - Deprecated. use templateFile or skinning instead
Default value is: src/site.
templateFile File 2.0-beta-5 The location of a Velocity template file to use. When used, skins and the default templates, CSS and images are disabled. It is highly recommended that you package this as a skin instead.
xdocDirectory File - Alternative directory for xdoc source, useful for m1 to m2 migration
Default value is: ${basedir}/xdocs.

Parameter Details

attributes:

The template properties for rendering the site.
  • Type: java.util.Map
  • Required: No
  • Expression: ${attributes}

generateReports:

Convenience parameter that allows you to disable report generation.
  • Type: boolean
  • Required: No
  • Expression: ${generateReports}
  • Default: true

generatedSiteDirectory:

Directory containing generated documentation.
  • Type: java.io.File
  • Required: Yes
  • Expression: ${project.build.directory}/generated-site

inputEncoding:

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

localRepository:

The local repository.
  • Type: org.apache.maven.artifact.repository.ArtifactRepository
  • Required: No
  • Expression: ${localRepository}

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
  • Required: No
  • Expression: ${locales}

moduleExcludes:

Module type exclusion mappings ex: fml -> **/*-m1.fml (excludes fml files ending in '-m1.fml' recursively)

The configuration looks like this:
<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>
  • Type: java.util.Map
  • Required: No

outputDirectory:

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

outputEncoding:

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

repositories:

Remote repositories used for the project.
  • Type: java.util.List
  • Required: No
  • Expression: ${project.remoteArtifactRepositories}

siteDirectory:

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

stagingDirectory:

Staging directory location. This needs to be an absolute path, like C:\stagingArea\myProject\ on Windows or /stagingArea/myProject/ on Unix.
  • Type: java.io.File
  • Required: No
  • Expression: ${stagingDirectory}

stagingRepositoryId:

The identifier of the repository where the staging site will be deployed. This id will be used to lookup a corresponding <server> entry from the settings.xml. If a matching <server> entry is found, its configured credentials will be used for authentication.
  • Type: java.lang.String
  • Since: 2.0.1
  • Required: No
  • Expression: ${stagingRepositoryId}
  • Default: stagingSite

stagingSiteURL:

The staged site will be deployed to this URL. If you don't specify this, the default-value will be "${project.distributionManagement.site.url}/staging", where "project" is either the current project or, in a reactor build, the top level project in the reactor.
  • Type: java.lang.String
  • Required: No
  • Expression: ${stagingSiteURL}

template:

Deprecated. use templateFile or skinning instead
Default template page.
  • Type: java.lang.String
  • Required: No
  • Expression: ${template}

templateDirectory:

Deprecated. use templateFile or skinning instead
Directory containing the template page.
  • Type: java.io.File
  • Required: No
  • Expression: ${templateDirectory}
  • Default: src/site

templateFile:

The location of a Velocity template file to use. When used, skins and the default templates, CSS and images are disabled. It is highly recommended that you package this as a skin instead.
  • Type: java.io.File
  • Since: 2.0-beta-5
  • Required: No
  • Expression: ${templateFile}

xdocDirectory:

Alternative directory for xdoc source, useful for m1 to m2 migration
  • Type: java.io.File
  • Required: No
  • Default: ${basedir}/xdocs