Plugin Documentation

Goals available for this plugin:

GoalDescription
dita:chm2webConvert DITA Open Toolkit's Microsoft CHM output file, produced by htmlhelp transtype, to pure HTML set of files. Require commercial chm2web utility from A!K Research Labs
dita:eclipseGenerate http://www.dita-op.org's Eclipse configuration to allow editing, previewing DITA under Eclipse IDE.
dita:helpDisplay help information on dita-maven-plugin.
Call
  mvn dita:help -Ddetail=true -Dgoal=<goal-name>
to display parameter details.
dita:print-helpDisplay DITA Open Toolkit's common Ant properties usage. This can be used a reference for antProperties used by dita:run goal.
dita:run

Execute DITA Open Toolkit's Ant command line to transform DITA files to desired output format.

Behind the scene, antProperties are temporarily stored under ${dita.temp.dir}/properties.temp to be used with

ant -f ${dita.dir}/build.xml -propertyFile ${dita.temp.dir}/properties.temp

dita:versionDisplay DITA Open Toolkit's built-in version, with option to insert a custom version found under ${dita.dir}/ditaotVersionPath, via version property to Maven's ${versionName}. It is mainly used with maven-enforcer-plugin for build validation purpose.

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven2.0.6
JDK1.5
MemoryNo minimum requirement.
Disk SpaceNo minimum requirement.

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.codehaus.mojo</groupId>
          <artifactId>dita-maven-plugin</artifactId>
          <version>1.0-beta-3</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>dita-maven-plugin</artifactId>
        <version>1.0-beta-3</version>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"