Package org.codehaus.gmavenplus.mojo
Class AbstractGroovyDocMojo
java.lang.Object
org.apache.maven.plugin.AbstractMojo
org.codehaus.gmavenplus.mojo.AbstractGroovyMojo
org.codehaus.gmavenplus.mojo.AbstractGroovySourcesMojo
org.codehaus.gmavenplus.mojo.AbstractGroovyDocMojo
- All Implemented Interfaces:
org.apache.maven.plugin.ContextEnabled,org.apache.maven.plugin.Mojo
- Direct Known Subclasses:
GroovyDocMojo,GroovyDocTestsMojo
The base GroovyDoc mojo, which all GroovyDoc mojos extend.
- Author:
- Keegan Witt
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected booleanEnable attaching GroovyDoc annotation.protected StringAllows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ClasspathResourceManager, for use when creating custom GroovyDoc implementations.protected String[]Override the default Groovydoc class-level templates.protected String[]Override the default Groovydoc default top-level templates.protected String[]Override the default Groovydoc package-level templates.protected booleanWhether to display the author in the generated GroovyDoc.protected StringThe page title.protected StringAllows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.FileOutputTool, for use when creating custom GroovyDoc implementations.protected StringThe page footer.protected booleanWhether to execute in a forked process.protected static final VersionGroovy 1.5.8 version.protected static final VersionGroovy 1.6.0 RC-1 version.protected StringAllows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.GroovyDocTool, for use when creating custom GroovyDoc implementations.protected StringThe page header.protected IncludeClasspathWhat classpath to include.protected LanguageLevelThe Java language level to use for GroovyDoc generation.protected StringAllows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.LinkArgument (or org.codehaus.groovy.ant.Groovydoc$LinkArgument for Groovy older than 1.6-RC-2), for use when creating custom GroovyDoc implementations.Links to include in the generated GroovyDoc (key is link href, value is comma-separated packages to use that link).protected StringAllows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.OutputTool, for use when creating custom GroovyDoc implementations.protected FileThe HTML file to be used for overview documentation.protected StringAllows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ResourceManager, for use when creating custom GroovyDoc implementations.protected StringThe scope to generate GroovyDoc for.protected org.apache.maven.execution.MavenSessionThe Maven Session.protected booleanFlag to allow GroovyDoc generation to be skipped.protected StringThe encoding of stylesheetFile.protected FileThe stylesheet file (absolute path) to copy to output directory (will overwrite default stylesheet.css).protected org.apache.maven.toolchain.ToolchainManagerThe Maven ToolchainManager.protected StringThe window title.Fields inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovySourcesMojo
MAIN, TESTFields inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovyMojo
classWrangler, GROOVY_1_5_0, GROOVY_SOURCES_PATTERN, JAVA_1_7, JAVA_1_8, JAVA_12, JAVA_SOURCES_PATTERN, minGroovyVersion, mojoExecution, pluginArtifacts, pluginDescriptor, projectFields inherited from interface org.apache.maven.plugin.Mojo
ROLE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected Stringprotected voidcopyStylesheet(File outputDirectory) Copies the stylesheet to the specified output directory.protected voiddoGroovyDocGeneration(org.apache.maven.shared.model.fileset.FileSet[] sourceDirectories, List<?> classpath, File outputDirectory) Generates the GroovyDoc for the specified sources.protected voidperformForkedGroovyDocGeneration(GroovyDocConfiguration configuration, String javaExecutable) protected voidperformInProcessGroovyDocGeneration(GroovyDocConfiguration configuration) protected PropertiesSets up the documentation properties.Methods inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovySourcesMojo
getFiles, getFilesets, getTestFiles, getTestFilesetsMethods inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovyMojo
getJavaExecutable, getJavaVersion, getJavaVersionString, groovyAtLeast, groovyIs, groovyNewerThan, groovyOlderThan, groovyVersionSupportsAction, isGroovyIndy, isJavaSupportIndy, isJavaSupportParameters, isJavaSupportPreviewFeatures, logPluginClasspath, setupClassWranglerMethods inherited from class org.apache.maven.plugin.AbstractMojo
getLog, getPluginContext, setLog, setPluginContextMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.apache.maven.plugin.Mojo
execute
-
Field Details
-
GROOVY_1_6_0_RC1
Groovy 1.6.0 RC-1 version. -
GROOVY_1_5_8
Groovy 1.5.8 version. -
windowTitle
The window title. -
docTitle
The page title. -
languageLevel
The Java language level to use for GroovyDoc generation. -
header
The page header. -
displayAuthor
@Parameter(defaultValue="true") protected boolean displayAuthorWhether to display the author in the generated GroovyDoc. -
overviewFile
The HTML file to be used for overview documentation. -
stylesheetFile
The stylesheet file (absolute path) to copy to output directory (will overwrite default stylesheet.css). -
stylesheetEncoding
The encoding of stylesheetFile. -
scope
The scope to generate GroovyDoc for. Should be one of:- "public"
- "protected"
- "package"
- "private"
-
links
Links to include in the generated GroovyDoc (key is link href, value is comma-separated packages to use that link).- Since:
- 1.0-beta-2
-
skipGroovyDoc
@Parameter(property="skipGroovydoc", defaultValue="false") protected boolean skipGroovyDocFlag to allow GroovyDoc generation to be skipped.- Since:
- 1.6
-
includeClasspath
What classpath to include. One of- PROJECT_ONLY
- PROJECT_AND_PLUGIN
- PLUGIN_ONLY
- Since:
- 1.8.0
-
defaultDocTemplates
Override the default Groovydoc default top-level templates. Uses Groovy's standard templates by default.- Since:
- 1.10.1
-
defaultPackageTemplates
Override the default Groovydoc package-level templates. Uses Groovy's standard templates by default.- Since:
- 1.10.1
-
defaultClassTemplates
Override the default Groovydoc class-level templates. Uses Groovy's standard templates by default.- Since:
- 1.10.1
-
groovyDocToolClass
Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.GroovyDocTool, for use when creating custom GroovyDoc implementations.- Since:
- 1.10.1
-
outputToolClass
Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.OutputTool, for use when creating custom GroovyDoc implementations.- Since:
- 1.10.1
-
fileOutputToolClass
Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.FileOutputTool, for use when creating custom GroovyDoc implementations.- Since:
- 1.10.1
-
resourceManagerClass
Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ResourceManager, for use when creating custom GroovyDoc implementations.- Since:
- 1.10.1
-
classpathResourceManagerClass
Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ClasspathResourceManager, for use when creating custom GroovyDoc implementations.- Since:
- 1.10.1
-
linkArgumentClass
Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.LinkArgument (or org.codehaus.groovy.ant.Groovydoc$LinkArgument for Groovy older than 1.6-RC-2), for use when creating custom GroovyDoc implementations.- Since:
- 1.10.1
-
attachGroovyDocAnnotation
@Parameter(defaultValue="false") protected boolean attachGroovyDocAnnotationEnable attaching GroovyDoc annotation. Requires Groovy 3.0.0 alpha-4 or newer.- Since:
- 1.11.0
-
toolchainManager
@Inject protected org.apache.maven.toolchain.ToolchainManager toolchainManagerThe Maven ToolchainManager. -
session
@Parameter(defaultValue="${session}", readonly=true, required=true) protected org.apache.maven.execution.MavenSession sessionThe Maven Session. -
fork
@Parameter(property="fork", defaultValue="false") protected boolean forkWhether to execute in a forked process.- Since:
- 4.3.0
-
-
Constructor Details
-
AbstractGroovyDocMojo
public AbstractGroovyDocMojo()
-
-
Method Details
-
performInProcessGroovyDocGeneration
protected void performInProcessGroovyDocGeneration(GroovyDocConfiguration configuration) throws ClassNotFoundException, InvocationTargetException, IllegalAccessException, InstantiationException, MalformedURLException -
performForkedGroovyDocGeneration
protected void performForkedGroovyDocGeneration(GroovyDocConfiguration configuration, String javaExecutable) throws InvocationTargetException - Throws:
InvocationTargetException
-
buildForkClasspath
-
setupProperties
Sets up the documentation properties.- Returns:
- the documentation properties
-
copyStylesheet
Copies the stylesheet to the specified output directory.- Parameters:
outputDirectory- The output directory to copy the stylesheet to