Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 17 Converting to DocBook XML > 17.5 Nesting DocBook block elements > 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