Lists

Formatting lists in TEI

A <list> is an organized series of items. They may be unmarked, numbered, or alphabetized. For accuracy in the OCR process, we disable the option in ABBYY FineReader to output lists. However, occasionally it will be appropriate to encode output as a list in the TEI. In that case, use the following guidelines.
Note: We do not use <list> for numbered paragraphs of text—which were once in common stylistic use—unless the paragraphs group or sequence discrete items.
element attribute usage
<list> contains any sequence of items organized as a list.
@type
@rend
<head> (heading) contains the heading of a list.
<label> @type="list" marks a syllogism, tabular, or glossary list in which each item is associated with a word or phrase rather than a numeric or alphabetic enumerator. Must have @type="list". NB: if one item in a list is preceded by a label, all must be.
<item> contains one component of a list.
@n supplies an enumerator for the <item> when automatic processing is inadequate, similarly to <label>.
<headLabel> the heading for the <label> column of a tabular list.
<headItem> the heading for the <item> column of a tabular list.

Tabular list

Lists like a glossary or syllogism use <label> for each <item>. Thus they resemble a simple table with two columns. They can present an advantage over tables in indicating the relationship between the enumerator and list item. In the example below, the original text demonstrates a syllogism, and the TEI markup follows.

Figure 1. Original text


Figure 2. TEI encoding (missing the required @type attribute for <label>)


<list @type>

Use <list> with @type to describe the semantic function of the list.

@type value description
basic a vertical list of unordered items without description.
chronology each list <item> describes an historical event, with a year or other date that is given by a <label> element preceding the list <item>.
errata each item contains the error and correction, with a page number. Use <label> for the error and page number, followed by the correction as <item>.
gloss each list <item> glosses some term or concept, which is given by a <label> element preceding the list <item>.
index each list <item> is an entry in an index such as the alphabetical topical index at the back of a print volume.
instructions each list <item> is a step in a sequence of instructions, as in a recipe.
litany each list <item> is one of a sequence of petitions, supplications or invocations, typically in a religious ritual.
syllogism each list <item> is part of an argument consisting of two or more propositions and a final conclusion derived from them.

<list @rend>

Use <rend> to record the appearance of the list in the source text.

@rend value description
bulleted items preceded by bullets or similar marking
inline items rendered within continuous prose, with no linebreaks
numbered items preceded by numbers or letters
simple items rendered as blocks, but with no bullet or number