Adobe FRAMEMAKER Using Manual Download Page 3

Using the Open Toolkit plug-in for FrameMaker

3

Thus, the Selected Target method is more appropriate for calling publishing processes that generate 
output from source files in the locations specified in your custom Ant scripts.

Current File Method

Make the following changes in fminit\ditafm\ditafm.ini

To process a topic file that is open, change the ditafm.ini file as follows:

[BuildFile]

AntCommand=ant

AntScript=ditafm-ant.xml 

Count=2

DitaDir=C:\DITA-OT1.4.2.1 

1=chm 

2=html

To generate output from the example Help file DITA map, using the Current File option:

1 Open a ditamap file.

2 If prompted, select the structured application DITA-Map-HTML, and click Continue.

Use the Structured Application dialog box.

3 Select the path where the DITA Open Toolkit is installed.

4 Select the Current File option.

5 Select .html.

6 Select the output folder, and click Build.

On a fully configured system, the example DITA content is saved in HTML.

HTML output

To view the HTML output, double-click the index.html file, 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-->Generate CHM Output. A folder named CHM is cre-
ated in the output folder. The CHM folder contains the CHM file.

When you use the Current File option to generate output using the DITA Open Toolkit, you do not 
need to modify any of the Ant, XSLT, or initialization files. 

PDF output

The recommended way to generate a PDF for DITA files is through the Save As PDF option in 
FrameMaker. 

However, to generate PDFs using the DITA Open Toolkit:

1 Install a FO processor that helps in converting FO files to PDF. (Apache FOP is free.)

2 With Apache FOP installed, add fop.jar, batik.jar, avalon-framework-cvs-20020806.jar file path to 

the CLASSPATH environment variable.

3 Update ditafm.ini to add an entry for PDF.

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:

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: