Section 3.7 Lists¶
Ordered lists (numbered), unordered lists (bullets) and description lists (defined terms) are all supported, and syntax generally follows HTML. Lists usually live within a paragraph (
<p>), though there are limited exceptions. Their structure is given by the
<dl> tags (respectively). These can specify a variety of options for the labels via attributes, as described in Section 6.9.
List items, for any of the three types, are delimited with the
<li> tag. What is different from HTML is that the contents of a list item may be structured, with paragraphs (
<p>) being the most likely. So to nest lists you begin a paragraph in a list item of the outer list, then begin the inner list within that paragraph. But a simple list item may be authored just like you were authoring within a paragraph, much like writing sentences elsewhere. For a description list, the list item must contain a
<title>, which will become the text that is being described (the lable of the list item). Then the rest of the list item must be structured, say with paragraphs. A description list cannot be contained within another list.
Lists are more complicated than they appear, so be sure to read the details at Section 6.9 before you start designing rweally involved lists.