Usage

Formats

Format is the term used to describe a particular output option for a DocBook transformation. For example, we might talk about the PDF output format, or the HTML output format.

Staging

The jDocBook Plugin uses staging for handling of images, css and fonts in a consistent manner. All of these resources miight come from multiple sources and DocBook, generally speaking, only allows defining a single path for resources. To get around that, the jDocBook Plugin collects all those resources together under a single staging directory. By default, this directory is target/staging directory, and each type of resource is under that. In general there is not much to configure here, although you can point at alternate source directories for css, fonts and images:

<plugin>
    <groupId>org.jboss.maven.plugins</groupId>
    <artifacId>maven-jdocbook-plugin</artifactId>
    <extensions>true</extensions>
    <configuration>
        ...
        <imagesDirectory>path/to/alternate/image/dir</imagesDirectory>
        <cssDirectory>path/to/alternate/css/dir</cssDirectory>
        <fontsDirectory>path/to/alternate/fonts/dir</fontsDirectory>
    </configuration>
</plugin>

Or to an alternate location to use for staging:

<plugin>
    <groupId>org.jboss.maven.plugins</groupId>
    <artifacId>maven-jdocbook-plugin</artifactId>
    <extensions>true</extensions>
    <configuration>
        ...
        <stagingDirectory>path/to/alternate/staging/dir</stagingDirectory>
    </configuration>
</plugin>