Muuntaja

The Muuntaja is an open source tool that provides processing for OASIS DITA content. It is a fork of DITA Open Toolkit where Ant has been replaced with Scala code.

Prerequisites

In order to build and use Muuntaja, you’ll need:

• Java Development Kit 7 or newer
• SBT 0.12.1 or newer

Building

1. Clone the DITA-OT Git repository:

    git clone git://github.com/dita-ot/dita-ot.git
   

2. On root directory, compile Java and Scala code:

    sbt compile
   

3. Install plugins:

    ant -f src/main/integrator.xml
   

Usage

1. Add these files and directories into the CLASSPATH environment variable:

   • src/main/
   • src/main/lib/
   • src/main/lib/dost.jar
   • src/main/lib/xercesImpl.jar
   • src/main/lib/xml-apis.jar
   • src/main/lib/commons-codec-1.4.jar
   • src/main/lib/saxon/saxon9-dom.jar
   • src/main/lib/saxon/saxon9.jar
   • src/main/lib/resolver.jar
   • src/main/lib/icu4j.jar

2. Change the directory to src/main.

3. Run Muuntaja with:

    ant [options]
   

   See the documentation for arguments and options.

Distribution

1. In the root directory, compile the Java code:

    ant jar jar.plug-ins
   

2. Add these files and directories into the CLASSPATH environment variable:

   • src/main/
   • src/main/lib/
   • src/main/lib/dost.jar
   • src/main/lib/xercesImpl.jar
   • src/main/lib/xml-apis.jar
   • src/main/lib/commons-codec-1.4.jar
   • src/main/lib/saxon/saxon9-dom.jar
   • src/main/lib/saxon/saxon9.jar
   • src/main/lib/resolver.jar
   • src/main/lib/icu4j.jar

3. Install plugins:

    ant -f src/main/integrator.xml
   

4. Build distribution packages:

    ant dist
   

   Distribution packages are build into the target directory.

   If Ant throws an error like java.lang.OutOfMemoryError: Java heap space, you probably need to increase the maximum Java heap size. One way to do this is to set the ANT_OPTS environment variable to a value like -Xmx1024m.

   For more information on the -Xmx option, see Java SE Documentation.

License

The Muuntaja is licensed for use under the Apache License 2.0.