Skip to content
cibboy edited this page Sep 3, 2018 · 5 revisions

Lists

Introduction

Several types of list are styled in Paper. All major list tags are considered:

  • Unordered lists (ul)
  • Ordered lists (ol)
  • Definition lists (dl)

Unordered lists present a custom bullet point style, using the character ».

Ordered lists use the traditional decimal number order by default, but more styles are available through specialization classes. Such classes cover the roman and latin letters, both in upper and lower case.

Definition lists are rendered through a variation of the typical dictionary style.

Nested ordered and unordered lists are taken care of.

Usage

Using lists in Paper is just a matter of using the dedicated tags. With the exception of ordered lists, there is no specialization dedicated to lists.

Types

Traditional list tags require no additional treatment.

  • Unordered lists

    Unordered lists are to be used with the traditional ul and li tags.

    Example
    <ul>
      <li>List element</li>
      <li>List element</li>
    </ul>
  • Ordered lists

    Ordered lists are to be used with the traditional ol and li tags. By default decimal numbers are used for the order. Specialization classes can be used for different order styles (see section on variants).

    Example
    <ol>
      <li>List element</li>
      <li>List element</li>
    </ol>
  • Definition lists

    Definition lists are to be used with the traditional dl, dt and dd tags.

    Example
    <dl>
      <dt>Term</dt>
      <dd>Definition</dd>
    </dl>

Variants

Ordered lists support several numbering variants through specialization classes.

  • Decimal

    Decimal numbering (1. 2. etc.) is the default variant and requires no specialization class, but it is also available through the decimal class.

    Example
    <ol>
      <li>List element</li>
      <li>List element</li>
    </ol>
    Example
    <ol class="decimal">
      <li>List element</li>
      <li>List element</li>
    </ol>
  • Roman

    Roman numbering (I. II. etc.) is available both in lower and upper case, through the lower-roman and upper-roman classes.

    Example
    <ol class="lower-roman">
      <li>List element</li>
      <li>List element</li>
    </ol>
    Example
    <ol class="upper-roman">
      <li>List element</li>
      <li>List element</li>
    </ol>
  • Latin

    Latin numbering (a. b. etc.) is available both in lower and upper case, through the lower-latin and upper-latin classes.

    Example
    <ol class="lower-latin">
      <li>List element</li>
      <li>List element</li>
    </ol>
    Example
    <ol class="upper-latin">
      <li>List element</li>
      <li>List element</li>
    </ol>

Nested lists

Nested lists require no particular attention beyond correct tag nesting. Proper margin handling is already taken care of. Mixed types and variants are supported.

Example
<ol class="upper-roman">
  <li>List element</li>
  <li>
    Nested list
    <ul>
      <li>Nested list element</li>
      <li>Nested list element</li>
    </ul>
  </li>
</ol>

Live examples

Live examples

Clone this wiki locally