17.5.3 Fixing up interpolated ancestries
Creating DocBook structure from FrameMaker formats necessarily involves some trial and error. When you see unexpected interpolation of inappropriate parent elements in your output, it is usually because you have not specified parents for a particular format-to-element mapping. For example, suppose you map paragraph format Ref to <para>, and use a Ref paragraph at the top level of each reference section, where <para> is not valid. On encountering a Ref paragraph in this situation, with no parents specified for the Ref format, Mif2Go would go through the list of valid parents for <para> in a reference section, and interpolate the first set that works.
The remedy is to figure out what would be a more appropriate lineage for the element in question. You could specify that lineage for the format in [DocBookParents] if it applies generally, or insert a DocBookParent marker in the paragraph for an isolated instance. In this example, the following mapping would produce better results:
The Mif2Go search algorithm finds the shortest path, but that is not always the only shortest path, or the best path.
§17.4.2.3 Omitting invalid tags for default DocBook block elements
> 17 Converting to DocBook XML > 17.5 Nesting DocBook block elements > 17.5.3 Fixing up interpolated ancestries