org.jboss.maven.plugins.jdocbook

Class AbstractDocBookMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.jboss.maven.plugins.jdocbook.AbstractDocBookMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

Direct Known Subclasses:

CleanPoMojo, CleanPotMojo, GenerationMojo, PackageMojo, ResourceMojo, TranslationMojo, UpdatePoMojo, UpdatePotMojo

public abstract class AbstractDocBookMojo
extends org.apache.maven.plugin.AbstractMojo

Basic support for the various DocBook mojos in this packaging plugin. Mainly, we are defining common configuration attributes of the packaging.

Author:

Steve Ebersole

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractDocBookMojo.ArtifactProcessor
protected static interface	AbstractDocBookMojo.I18nSource
protected class	AbstractDocBookMojo.MasterTranslationDescriptor
protected static interface	AbstractDocBookMojo.PublishingSource
protected class	AbstractDocBookMojo.TranslationDescriptor

Field Summary

Fields

Modifier and Type	Field and Description
protected org.codehaus.plexus.archiver.manager.ArchiverManager	archiverManager INTERNAL : used to get reference to environemtn Archiver/UnArchiver.
protected boolean	attach Whether or not to perform the attching of the format outputs as classified attachments.
protected org.apache.maven.model.Resource	cssResource A Resource describing project-local css.
protected File	fontsDirectory The directory containing local fonts
protected Format[]	formats The formats in which to perform rendering.
protected org.apache.maven.model.Resource	imageResource A Resource describing project-local images.
protected String	masterTranslation The locale of the master translation.
protected Options	options Configurable options
static String	PLUGIN_NAME
protected List	pluginArtifacts INTERNAL : The artifacts associated to the dependencies defined as part of our configuration within the project to which we are being attached.
protected File	potDirectory The directory for POT translations files.
protected org.apache.maven.project.MavenProject	project INTERNAL : The project being built
protected Set	projectArtifacts INTERNAL : The artifacts associated with the dependencies defined as part of the project to which we are being attached.
protected org.apache.maven.project.MavenProjectHelper	projectHelper INTERNAL : used during packaging to attach produced artifacts
protected File	publishDirectory The directory where the output will be written.
protected String	relativeMasterTranslationPath The path (relative to the sourceDirectory) to the directory containing the master sources.
protected org.apache.maven.execution.MavenSession	session INTERNAL : The representation of the maven execution.
protected File	sourceDirectory The directory where the sources are located.
protected String	sourceDocumentName The name of the document (relative to sourceDirectory) which is the document to be rendered.
protected File	stagingDirectory The directory where we can perform some staging staging occurs.
protected File	translationBaseDirectory The directory which contains the translations.
protected String[]	translations The locales of all non-master translations.
protected File	workDirectory A directory used for general transient work.

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

ROLE

Constructor Summary

Constructors

Constructor and Description
AbstractDocBookMojo()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doExecute()
void	execute()
protected List<AbstractDocBookMojo.I18nSource>	getI18nSources()
protected AbstractDocBookMojo.MasterTranslationDescriptor	getMasterTranslationDescriptor()
protected List<AbstractDocBookMojo.PublishingSource>	getPublishingSources()
protected String	getRequestedFormat()
protected Locale	getRequestedLocale()
protected Locale	parseLocale(String locale)
protected void	process(FormatPlan[] formatPlans) The override method to perform the actual processing of the mojo.
protected void	processArtifacts(AbstractDocBookMojo.ArtifactProcessor processor)
protected void	processPluginArtifacts(AbstractDocBookMojo.ArtifactProcessor processor)
protected void	processProjectArtifacts(AbstractDocBookMojo.ArtifactProcessor processor)
protected String	stringify(Locale locale)

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 Detail

PLUGIN_NAME

public static final String PLUGIN_NAME

See Also:

Constant Field Values

project

protected org.apache.maven.project.MavenProject project

INTERNAL : The project being built

session

protected org.apache.maven.execution.MavenSession session

INTERNAL : The representation of the maven execution.

projectArtifacts

protected Set projectArtifacts

INTERNAL : The artifacts associated with the dependencies defined as part of the project to which we are being attached.

pluginArtifacts

protected List pluginArtifacts

INTERNAL : The artifacts associated to the dependencies defined as part of our configuration within the project to which we are being attached.

archiverManager

protected org.codehaus.plexus.archiver.manager.ArchiverManager archiverManager

INTERNAL : used to get reference to environemtn Archiver/UnArchiver.

projectHelper

protected org.apache.maven.project.MavenProjectHelper projectHelper

INTERNAL : used during packaging to attach produced artifacts

sourceDocumentName

protected String sourceDocumentName

The name of the document (relative to sourceDirectory) which is the document to be rendered.

sourceDirectory

protected File sourceDirectory

The directory where the sources are located.

imageResource

protected org.apache.maven.model.Resource imageResource

A Resource describing project-local images.

cssResource

protected org.apache.maven.model.Resource cssResource

A Resource describing project-local css.

fontsDirectory

protected File fontsDirectory

The directory containing local fonts

publishDirectory

protected File publishDirectory

The directory where the output will be written.

stagingDirectory

protected File stagingDirectory

The directory where we can perform some staging staging occurs. Mainly this is used for (1) image/css staging; (2) font staging.

workDirectory

protected File workDirectory

A directory used for general transient work.

formats

protected Format[] formats

The formats in which to perform rendering.

attach

protected boolean attach

Whether or not to perform the attching of the format outputs as classified attachments.

options

protected Options options

Configurable options

masterTranslation

protected String masterTranslation

The locale of the master translation.

relativeMasterTranslationPath

protected String relativeMasterTranslationPath

The path (relative to the sourceDirectory) to the directory containing the master sources. By default the master-translation's locale (en-US) will be used if such a directory exists if translations are specified. Users can explicitly specify such a relative path here.

potDirectory

protected File potDirectory

The directory for POT translations files.

translations

protected String[] translations

The locales of all non-master translations.

translationBaseDirectory

protected File translationBaseDirectory

The directory which contains the translations. The assumed strategy here is that each translation would have a directory under the directory named here which would contain the PO sources for that particular language translation. The default here is to use sourceDirectory itself.

Constructor Detail

AbstractDocBookMojo

public AbstractDocBookMojo()

Method Detail

process

protected void process(FormatPlan[] formatPlans)
                throws JDocBookProcessException

The override method to perform the actual processing of the mojo.

Parameters:

formatPlans - The format plans

Throws:

RenderingException - Indicates problem performing rendering

XSLTException - Indicates problem building or executing XSLT transformer

JDocBookProcessException

doExecute

protected void doExecute()
                  throws JDocBookProcessException

Throws:

JDocBookProcessException

execute

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

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

getRequestedFormat

protected String getRequestedFormat()

getRequestedLocale

protected Locale getRequestedLocale()

getMasterTranslationDescriptor

protected AbstractDocBookMojo.MasterTranslationDescriptor getMasterTranslationDescriptor()

getPublishingSources

protected List<AbstractDocBookMojo.PublishingSource> getPublishingSources()

getI18nSources

protected List<AbstractDocBookMojo.I18nSource> getI18nSources()

processArtifacts

protected void processArtifacts(AbstractDocBookMojo.ArtifactProcessor processor)

processProjectArtifacts

protected void processProjectArtifacts(AbstractDocBookMojo.ArtifactProcessor processor)

processPluginArtifacts

protected void processPluginArtifacts(AbstractDocBookMojo.ArtifactProcessor processor)

parseLocale

protected Locale parseLocale(String locale)

stringify

protected String stringify(Locale locale)