User manual ADOBE FRAMEMAKER USING THE OPEN TOOLKIT PLUG-IN

[. . . ] WHITEPAPER Using the Open Toolkit plug-in for FrameMaker TABLE OF CONTENTS 1 1 Overview of DITA Open Toolkit Working with the Open Toolkit plug-in for With the Darwin Information Typing Architecture (DITA) emerging as the de facto standard for creating topic-based content, Adobe® FrameMaker® 9 provides extensive support for authoring DITA content. In addition, you can use the DITA Open Toolkit with FrameMaker to obtain deliverable outputs. This document describes how to use the DITA Open Toolkit with FrameMaker 9. For information on installing DITA Open Toolkit, see "Appendix 1: Installing the DITA Open Toolkit" on page 9, and "Appendix 2: Installing the Open Toolkit plug-in for FrameMaker" on page 13. FrameMaker 3 9 Advanced features Appendix 1: Installing the DITA Open Toolkit 13 Appendix 2: Installing the Open Toolkit plugin for FrameMaker 14 Next steps 14 Resources Overview of DITA Open Toolkit DITA Open Toolkit is a set of software tools, originally developed by IBM®, for publishing DITA to various formats, including HTML, Microsoft HTML Help (. CHM) and JavaTM Help. [. . . ] Ant processing can include files in any location, and processes and applications not included in the DITA Open Toolkit distribution. Main files of the DITA Open Toolkit You can modify some of the following files to customize the output generated using the Open Toolkit plug-in for FrameMaker. · XSLT style sheets that control HTM and other forms of published output. You can change the XSLT style sheet to customize HTML design, or you can use XSLT to generate XML in a different structure from your core DITA structure to interface with specific systems. 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 FrameMaker" on page 13. 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. 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. 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. 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. 5 Extract the contents of the archive file to the C:\ folder. Using the Open Toolkit plug-in for FrameMaker 9 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. 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. [. . . ] Select the Path variable in the list of System Variables and click Edit. Add a semicolon (no spaces) followed by the path of your Apache Ant bin folder (for example, C:\apache-ant-1. 6. 5\bin). If you already have a Classpath variable in your list of System Variables, select the Classpath variable in the list of System Variables and click Edit. Add a semicolon (no spaces before or after) to the end of the current Classpath value, followed by the path of xml-resolver-1. 2. jar file (for example, C:\xmlresolver-1. 2. jar). [. . . ]