public abstract class AbstractDocbkxMojo
extends org.apache.maven.plugin.AbstractMojo
Modifier and Type | Class and Description |
---|---|
static class |
AbstractDocbkxMojo.Format
Supported output formats.
|
static class |
AbstractDocbkxMojo.ProfileAttributes
Supported DocBook profile attributes.
|
Constructor and Description |
---|
AbstractDocbkxMojo() |
Modifier and Type | Method and Description |
---|---|
String |
areSectionsAutolabeled()
Whether sections should have numeric labels.
|
boolean |
doBuildReleaseZip()
Whether to build a .zip containing the release content.
|
boolean |
doCopyResourceFiles()
Whether to copy resource files alongside docs for site, release.
|
boolean |
doCreateArtifacts()
Whether to build artifacts from pre-processed sources.
|
String |
doesSectionLabelIncludeComponentLabel()
Whether section labels should include parent numbers,
like 1.1, 1.2, 1.2.1, 1.2.2.
|
boolean |
doOverwriteModifiableCopy()
Whether to overwrite the copy of DocBook sources if it exists.
|
boolean |
doOverwriteProjectFilesWithSharedContent()
Whether to overwrite project files with shared content.
|
boolean |
doUsePreProcessedSources()
Whether to build from pre-processed DocBook XML sources.
|
List<ArtifactItem> |
getArtifactItems()
Get the doc artifacts to unpack when preparing Backstage layout.
|
File |
getAsciidocSourceDirectory()
Get the base directory for Asciidoc source files.
|
String |
getAsciidoctorPluginVersion()
Returns the version of the Asciidoctor Maven plugin to use.
|
File |
getBackstageDirectory()
Get the file system directory for Backstage layout output.
|
String |
getBackstageProductName()
Get the product name as shown on Backstage.
|
ArrayList<org.twdata.maven.mojoexecutor.MojoExecutor.Element> |
getBaseConfiguration()
Get the base configuration applicable to all builds with the docbkx-tools plugin.
|
File |
getBaseDir()
Project base directory, needed to workaround bugs with *target.db and webhelp.
|
File |
getBootstrapCustomization()
Get the location of the HtmlForBootstrap XSL stylesheet customization file.
|
String |
getBrandingArtifactId()
Gets the branding artifactId to use.
|
String |
getBrandingGroupId()
Gets the groupId of the branding artifact to use.
|
String |
getBrandingVersion()
Gets the version of the branding artifact to use.
|
File |
getBuildDirectory()
Get the project build directory for this plugin.
|
File |
getChunkedHTMLCustomization()
Get the location of the chunked HTML XSL stylesheet customization file.
|
String |
getCommonContentArtifactId()
Get the
artifactId of the common content artifact. |
String |
getCommonContentGroupId()
Get the
groupId of the common content artifact. |
String |
getCommonContentVersion()
Get the version of the common content artifact to use.
|
File |
getDocbkxModifiableSourcesDirectory()
Get the base directory for the modifiable copy of DocBook XML source files.
|
File |
getDocbkxOutputDirectory()
Base directory for built documentation.
|
File |
getDocbkxSourceDirectory()
Get the base directory for DocBook XML source files.
|
String |
getDocbkxVersion()
Get the docbkx-tools plugin version to use.
|
Set<String> |
getDocNames()
Get document names for the current project.
|
String |
getDocsSite()
Get the URL to the site for published documentation.
|
String |
getDocumentSrcName()
Get the top-level DocBook XML source document name.
|
String |
getDraftWatermarkURL()
For draft mode, URL to the background watermark image.
|
String |
getEoslJson()
Get the URL to JSON object showing EOSL versions for each project.
|
File |
getEpubCustomization()
Get the location of the EPUB XSL stylesheet customization file.
|
Map<String,String> |
getExclusions()
Returns a map of DocBook profile settings to exclude elements.
|
String |
getFaviconLink()
Get the favicon link element for the pre-site version of the HTML.
|
File |
getFoCustomization()
Get the location of the FO XSL stylesheet customization file (for PDF, RTF).
|
File |
getFontsDirectory()
Directory where fonts and font metrics are stored.
|
String |
getFopHyphVersion()
Get the version of the FOP hyphenation plugin to use.
|
String |
getFopLogLevel()
Log level when building FO output (PDF, RTF).
|
List<AbstractDocbkxMojo.Format> |
getFormats()
Return a list of output formats to generate.
|
String |
getGoogleAnalyticsId()
Google Analytics identifier for the project.
|
Map<String,String> |
getInclusions()
Returns a map of DocBook profile settings to include elements.
|
String |
getJavaScriptFileName()
Get the main JavaScript file name, found under
/js/ in plugin resources. |
List<File> |
getJCiteSourcePaths()
Get the source paths where cited Java files are found.
|
String |
getJCiteVersion()
Get the JCite artifact version to use for Java code citations.
|
String |
getLatestJson()
Get the URL to JSON object showing latest versions for each project.
|
String |
getLinkTesterVersion()
ForgeRock link tester plugin version to use.
|
String |
getLocaleTag()
Get the Locale tag for the documentation set.
|
File |
getManpagesCustomization()
Get the location of the man page XSL stylesheet customization file.
|
String |
getMavenAssemblyVersion()
Get the version of the Maven dependency plugin to use.
|
String |
getMavenDependencyVersion()
Get the version of the Maven dependency plugin to use.
|
String |
getMavenFilteringVersion()
Get the version of the Maven filtering library to use.
|
String |
getMavenResourcesVersion()
Get the Maven resources plugin version.
|
int |
getMaxImageHeightInInches()
Get maximum height for PNG images used in PDF, in inches.
|
String |
getPlantUmlVersion()
Get the version of the PlantUML artifact.
|
String |
getPlexusUtilsVersion()
Return the version of Plexus Utils used by the XCite Maven plugin.
|
org.apache.maven.plugin.BuildPluginManager |
getPluginManager()
Get the Maven
BuildPluginManager object. |
File |
getPreSiteCss()
Get the CSS file for the pre-site version of the HTML.
|
org.apache.maven.project.MavenProject |
getProject()
Get the
MavenProject object. |
String |
getProjectName()
Short name of the project, such as OpenAM, OpenDJ, OpenIDM.
|
String |
getProjectVersion()
Get the project version.
|
String |
getRelativeResourcesDirectoryPath()
Path to arbitrary documentation set resources,
relative to the modifiable sources directory.
|
File |
getReleaseCss()
Get the CSS file for the release version of the HTML.
|
String |
getReleaseDate()
Get the software release date.
|
File |
getReleaseDirectory()
Get the file system directory for release layout documentation.
|
String |
getReleaseFaviconLink()
Get the favicon link element for the release version of the HTML.
|
String |
getReleaseVersion()
Get the version for this release.
|
String |
getReleaseVersionPath()
Get the path to the directory to hold the release version documents,
such as
${project.build.directory}/release/1.0.0 . |
File |
getResourcesDirectory()
Directory for arbitrary documentation set resources.
|
org.apache.maven.execution.MavenSession |
getSession()
Get the
MavenSession object. |
File |
getSingleHTMLCustomization()
Get the location of the single page HTML XSL stylesheet customization file.
|
File |
getSiteDirectory()
Get the file system directory for site content.
|
String[] |
getSkipUrlPatterns()
Get regex patterns of URLs to skip when checking external links.
|
File |
getWebHelpCss()
Get the location of the main CSS file for webhelp documents.
|
File |
getWebHelpCustomization()
Get the location of the webhelp XSL stylesheet customization file.
|
File |
getWebHelpLogo()
Get the location of the logo image for webhelp documents.
|
String |
getXCiteVersion()
Return the version of the XCite Maven plugin to use.
|
File |
getXhtml5Customization()
Location of the XHTML5 XSL stylesheet customization file,
relative to the build directory.
|
String |
isDraftMode()
Whether these are draft documents, rather than final documents.
|
String |
isXincludeSupported()
Whether documents should be allowed to include other documents.
|
boolean |
keepCustomIndexHtml()
Whether to keep a custom index.html file for the documentation set.
|
String |
path(File file)
Get path name in UNIX format.
|
String |
runLinkTester()
Whether to run the ForgeRock link tester plugin.
|
String |
skipLinkCheck()
Whether the ForgeRock link tester plugin should skip checking
that external URLs are valid.
|
String |
useAnsi()
Whether to use WinAnsi encoding for embedded fonts.
|
String |
useSyntaxHighlighting()
Whether <programlisting> content has syntax highlighting.
|
getLog, getPluginContext, setLog, setPluginContext
public final String useAnsi()
false
public final String areSectionsAutolabeled()
true
public File getAsciidocSourceDirectory()
${basedir}/src/main/asciidoc
.public String getAsciidoctorPluginVersion()
public File getBackstageDirectory()
${project.build.directory}/backstage
public String getBackstageProductName()
projectName
public ArrayList<org.twdata.maven.mojoexecutor.MojoExecutor.Element> getBaseConfiguration()
public File getBaseDir()
${basedir}
public String getBrandingArtifactId()
doc-default-branding
.public String getBrandingGroupId()
org.forgerock.commons
public String getBrandingVersion()
public File getBuildDirectory()
${project.build.directory}
.public final boolean doBuildReleaseZip()
false
public final File getChunkedHTMLCustomization()
${project.build.directory}/docbkx-stylesheets/html/chunked.xsl
public String getCommonContentArtifactId()
artifactId
of the common content artifact.
forgerock-doc-common-content
.artifactId
of the common content artifact.public String getCommonContentGroupId()
groupId
of the common content artifact.
org.forgerock.commons
.groupId
of the common content artifact.public String getCommonContentVersion()
public boolean doCopyResourceFiles()
public boolean doCreateArtifacts()
public List<ArtifactItem> getArtifactItems()
public File getDocbkxModifiableSourcesDirectory()
${project.build.directory}/docbkx-sources
public File getDocbkxOutputDirectory()
${project.build.directory}/docbkx
public File getDocbkxSourceDirectory()
${basedir}/src/main/docbkx
.public String getDocbkxVersion()
public Map<String,String> getInclusions()
public Map<String,String> getExclusions()
public Set<String> getDocNames() throws org.apache.maven.plugin.MojoExecutionException
org.apache.maven.plugin.MojoExecutionException
- No document names found.public String getDocsSite()
http://docs.forgerock.org/
public String getDocumentSrcName()
index.xml
.
src/main/docbkx/ admin-guide/ index.xml ...other files... dev-guide/ index.xml ...other files... install-guide/ index.xml ...other files... reference/ index.xml ...other files... release-notes/ index.xml ...other files... shared/ ...other files...
...other files...
can have whatever names you want,
as long as the name does not match the file name you configure.
For example, if you were to hand-code an index file
you could name it ix.xml
.public final String doesSectionLabelIncludeComponentLabel()
true
public final String getDraftWatermarkURL()
http://docbook.sourceforge.net/release/images/draft.png
public String getEoslJson()
public final File getEpubCustomization()
${project.build.directory}/docbkx-stylesheets/epub/coredoc.xsl
public final String getFaviconLink()
public final File getFoCustomization()
${project.build.directory}/docbkx-stylesheets/fo/coredoc.xsl
public final File getFontsDirectory()
${project.build.directory}/fonts
public String getFopHyphVersion()
public final String getFopLogLevel()
ERROR
public List<AbstractDocbkxMojo.Format> getFormats()
public String getGoogleAnalyticsId()
UA-23412190-14
public final String isDraftMode()
yes
public final String isXincludeSupported()
true
public String getJavaScriptFileName()
/js/
in plugin resources.
uses-jquery.js
public List<File> getJCiteSourcePaths()
src/main/java
is used.public String getJCiteVersion()
public boolean keepCustomIndexHtml()
false
public String getLatestJson()
public String getLinkTesterVersion()
public String getLocaleTag()
en
public final File getManpagesCustomization()
${project.build.directory}/docbkx-stylesheets/man/coredoc.xsl
public String getMavenAssemblyVersion()
public String getMavenDependencyVersion()
public String getMavenFilteringVersion()
public String getMavenResourcesVersion()
public int getMaxImageHeightInInches()
public boolean doOverwriteModifiableCopy()
docbkxModifiableSourcesDirectory
,
then you can set this to false
to prevent the plugin from replacing the copy.
The plugin will then pre-process the copy, however,
so expect the files in the modifiable copy to be changed.
public boolean doOverwriteProjectFilesWithSharedContent()
public String path(File file)
file
- Path to return in UNIX format.public String getPlantUmlVersion()
public String getPlexusUtilsVersion()
public org.apache.maven.plugin.BuildPluginManager getPluginManager()
BuildPluginManager
object.BuildPluginManager
object.public final File getPreSiteCss()
${project.build.directory}/coredoc.css
public org.apache.maven.project.MavenProject getProject()
MavenProject
object.MavenProject
object.public String getProjectName()
public String getProjectVersion()
public final File getReleaseCss()
${project.build.directory}/dfo.css
public String getReleaseDate()
public final File getReleaseDirectory()
${project.build.directory}/release
releaseDirectory
public final String getReleaseFaviconLink()
public final String getReleaseVersion()
public final String getReleaseVersionPath()
${project.build.directory}/release/1.0.0
.public String getRelativeResourcesDirectoryPath()
resources
public File getResourcesDirectory()
${basedir}/src/main/docbkx/resources
public String runLinkTester()
"true"
public org.apache.maven.execution.MavenSession getSession()
MavenSession
object.MavenSession
object.public final File getSingleHTMLCustomization()
${project.build.directory}/docbkx-stylesheets/html/coredoc.xsl
public final File getSiteDirectory()
${project.build.directory}/site
public String skipLinkCheck()
skipUrls
parameter of the linktester plugin.
false
public String[] getSkipUrlPatterns()
null
public boolean doUsePreProcessedSources()
Default: false
docbkxSourceDirectory
contains fully pre-processed sources.public final String useSyntaxHighlighting()
1
(true)
public final File getWebHelpCss()
${project.build.dir}/docbkx-stylesheets/webhelp/positioning.css
public final File getWebHelpCustomization()
${project.build.dir}/docbkx-stylesheets/webhelp/coredoc.xsl
public final File getWebHelpLogo()
${project.build.dir}/docbkx-stylesheets/webhelp/logo.png
public String getXCiteVersion()
public final File getXhtml5Customization()
${project.build.directory}/docbkx-stylesheets/xhtml5/coredoc.xsl
${project.build.directory}/docbkx-stylesheets/xhtml5/coredoc.xsl
public final File getBootstrapCustomization()
${project.build.directory}/docbkx-stylesheets/bootstrap/coredoc.xsl
Copyright © 2025 Open Identity Platform Community. All rights reserved.