Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

15 Converting to DITA XML > 15.1 Generating DITA XML with Mif2Go > 15.1.5 Understanding what information you must supply


15.1.5 Understanding what information you must supply

Mif2Go support for DITA requires you to supply the following kinds of information in addition to your FrameMaker document:

DTD properties

FrameMaker mappings

Disambiguation.

DTD properties

Mif2Go provides built-in content models for basic DITA topic types. If you are using structured FrameMaker, you can abstract content-model information from your DITA DTD. To add or replace a content model, use free command-line utility dtd2ini to generate a content model from a DTD, and produce a content-model configuration file for your DITA project. See §32.2.2 Generating a content model from a DTD.

FrameMaker mappings

For either structured or unstructured FrameMaker, you must map FrameMaker formats to the content model in terms of element names, element parentage, required level (if any), inline/block nature, and any requirement to be first under any parent. This information goes into your project configuration file, and possibly into chapter-specific configuration files. You might have to use markers in your FrameMaker document to provide information such as topic IDs, element names, and attributes, in cases where these items cannot be derived from the document.

Disambiguation

In an unstructured FrameMaker document, presentation might be the same for several different usages. Mif2Go cannot necessarily determine whether (for example) text tagged <Italic> is a computer term, a foreign language term, or a long quote, all of which have different representations in DITA, based on the context. The onus is on the author to disambiguate these usages, if necessary by inserting DITA markers in individual instances of particular formats. Mif2Go does handle a few presentational features automatically; for example, by default forced returns (FrameMaker Shift+Enter) are converted to spaces.



15 Converting to DITA XML > 15.1 Generating DITA XML with Mif2Go > 15.1.5 Understanding what information you must supply