Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 15 Converting to DITA XML > 15.8 Organizing DITA topics > 15.8.5 Wrapping DITA topics in a top-level <dita> element
If you split FrameMaker files into separate topic
files, and you use topic IDs in map references to those topics, for re-import
into FrameMaker 8 each topic file must be wrapped in a <dita>
element (unless you are using the Leximation DITA-FMx plug-in). Otherwise,
FrameMaker version 8 will not be able to open the files.
To wrap the topics in each file in a <dita>
element:
; WrapTopicFiles = No (default), or Yes (needed to allow TopicIDs for
; Frame8 import unless DITA-FMx is installed).
When WrapTopicFiles=Yes
,
all topics are wrapped in a <dita>
element
in each DITA XML output file. Within this wrapper, any topic type except
glossary
can nest topics of any other type.
When WrapTopicFiles=No
,
topics are wrapped in <dita>
tags only
if required by a mixed-type nesting condition, or if SplitTopicFiles=No
and the first topic in a file does not nest all the other topics. When
topics are not wrapped, each topic type (except glossary
)
can nest only instances of the same type; a glossary
topic cannot nest any topic. If any topic type nests other topic types,
Mif2Go forces WrapTopicFiles=Yes
.
If a glossary
topic tries to nest any topic,
Mif2Go promotes the nested topic to a sibling. See
§15.8.4 Nesting DITA topics in unsplit files.
You might need to set WrapTopicFiles=Yes
if you are mixing single-topic DITA files with DITA content from files
that contain multiple topics in a <dita>
wrapper, perhaps from another source (so you cannot make them single-topic
files). You must use topic IDs for map references to the multi-topic
files, so you would have to wrap the single-topic files also, to make
the topic IDs acceptable there.
When [DITAOptions]FM8Import=Yes
,
Mif2Go changes the default value of WrapTopicFiles
to Yes
; see §15.2.6 Ensuring FrameMaker 8 import compatibility.
Note:
When you use topic IDs in map href
attributes, chapter files produced by FrameMaker version 8 from those
topic files have names of the form TopicFileName
#
TopicID
.fm
.
See §16.2.1.7 Excluding topic IDs for FrameMaker 8 import.