List Styles

(:Summary: PmWiki group header. Includes styles and trail.:)

{PmWiki.ListStyles$:Audience}

(:Summary: Styles for use in wiki lists:) See also Wiki styles, Cookbook:WikiStylesPlus

As well as the ordinary ordered (numbered) and unordered lists it is possible to use the styles %ROMAN%, %roman%, %ALPHA%, and %alpha%. The style is used in the first element of an ordered list, for example:

# %ROMAN% Top level
## %ALPHA% Second level
## Second level
## Second level
### Third level
### Third level
## Second level
### Third level
#### %alpha% Fourth level
##### %roman% Fifth level
##### Fifth level
#### Fourth level
# Top level
# Top level

Top level
1. Second level
2. Second level
3. Second level
  1. Third level
  2. Third level
4. Second level
  1. Third level
    1. Fourth level
      1. Fifth level
      2. Fifth level
    2. Fourth level
Top level
Top level

If you wish to start a numbered (ordered) list at an arbitrary starting value, use the value style, for example:

# %item value=2517% Top level
## %ROMAN% Second level
## Second level
## Second level
### Third level
### Third level
## Second level
### Third level
#### %alpha% Fourth level
##### %roman% Fifth level
##### Fifth level
#### Fourth level
# Top level
# Top level

Top level
1. Second level
2. Second level
3. Second level
  1. Third level
  2. Third level
4. Second level
  1. Third level
    1. Fourth level
      1. Fifth level
      2. Fifth level
    2. Fourth level
Top level
Top level

Note that the value=x option is set numerically even if you are using, for instance, the %alpha% style. So if you wanted to start a second level numbered list at D you would use this:

## %ALPHA%%item value=4%this is a fourth
## and a fifth (should be numbered E)

this is a fourth
and a fifth (should be numbered E)

Peter Bowers ? March 31, 2008, at 03:22 AM

This is nice if you know what number you want your item to have, but it defeats the purpose of having automatically numbered lists (e.g. what if you arbitrarily insert a new numbered item somewhere, now you'd have to go through all your explicit entries and reset those numbers!) it would be really nice if we could put %item value=resume% to tell the engine to pick up where it left off... shi ? December 31, 2007, at 03:18 PM

I strongly second this thought. The ONLY reason I ever use the renumbering is to resume when the numbers have been reset by an intervening markup. It's very awkward to have to do manual renumbering on a potentially long list with potentially many interruptions. Peter Bowers ? March 31, 2008, at 03:22 AM

Documentation index

Variables