Working with bulleted and numbered lists

FrameMaker paragraphs with bullets or autonumbers should generally be converted to HTML unordered or ordered lists. The Portable HTML Standard Edition template includes four paragraph styles-SmartList1 through SmartList5-that create HTML lists. SmartList1 is a first-level list, SmartList2 a second-level list, and so on. To create HTML lists in your output, map the FrameMaker bullet and numbered list paragraph tags to the appropriate SmartList style.

The SmartList style is "smart" because it analyzes the FrameMaker paragraph style to determine whether the output should be a bulleted (unordered) list or an ordered list (with different numbering types).

HTML handles bulleted and numbered lists differently from FrameMaker, and as a result, converting FrameMaker list items to HTML can present a challenge. In FrameMaker, list numbering is based on the autonumber defined in the paragraph. But in HTML, the list number is based on the position of the list item in the list.

An ordered HTML list looks like this:

<OL> 
<LI>first step 
<LI>second step 
<LI>third step 
</OL> 

The numbering is calculated by the position of the <LI> element within the <OL> element. But in many cases, the numbered items in the FrameMaker files aren't adjacent. For example, you might have text like this:

In FrameMaker, this is easy. You create a Step1 tag with an autonumber of S:<n=1>, a Step2+ tag with an autonumber of S:<n+>, and a Note tag with "Note:" as the autonumber. To convert the items to HTML, you map the Step1 and Step2+ to SmartList1 and Note to Body. But in HTML, look at what happens:

<OL> 
<LI>Do this. 
<LI>Do this. 
</OL> 
<P>Note: Don't forget this.</P> 
<OL> 
<LI>Do some more stuff. 
</OL> 

And the result in the browser looks like this:

The first and second steps are numbered correctly, but the third step is reset to begin with "1."

To prevent this from happening, you have two choices:


Quadralay Corporation
Voice: (512) 719-3399
Fax: (512) 719-3606
info@webworks.com