Skip to content

reinierk/dita-ot

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DITA Open Toolkit Build Status

The DITA Open Toolkit, or DITA-OT for short, is an open source tool that provides processing for OASIS DITA content. See dita-ot.sf.net for documentation, information about releases, and download packages.

Prerequisites

In order to build and use DITA-OT, you’ll need:

  • Java Development Kit 6 or newer

  • Apache Ant 1.8.2 or newer.

    Please note that if you receive errors like unknown protocol: plugin or unknown protocol: cfg then you may have some missing libraries from your ant installation. In that case please download a recent distribution of ant and use that instead.

Building

  1. Clone DITA-OT Git repository.

  2. On root directory, compile Java code:

     ant jar
    
  3. Make sure the following files and directories are added to your CLASSPATH system variable:

    • src/main/lib/
  4. Run plug-in installation:

     ant -f src/main/integrator.xml
    

Usage

  1. Add the following files and directories to CLASSPATH system 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 directory to src/main.

  3. Run DITA-OT with:

     ant [options]
    

    See documention for arguments and options.

Distribution

  1. On root directory, compile Java code:

     ant jar
    
  2. Add the following files and directories to CLASSPATH system 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. Run plug-in installation:

     ant -f src/main/integrator.xml
    
  4. Build distribution packages:

     ant dist
    

    Distribution packages are build into target directory.

    On some systems you may encounter an java.lang.OutOfMemoryError: Java heap space. In that case you need to provide more memory to the ant process. One way of doing that is by setting the ANT_OPTS system variable to specify more memory, for example setting that to -Xmx1000m should be enough.

License

The DITA Open Toolkit is licensed for use, at the user's election, under the Common Public License 1.0 (CPL) or Apache License 2.0.

About

The DITA Open Toolkit is an implementation of the OASIS DITA XML Specification.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 92.8%
  • JavaScript 5.2%
  • PHP 1.9%
  • Shell 0.1%