Package org.apache.maven.plugins.site.render

Class SiteMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.apache.maven.plugins.site.AbstractSiteMojo

org.apache.maven.plugins.site.descriptor.AbstractSiteDescriptorMojo

org.apache.maven.plugins.site.render.AbstractSiteRenderingMojo

org.apache.maven.plugins.site.render.SiteMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo, org.codehaus.plexus.personality.plexus.lifecycle.phase.Contextualizable

Direct Known Subclasses:

SiteJarMojo

@Mojo(name="site",
      requiresDependencyResolution=TEST,
      requiresReports=true)
public class SiteMojo
extends AbstractSiteRenderingMojo

Generates the site for a single project.

Note that links between module sites in a multi module build will not work, since local build directory structure doesn't match deployed site.

Version:

$Id: SiteMojo.java 1754182 2016-07-26 21:35:00Z hboutemy $

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	generateReports	Convenience parameter that allows you to disable report generation.
private boolean	generateSitemap	Generate a sitemap.
protected File	outputDirectory	Directory where the project sites and report distributions will be generated.
private boolean	validate	Whether to validate xml input documents.

Fields inherited from class org.apache.maven.plugins.site.render.AbstractSiteRenderingMojo

generatedSiteDirectory, mavenSession, reports, siteRenderer

Fields inherited from class org.apache.maven.plugins.site.descriptor.AbstractSiteDescriptorMojo

repositories, siteDirectory

Fields inherited from class org.apache.maven.plugins.site.AbstractSiteMojo

i18n, localRepository, project, reactorProjects, siteTool, skip

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor	Description
SiteMojo()

Method Summary

Modifier and Type	Method	Description
void	execute()	Generate the project site
private File	getOutputDirectory(Locale locale)
org.apache.maven.project.MavenProject	getProject()
org.apache.maven.execution.MavenSession	getSession()
private List<org.apache.maven.doxia.siterenderer.DocumentRenderer>	renderDoxiaDocuments(Map<String,org.apache.maven.doxia.siterenderer.DocumentRenderer> documents, org.apache.maven.doxia.siterenderer.SiteRenderingContext context, File outputDir, boolean generated)	Render Doxia documents from the list given, but not reports.
private void	renderLocale(Locale locale, List<org.apache.maven.reporting.exec.MavenReportExecution> reports)

Methods inherited from class org.apache.maven.plugins.site.render.AbstractSiteRenderingMojo

categoriseReports, checkInputEncoding, contextualize, createSiteRenderingContext, getInputEncoding, getOutputEncoding, getReports, locateDocuments, locateReports, populateReportItems

Methods inherited from class org.apache.maven.plugins.site.descriptor.AbstractSiteDescriptorMojo

prepareDecorationModel

Methods inherited from class org.apache.maven.plugins.site.AbstractSiteMojo

getLocales, getMavenVersion, isMaven3OrMore

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

outputDirectory

@Parameter(property="siteOutputDirectory",
           defaultValue="${project.reporting.outputDirectory}")
protected File outputDirectory

Directory where the project sites and report distributions will be generated.

generateReports

@Parameter(property="generateReports",
           defaultValue="true")
private boolean generateReports

Convenience parameter that allows you to disable report generation.

generateSitemap

@Parameter(property="generateSitemap",
           defaultValue="false")
private boolean generateSitemap

Generate a sitemap. The result will be a "sitemap.html" file at the site root.

Since:

2.1

validate

@Parameter(property="validate",
           defaultValue="false")
private boolean validate

Whether to validate xml input documents. If set to true, all input documents in xml format (in particular xdoc and fml) will be validated and any error will lead to a build failure.

Since:

2.1.1

Constructor Details

SiteMojo

public SiteMojo()

Method Details

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException,
org.apache.maven.plugin.MojoFailureException

Generate the project site

throws MojoExecutionException if any

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

See Also:

• Mojo.execute()

renderLocale

private void renderLocale(Locale locale,
 List<org.apache.maven.reporting.exec.MavenReportExecution> reports)
                   throws IOException,
org.apache.maven.doxia.siterenderer.RendererException,
org.apache.maven.plugin.MojoFailureException,
org.apache.maven.plugin.MojoExecutionException

Throws:

IOException

org.apache.maven.doxia.siterenderer.RendererException

org.apache.maven.plugin.MojoFailureException

org.apache.maven.plugin.MojoExecutionException

renderDoxiaDocuments

private List<org.apache.maven.doxia.siterenderer.DocumentRenderer> renderDoxiaDocuments(Map<String,org.apache.maven.doxia.siterenderer.DocumentRenderer> documents,
 org.apache.maven.doxia.siterenderer.SiteRenderingContext context,
 File outputDir,
 boolean generated)
                                                                                 throws org.apache.maven.doxia.siterenderer.RendererException,
IOException

Render Doxia documents from the list given, but not reports.

Parameters:

documents - a collection of documents containing both Doxia source files and reports

Returns:

the sublist of documents that are not Doxia source files

Throws:

org.apache.maven.doxia.siterenderer.RendererException

IOException

getOutputDirectory

private File getOutputDirectory(Locale locale)

getProject

public org.apache.maven.project.MavenProject getProject()

getSession

public org.apache.maven.execution.MavenSession getSession()