Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> 17 Converting to DocBook XML > 17.5 Nesting DocBook block elements > 17.5.10 Configuring multi-paragraph list items

### 17.5.10 Configuring multi-paragraph list items

By default, at the end of each paragraph Mif2Go closes the block element to which the paragraph format is mapped (see §17.4.2 Mapping paragraph formats to DocBook elements). If any list items in your document include multiple paragraphs or sublists, you must make sure that each <listitem> can include more than one block element, but also that the last item in each list or sublist does not slurp up any following paragraphs.

To configure list elements:

Map formats to <para> instead of to <listitem>.

Specify ancestry for each format.

Make each format first in <listitem>.

Make sure each list ends where it should.

Map formats to <para> instead of to <listitem>

Map list-item paragraph formats to <para> rather than to <listitem>:

[DocBookParaTags]

Numbered1 = para

Numbered = para

Bulleted = para

BulletedLast = para

Specify ancestry for each format

Designate the appropriate ancestors for each type of list element:

[DocBookParents]

Numbered1 = orderedlist listitem

Numbered = orderedlist listitem

Bulleted = itemizedlist listitem

BulletedLast = itemizedlist listitem

Make each format first in <listitem>

Make sure each list-item paragraph is first in its <listitem> element:

[DocBookFirst]

Numbered1 = orderedlist listitem

Numbered = listitem

Bulleted = listitem

BulletedLast = listitem

Make sure each list ends where it should

If the last paragraph in a multi-paragraph list item is followed by a paragraph whose format is mapped to an element that is valid in <listitem>, that paragraph will be included in the list item. To prevent including the following paragraph, you can explicitly close the list:

[DocBookCloseAfter]

BulletedLast = itemizedlist listitem

Or insert a DocBookCloseAfter marker in the last list-item paragraph, with content itemizedlist orderedlist.

As an alternative, you can make sure the list closes before the following paragraph:

[DocBookCloseBefore]

Body = itemizedlist orderedlist

Or insert a DocBookCloseBefore marker in the following paragraph, with content:

itemizedlist orderedlist