Maven 2 Site Plugin
The Maven 2 Site Plugin is used to generate a site for the project. The generated site also includes the project's reports that were configured in the <reporting>
section of the POM.
Goals Overview
The Site Plugin has seven goals:
- site:site
is used generate a site for a single project. Note that links between module sites in a multi module build will not
work.
- site:deploy
is used to deploy the generated site using scp
or file
protocol to the site specified in the <distributionManagement>
section of the POM.
- site:run
starts the site up, rendering documents as requested for faster editing. It uses Jetty as the web server.
- site:stage
generates a site in 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 works.
- site:stage-deploy
deploys the generated site to a staging or mock directory on the site specified in the <distributionManagement>
section of the POM. It also supports scp
and file
protocols for deployment.
- site:attach-descriptor
adds the site descriptor to the list of files to be installed/deployed. For more references of the site descriptor, here's a link
.
- site:jar
is used to bundle the site output into a jar.
Usage
Instructions on how to use the Site Plugin can be found here
.
Examples
The following examples show how to use the Site Plugin in more advanced usecases: