Import a DITA map file

A DITA map is like a table of contents listing and linking the topics for a specific output. DITA maps assemble topics into sequence and hierarchy tailored to specific delivery requirements. You can have multiple maps, each one arranging the topics for different requirements, such as a reference manual, a tutorial, or online Help. A DITA map file has the extension .ditamap.

You can import DITA map files in RoboHelp to generate XHTML output. The DITA Open Toolkit processes the information in the DITA map file and provides the XHTML output. RoboHelp reads the XHTML output to generate the XHTML topics, TOC, and index. RoboHelp shows processing information of the DITA Open Toolkit in the Output View pod.

note:    RoboHelp depends on the DITA Open Toolkit to process the DITA map content. RoboHelp does not correct any errors generated by the DITA Open Toolkit. For example, if the DITA Open Toolkit does not generate XHTML 1.0 transitional compliant files, RoboHelp does not generate errors. There­fore, the XHTML topics generated from the import of DITA map file do not contain the meta tag <meta name="generator" content="Adobe RoboHelp - www.adobe.com" />note:    The XHTML file must have well-formed XML.

1)Do one of the following:

Select Project > Import > DITA Map.

Right-click the Project Files folder in the Project Manager pod. Select Import, and then select DITA Map as the file type.

2)Select a DITA map file. Click Open.

3)In the DITA Open Tool Kit Processing Options dialog box, specify the following options:

Replace Default XSLT File For Conversion

Select an XSL file to use for transforming the DITA files to XHTML instead of the default XSL file used by the DITA Open Toolkit. The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.xsl.

Use DITA Val For Conditional Processing

Specify a DITA Val file to use for conditional processing of the DITA files. The XHTML is generated based on the Val file. A DITA Val file contains filter, flagging, and revision informa­tion. The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.filter.

Show Index Entries In The Topics

Select to show index entries (marked by <indexterm> in DITA topics) in RoboHelp topics. The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.indexshow.

Show Image Filename In Annotation

Select to add annotations to images showing the filename of the image or the full path to include in the topics. The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.artlbl.

Include Draft And Cleanup Content

Select to include draft and required cleanup content (items identified as left to do before publishing). The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.draft.

Select XHTML File To Be Placed In The Header Area (hdf)

Select the location of the file containing XHTML to place in the header area of the output file. The equivalent parameter for the Ant processing of DITA Open Toolkit file is args.hdf.

Select XHTML File To Be Placed In The Body Running-header Area (hdr)

Select the location of the file containing the XHTML to place in the body running-header area of the output file. The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.hdr.

Select XHTML File To Be Placed In The Body Running-footer Area (ftr)

Select the location of the file containing XHTML to place in the body running-footer area of the output file. The equivalent parameter for the Ant processing of the DITA Open Toolkit file is args.ftr.

DITA Open Tool Kit Home Directory

Select the absolute location of the home folder of the DITA Open Toolkit. Specify the valid DITA Open Toolkit home folder. You specify this location only once. It is stored in the registry. You can change the location.

4)Click Finish.

note:    RoboHelp verifies the location of the selected files but does not validate the files as the DITA Open Toolkit processes all the information.


September 30, 2016

Legal Notices | Online Privacy Policy