Setting Environment Variables

This section helps you find and set the environment variables. Set your system environment variables after all DITA Open Toolkit items are installed. The environment variables must be set for each item installed in this guide.

  1. From the Start Menu, select Start > Settings > Control Panel.
  2. Double-click System to open the System Properties window.
  3. On the Advanced tab, select environmental variables .
  4. Modify each environmental or system variable.
    Option Description
    Set the PATH environment variable to include the directory where you installed the Ant bin directory.
    1. Find the PATH environment variable in the list. If PATH is not listed, click on New under the System variables section.
    2. Type %ANT_HOME%\bin;%JAVA_HOME%\bin;
      Important: If there are other variables listed, create a new variable separated by a semicolon. Ensure there are no spaces before or after the semicolon.
    Set the ANT_HOME environment variable to the directory where you installed Ant.
    1. Click on New under the System variables section.
    2. Type ANT_HOME in the variable name field.
    3. Type C:\ant in the variable value field.
    Set the JAVA_HOME environment variable to the directory where you installed the J2SE SDK application.
    1. Click on New under the System variables section.
    2. Type JAVA_HOME in the variable name field.
    3. Type C:\j2sdk1.4.2_08 in the variable value field.
    Set the JHHOME environment variable to the directory where you installed the JavaHelp application.
    1. Click on New under the System variables section.
    2. Type JHHOME in the variable name field.
    3. Type C:\javahelp\jh2.0 in the variable value field.
    Set the CLASSPATH environment variable for DITA-OT.
    1. Find the CLASSPATH environment variable in the list. If CLASSPATH is not listed, click on New under the System variables section.
    2. Type C:\ditaot\lib;C:\ditaot\lib\dost.jar;C:\ditaot\lib\resolver.jar
      Important: If there are other variables listed, create new variable separated by a semicolon. Ensure there are no spaces before or after the semicolon.
    Set the CLASSPATH environment variable for the Apache FOP application.
    1. Find the CLASSPATH environment variable in the list. If CLASSPATH is not listed, click on New under the System variables section.
    2. Type C:\fop-0.20.5\build\fop.jar;C:\fop-0.20.5\lib\batik.jar;C:\fop-0.20.5\lib \avalon-framework-cvs-20020806.jar
      Important: If there are other variables listed, create new variable separated by a semicolon. Ensure there are no spaces before or after the semicolon.
    Set environment variables for Saxon. If you use the Saxon,
    1. Find the CLASSPATH environment variable in the list. If CLASSPATH is not listed, click on New under the System variables section.
    2. Type C:\saxon\saxon.jar
      Important: If there are other variables listed, create a new variable separated by a semicolon. Ensure there are no spaces before or after the semicolon.
    3. Set up ANT_OPTS. For example:
      set ANT_OPTS=%ANT_OPTS% -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl
    Set the CLASSPATH environment variable for Xalan. If you use the Xalan,
    1. Find the CLASSPATH environment variable in the list. If CLASSPATH is not listed, click on New under the System variables section.
    2. Type C:\xalan\bin
      Important: If there are other variables listed, create a new variable separated by a semicolon. Ensure there are no spaces before or after the semicolon.