List
Key point: Use lists for simple list items that are not part of the table of contents.

There are two types of lists in PSML:

  1. Use unordered lists for related items that can be arranged in no particular order. They display as bulleted lists and you can specify the type of bullet (bullet, circle, or square).
  2. Use numbered lists for related items that are displayed in a specific order. You can specify the type of numbering:
    • Decimal (1, 2, 3, ... ).
    • Lower alpha (a, b, c, ... ).
    • Lower roman (i, ii, iii, ... ).
    • Upper alpha (A, B, C, ... ).
    • Upper roman (I, II, III, ... ).

You can also specify the start number for the numbered lists.

When editing, you can easily create lists by starting your line with *, -, 1., a., or i., or A. – see text patterns.

Consider using numbered paragraphs as an alternative to numbered lists.

Paragraphs in lists

Lists aren’t designed to contain paragraphs by default. Many lists contain short pieces of text that don’t need to be wrapped in a paragraph. See usage of paragraphs in PSML for further explanations. 

List role

A role can be used to distinguish or assign a particular style to specific PSML content.  For more information, see role – for PSML content in the default editor document.

For developers

In PSML, lists are represented using the <list> element, and numbered lists using the <nlist> element.

For more information, see the list and nlist elements in the PSML reference on the PageSeeder developer’s website.