background image

WHITEPAPER

Using the

 

Open Toolkit plug-in 

for FrameMaker 

With the Darwin Information Typing Architecture (DITA) emerging as the de facto stan-
dard 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.

You are expected to know how to use DITA in FrameMaker. 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.

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 Java™ 
Help. If your content conforms to the DITA structure, you can use the DITA Open Toolkit 
to generate a wide variety of outputs.

The DITA Open Toolkit—an Open Source tool chain for multichannel publishing

DITA Open Toolkit is available for free distribution on the Organization for the Advance-
ment of Structured Information Standards (OASIS) website at 

http://www.oasis-open.org/

committees/tc_home.php?wg_abbrev=dita

. OASIS maintains the DITA specification.

Working with the Open Toolkit plug-in for FrameMaker

The Open Toolkit plug-in for FrameMaker lets you manage publishing through the 
FrameMaker user interface. The plug-in provides a DITA menu for publishing multiple 
outputs through the DITA Open Toolkit, using the default options or your customized 
builds. 

HTML

Compiled Help

Java Help

XML conforming to 

 DITA Structure

DITA Open

ToolKit

XML

TABLE OF CONTENTS

1

Overview of DITA Open Toolkit

1

Working with the Open Toolkit plug-in for 

FrameMaker

3

Advanced features

9

Appendix 1: Installing the DITA Open Toolkit

13 Appendix 2: Installing the Open Toolkit plug-

in for FrameMaker

14 Next steps

14 Resources

Summary of Contents for FRAMEMAKER

Page 1: ...ms to the DITA structure you can use the DITA Open Toolkit to generate a wide variety of outputs The DITA Open Toolkit an Open Source tool chain for multichannel publishing DITA Open Toolkit is availa...

Page 2: ...enerate output without having to modify the Ant script However you can edit the ditafm ant xml file to customize the processing of output You must specify the path where you installed the DITA Open To...

Page 3: ...ile which is located in the output folder Compiled Help chm output You can generate compiled Help CHM easily This process is similar to generating HTML output Open the ditamap file and choose DITA Gen...

Page 4: ...used for automating soft ware build processes For example the following types of publishing processes can be automated 1 Transform specified XML files such as DITA map files or associated topic files...

Page 5: ...gs for project dita 6 Set the property value for dita extname to the extension of your referenced topic files in this case xml Property name and value settings for dita extname 7 Save and close Test x...

Page 6: ...g html txt 3 Save and close ditafm ini Now you can run the selected targets Note that Test xml is a single script that contains multiple tar gets such as CHM and HTML To run the selected targets you h...

Page 7: ...rget to an existing script as shown in the following figure Customizing the Text xml Ant script To add this target as an option in FrameMaker you can modify the DITA initialization file to refer ence...

Page 8: ...specific systems CSS style sheets that are used in HTML output Ant scripts Any other tools used in new targets This customization must be separated from the core toolkit processing For example you can...

Page 9: ...t 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...

Page 10: ...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 s...

Page 11: ...the System Variables 3 Edit existing System Variables by selecting them from the list and clicking Edit Note Do not overwrite path values instead add additional paths to variables by delimiting paths...

Page 12: ...example C dita ot1 4 2 1 dost jar Set the Classpath variable to include the SAXON jar file Select the Classpath variable in the list of system variables and click Edit add a semicolon no spaces before...

Page 13: ...ts The various sets of files you need are contained in the openToolkit zip archive Follow the directions for expanding and extracting each set of files to their proper locations Installation overview...

Page 14: ...xml and PROJECT xml 2 Navigate to your DITA OT folder for example C dita ot1 4 2 1 and paste the two files Next steps Now that you ve seen the power of publishing with the Open Toolkit plug in for Fra...

Reviews: