Using the Open Toolkit plug-in for FrameMaker
10
Installing JavaHelp
JavaHelp creates Help for use in Java-based applications. To install JavaHelp:
1 Go to
http://java.sun.com/products/javahelp/download_binary.html
.
2 Download the latest version of JavaHelp (for example, JavaHelp 2.0_02 [Zip]), accepting the
license agreements.
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.
Installing the SAXON XSLT Processor
The SAXON XSLT Processor is an Open Source XSLT processor built by Michael Kay, used to
transform source XML conforming to the DITA architecture to HTML. To install the SAXON
XSLT Processor:
1 Go to
http://saxon.sourceforge.net/.
2 Click the download link under the heading Saxon 6.5.5.
3 Click one of the download options on the SourceForge.net page.
4 Click Save to save the archive file to your hard disk; note where you saved the file.
5 Open Windows Explorer by right-clicking the Windows Start menu and choosing Explore from
the pop-up menu. Create a folder within the root folder called Saxon (for example, C:\Saxon).
6 In Windows Explorer, navigate to the folder where you saved the archive file.
7 Extract the contents of the archive file to the C:\Saxon folder that you created.
Installing Microsoft HTML Help
Microsoft HTML Help is a tool for authoring online Help, which is used by the Open Toolkit to
create compiled Help (.chm) files. To install Microsoft HTML Help:
1 Go to
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/
html/hwMicrosoftHTMLHelpDownloads.asp
(make sure this is a single line).
2 Click Download Htmlhelp.exe and click Save to save the executable file to your hard disk; note
where you saved the file.
3 Open Windows Explorer by right-clicking on the Windows Start menu, and choosing Explore
from the pop-up menu. Double-click the Htmlhelp.exe file and follow the steps in the HTML
Help installation wizard to complete the installation.
Installing the DITA Open Toolkit
The DITA Open Toolkit itself provides files that control the dependent applications, such as the
JDK, Ant, and SAXON, to generate published output. To install the DITA Open Toolkit:
1 Go to
http://dita-ot.sourceforge.net/
.
2 Click Download in the left pane, and click Download DITA Open Toolkit.
3 Select and download the most recent DITA Open Toolkit .zip archive (for example,
DITA-OT1.4.2.1_full_easy_install_bin.zip), selecting a mirror site for your download.
4 Click Save to save the archive file to your hard disk; note where you saved the file.
5 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.
6 Extract the contents of the archive file to the C:\ folder.
Technical skill required
Note that installing the DITA Open Toolkit requires con-
siderable expertise, and may not be appropriate for
those without at least some programming background.
Time allocation
This process can be time-consuming, as you will be
installing multiple Open Source applications that sup-
port the toolkit, as well as the toolkit itself. Allocate sev-
eral hours for installation and testing.
