### 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:

[DITAOptions]

; WrapTopicFiles = No (default), or Yes (needed to allow TopicIDs for

; Frame8 import unless DITA-FMx is installed).

WrapTopicFiles = Yes

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.

| 15.8.4 Nesting DITA topics in unsplit files |  | 15.9 Configuring DITA topics |