Advertisement
Appendix 1: Installing the DITA Open Toolkit
The DITA Open Toolkit includes the basic document type definitions (DTDs) associated with DITA,
as well as some XSLT style sheets for processing DITA into various output formats. The toolkit
depends on several freely available software applications, such as the following:
• The Java Development Kit, required for core processing of published output
• Apache Ant, required to define different forms of output, including location of source and
destination files
• JavaHelp, used when you are publishing your content as Help for Java applications
• SAXON, an XSLT processor used for HTML publishing
• Microsoft® HTML Help, used to generate compiled HTML Help (.chm) files
• XML-Resolver - xml-resolver-1.2.jar file required for DITA-OT1.4.2.1. (Located in the path con-
taining openToolkit.dll)
A complete installation includes installing these applications and Open Toolkit, then setting the
Environment Variables on the computer on which you've installed these so that the various applica-
tions can work together. To run the DITA Open Toolkit from FrameMaker, you will also need to
install the Open Toolkit plug-in for FrameMaker. For information on downloading and installing
the plug-in, see
"Appendix 2: Installing the Open Toolkit plug-in for
Installing the Java Development Kit
At the core of the DITA Open Toolkit is the Java Development Kit (JDK), which provides the base
Java functionality on which most other toolkit programs depend. To install the JDK:
1 Go to http://java.sun.com/javase/downloads/index.jsp.
2 Click the Download J2SE SDK link to download the JDK. Check for JDK 6 Update 3.
3 Accept the license agreement, and click Windows Offline Installation.
4 Click Save to save the file to your hard disk; note where you saved the file.
5 Open Windows Explorer again by right-clicking the Windows Start menu and choosing Explore
from the pop-up menu. Navigate to the folder where you saved the file, and double-click the
executable file.
6 Click Run and accept the default installation options.
7 Open Windows Explorer again. Look in the root folder to see where the JDK was installed, for
example, C:\Program Files\Java\jdk1.6.0_10 (the precise name depends on the version of the JDK
you installed).
Installing Apache Ant
Apache Ant is a build tool used by the DITA Open Toolkit for defining different processing steps
for generating published output. To install Apache Ant:
1 Go to http://ant.apache.org/bindownload.cgi.
2 Click the .zip archive link to download the current version of Apache Ant (for example,
apache-ant-1.7.1-bin.zip [PGP] [SHA1] [MD5]).
3 Click Save to save the archive file to your hard disk; note where you saved the file.
4 Open Windows Explorer by right-clicking the Windows Start menu and choosing Explore from
the pop-up menu. Navigate to the folder where you saved the archive file.
5 Extract the contents of the archive file to the C:\ folder.
FrameMaker" on page 13.
Using the Open Toolkit plug-in for FrameMaker
9
Advertisement
