Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

15 Converting to DITA XML > 15.9 Configuring DITA topics > 15.9.1 Designating starting points for DITA topics > 15.9.1.3 Preventing the first paragraph format from starting a topic


15.9.1.3 Preventing the first paragraph format from starting a topic

To prevent Mif2Go from forcing the first paragraph format in a FrameMaker file to become a topic start:

[DITAOptions]

; ForceStartTopic = Yes (default, make the format of the first para a

;  topic start with tag "title" at level 1 and parent "topic"), or No.

ForceStartTopic = No

If the first paragraph format in a file is not assigned DITA level 1, or is not implicitly or explicitly mapped to the <title> element:

When ForceStartTopic=Yes, Mif2Go forces these settings, overriding any other mapping or level assignment; as a consequence, all subsequent paragraphs with the same format in the same file also start topics.

When ForceStartTopic=No, Mif2Go allows the paragraph to produce invalid DITA.

Best practice is to use the default setting (ForceStartTopic=Yes), and make sure the first paragraph format in each FrameMaker file is mapped to title and assigned level 1.

However, if your FrameMaker document uses a table to hold the chapter title, you might have to set ForceStartTopic=No, and make sure the table anchor paragraph does not get converted. For example, if you use paragraph format TableAnchor for the anchor, set:

[HTMLParaStyles]

TableAnchor = Delete

If there is a second such table in the chapter file, also set:

[Tables]

AllowTbSplit = Yes

To omit the table tags for chapter-title tables:

[DITATables]

ChapTitleTableFmt = Strip

See §15.6.7 Omitting table coding entirely.



15 Converting to DITA XML > 15.9 Configuring DITA topics > 15.9.1 Designating starting points for DITA topics > 15.9.1.3 Preventing the first paragraph format from starting a topic