Advertisement
Quick Links
TABLE OF CONTENTS
1
Overview of DITA Open Toolkit
1
Working with the Open Toolkit plug-in for
3
9
in for FrameMaker
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
"Appendix 2: Installing the Open Toolkit plug-in for
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.
XML
XML conforming to
DITA Structure
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
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.
Toolkit" on page 9, and
FrameMaker" on page 13.
DITA Open
ToolKit
http://www.oasis-open.org/
WHITEPAPER
HTML
Compiled Help
Java Help
Advertisement
Related Manuals for Adobe FRAMEMAKER
Summary of Contents for Adobe FRAMEMAKER
-
Page 1: Table Of Contents
Overview of DITA Open Toolkit Open Toolkit with FrameMaker 9. Working with the Open Toolkit plug-in for You are expected to know how to use DITA in FrameMaker. For information on installing FrameMaker DITA Open Toolkit, see “Appendix 1: Installing the DITA Open Toolkit”... - Page 2 Ant script and reference them in the ditafm.ini file. • Most users may require only the Current File method starting the DITA open toolkit. Most FrameMaker users may use the Current File method for running the DITA Open Toolkit pro- cesses.
-
Page 3: Framemaker
The route to generate PDFs through DITA Open Toolkit is added to the DITA Generate Output dia- log box. Advanced features The publishing capabilities of Adobe FrameMaker are enhanced by the Open Toolkit plug-in for FrameMaker. To take advantage of these features, you must have knowledge of the following: Using the Open Toolkit plug-in for FrameMaker... - Page 4 3 Open Test.xml in Windows® Notepad® (Start > Programs > Accessories > Notepad). In steps 4 through 9, you will set the main properties indicated in the comments, which appear at the begin- ning of the file. Using the Open Toolkit plug-in for FrameMaker...
- Page 5 Note: Take a backup of the DITA initialization file before changing anything. 1 Using Windows Notepad, open ditafm.ini from the fminit\ditafm folder. 2 Add the following lines at the end of the file: Using the Open Toolkit plug-in for FrameMaker...
- Page 6 CHM and HTML. To run the selected targets you have defined (formats like CHM, PDF, and so on): 4 In FrameMaker, select DITA > Generate Output. 5 Click Selected Target. The list of targets specified in the .ini file appears.
- Page 7 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 and define the new target, as shown in the following examples: Modifying the ditafm.ini file...
- Page 8 3 Create the XSLT for custom processing, and save it in a folder outside the DITA Open Toolkit folder. By doing this, you can manage Open Toolkit updates, without losing any customization. You must install a new version of the Open Toolkit and then do steps 1 and 2 above. Using the Open Toolkit plug-in for FrameMaker...
-
Page 9: Appendix 1: Installing The Dita Open Toolkit
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... - Page 10 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. Using the Open Toolkit plug-in for FrameMaker...
- Page 11 Follow the instructions in the table below for each environment variable listed. Before adding new variables, check the System Variables list to see if they are already present. If so, first add a semico- lon after the existing value, then add the new path. Using the Open Toolkit plug-in for FrameMaker...
- Page 12 1 Go to the command prompt by choosing Run from the Windows Start menu, and then typing cmd and clicking OK. 2 Type cd \ at the command prompt to move to the root folder. Using the Open Toolkit plug-in for FrameMaker...
-
Page 13: Appendix 2: Installing The Open Toolkit Plug
Installation overview There are only two main steps to setting up the Open Toolkit plug-in for FrameMaker: 1 Extract all the files from the .zip archive to specified areas in FrameMaker installation folder (for example, C:\Program Files\Adobe\FrameMaker9). 2 Make the corresponding entry in maker.ini. -
Page 14: Next Steps
Now that you’ve seen the power of publishing with the Open Toolkit plug-in for FrameMaker, you may want to learn more about the DITA Open Toolkit itself, the tech- nologies associated with specific forms of output, such as the XSLT and CSS style sheets that generate and format HTML.