Omni Systems, Inc.

  

Mif2Go User's Guide, Version 33u53

  

Valid HTML 4.01!

 

Made with Mif2Go

14 Producing DITA XML > 14.5 Nesting DITA block elements > 14.5.11 Specifying DITA element levels


14.5.11 Specifying DITA element levels

To specify the level at which a block element should appear in DITA output, you can assign a level number to any FrameMaker paragraph formats that are mapped to the element (see §14.4.3 Mapping paragraph formats to DITA elements). However, for most nesting issues, you should use settings that specify ancestry rather than level; see §14.5.2 Designating DITA ancestor elements. Assign levels only for the following purposes:

to identify paragraph formats mapped to <title> that should start new topics; assign level 1 to each such format

to handle unusual situations that cannot be addressed any other way.

To specify the level of a DITA block element:

[DITALevels]

; Frame para format (wildcards OK) = level in DITA (not Frame) file

;  required for the DITAParaTag specified for this element.

FmtName = N

The lower the level number, the higher the level; <topic> is level 0, the root. You cannot put anything else at level 0. The topic title is at level 1. The first heading in the topic body is at level 3 (a title below <topic>, <body>, and <section>).

Specify level 1 for each paragraph format that starts a topic. For example:

[DITALevels]

Title = 1

Heading* = 1

GlossItem = 1

To override the assigned level of a particular paragraph, place a DITALevel marker in the paragraph. A DITALevel marker specifies the level at which the current block element should appear in the DITA file, overriding whatever is specified for the format in [DITALevels]. The content of a DITALevel marker is a single integer.



14 Producing DITA XML > 14.5 Nesting DITA block elements > 14.5.11 Specifying DITA element levels