Transform Plugin

The transform plugin transforms an xml document with an appropriate xsl stylesheet. It supports:

  • html transformation
  • pdf transformation
  • xml catalogs
  • common resources (e.g. images, stylesheets, etc)

Example

A possible setup for a docbook project may look like this: 


docs
  |
  -- main
      |
      -- etc
          |
          -- catalog (xml catalog)
          -- common (common css, images, etc)
          -- xml (docbook xml/xsl)
          -- xsl (stylesheets with configuration for html/pdf output)
      -- dev-guide
          |
          -- src
              |
              -- xml
              -- images
The main project.properties for the the multiproject documentation: 

# multiproject settings
maven.multiproject.navigation=independent

maven.multiproject.includes=*/project.xml
maven.multiproject.excludes=main/project.xml
maven.multiproject.basedir=../

# transform settings
# general settings
maven.transform.catalog=${basedir}/../main/etc/catalog/

# html settings
maven.transform.common.resources=${basedir}/../main/etc/common
maven.transform.xsl.html=${basedir}/../main/etc/xsl/main-html.xsl

# pdf settings
maven.transform.xsl.pdf=${basedir}/../main/etc/xsl/main-pdf.xsl
The according project.properties for the dev-guide and for all subsequent documentation projects: 

# transform settings
maven.transform.xml.file=${maven.transform.xml}/developers-guide.xml

Requirements

ToolDownload
Java Advanced Imaging (JAI) APIjava.sun.com