<?tei:SOF p2coli.odd ?>
<!-- $Id: p2coli.odd,v 1.3 1994/03/27 21:45:15 msmcq Exp $ -->
<!-- $Log: p2coli.odd,v $
# Revision 1.3  1994/03/27  21:45:15  msmcq
# Correction of typos from DB, JL, HG, and WWP
# -->
<!-- P2.COli: Lists                                           -->
<!-- Revisions:                                               -->
<!-- 94-03-26 : MSM : corrections, changes from WWP team      -->
<!-- 94-03-24 : MSM : disambiguation of term, q (code, ident) -->
<!-- 92-12-09 : MSM : cosmetic copy editing                   -->
<!-- 92-12-09 : MSM : add space after some end-tags           -->
<!-- 92-12-07 : MSM : revise for release                      -->
<!-- 92-11-09 : MSM : suppress leading blanks in some elements -->
<!-- 92-11-09 : MSM : defang < note > in comment              -->
<!-- 20 oct : LB:   add some examples; reorder somewhat       -->
<!-- 1-7 oct 92 : LB : change ids to new scheme               -->
<!-- 24 Apr 92 : CMSMcQ : retag for TEI P2, add tag docs.     -->
<!-- 16 Oct 90 : CMSMcQ : TEI P1 version 1.1                  -->
<!-- 17 Jul 90 : CMSMcQ : TEI P1 version 1.0 sec. 5.3.8       -->
 
<div2 id=COLI><head>Lists</head>
 
<p>The following elements are provided for the encoding of lists,
their constituent items, and the labels or headings associated
with them:
 
<tagList>
<tagDesc tagDoc=LIST atts='type'>
<tagDesc tagDoc=ITEM atts='n'>
<tagDesc tagDoc=LABEL>
<tagDesc tagDoc=HEAD>
<tagDesc tagDoc=HEADLAB>
<tagDesc tagDoc=HEADIT>
</tagList>
 
<p>The <gi>list</gi> element should be used to mark any kind of
<term rend='noindex'>list</term>:
numbered, lettered, bulleted, or unmarked.  Lists formatted as such in
the copy text should in general be encoded using this element, with an
appropriate value for the <att>type</att> attribute.  Lists given as
run-on text may also be encoded using this element, where this is felt
to be appropriate.
 
<p>Each distinct item in the list should be encoded as a distinct
<gi>item</gi> element.  If the numbering or other identification for the
items in a list is unremarkable and may be reconstructed by any
processing program, no enumerator need be specified.  If however an
enumerator is retained in the encoded text, it may be supplied either by
using the <att>n</att> attribute on the <gi>item</gi> element, or by
using a <gi>label</gi> element.  The following examples are thus
equivalent:
 
<eg><![ CDATA [
I will add two facts, which have seldom occurred in
the composition of six, or at least of five quartos.
<list type=ordered rend=runon>
<label>(1)</><item>My first rough manuscript, without any
intermediate copy, has been sent to the press.</item>
<label>(2)</><item>Not a sheet has been seen by any human
eyes, excepting those of the author and the printer:
the faults and the merits are exclusively my own.</item>
</list>
]]>
</eg>
<eg><![ CDATA [
I will add two facts, which have seldom occurred in
the composition of six, or at least of five quartos.
<list type=ordered rend=runon>
<item n='1'>My first rough manuscript, without any
intermediate copy, has been sent to the press.</>
<item n='2'>Not a sheet has been seen by any human
eyes, excepting those of the author and the printer:
the faults and the merits are exclusively my own.</>
</list>
]]>
</eg>
 
The two styles may not be mixed in the same list:  if one item is
preceded by a label, all must be.
 
<p>A list need not necessarily be displayed in list format.  For
example,
 
<eg>
<![ CDATA [
On those remote pages it is written that animals are
divided into <list><item n='a'>those that belong to the
Emperor,</><item n='b'> embalmed ones, </><item n='c'> those
that are trained, </><item n='d'> suckling pigs, </><item n='e'>
mermaids,  </><item n='f'> fabulous ones, </><item n='g'> stray
dogs, </><item n='h'> those that are included in this
classification, </><item n='i'> those that tremble as if they
were mad, </><item n='j'> innumerable ones, </><item n='k'> those
drawn with a very fine camel's-hair brush, </><item n='l'>
others, </><item n='m'> those that have just broken a flower
vase, </><item n='n'> those that resemble flies from a
distance.</></list>
]]>
</eg>
<!-- Borges, tr. R. Simms 'The analytical language of John Wilkins' -->
<!-- in Monegal & Reid, Borges: a reader, (Dutton, 1981), p 141 -->
 
<p>A list may be given a heading or title, for which the <gi>head</gi>
element should be used, as in the next example, which also demonstrates
simple use of the <gi>label</gi> element to mark a tabular or glossary
list in which each item is associated with a word or phrase rather than
a numeric or alphabetic enumerator:
 
<eg>
<![ CDATA [
<list type=gloss>
<head>Report of the conduct and progress of Ernest Pontifex.
Upper Vth form &mdash half term ending Midsummer 1851</head>
<label>Classics</><item>Idle listless and unimproving</>
<label>Mathematics</><item>ditto</>
<label>Divinity</><item>ditto</>
<label>Conduct in house</><item>Orderly</>
<label>General conduct</><item>Not satisfactory, on account
of his great unpunctuality and inattention to duties</>
</list>
]]>
</eg><!-- S Butler, Way of all Flesh, -->
 
<p>In such a list, the individual items have internal structure.  In
complex cases, where list items contain many components, the list is
better treated as a <term rend='noindex'>table</term>, <indexed
level1='tables' level2='and lists'> on which see chapter <xref type=div1
target=FT>.  A particularly important instance of the simple two-column
table is the <soCalled>glossary list</soCalled>, which should be marked
by the tag <tag>list type=gloss</tag>.  In such lists, each
<gi>label</gi> element contains a term and each <gi>item</gi> its gloss;
it is a semantic error for a list tagged with <code
type=frag>type=gloss</code> not to have labels.  For example:
 
<!-- Moreland and Fleischer, Latin:  An Intensive Course, 53. -->
 
<eg>
<![ CDATA [
<list type=gloss>
<head>Unit Three -- Vocabulary</head>
<label lang=la>acerbus, -a, -m       </><item>bitter, harsh</>
<label lang=la>ager, agr&imacr;, M.  </><item>field</>
<label lang=la>audi&omacr;, &imacr;re,
       &imacr;v&imacr;, &imacr;tus   </><item>hear, listen (to)</>
<label lang=la>bellum, -&imacr;, N.  </><item>war</>
<label lang=la>bonus, -a, -um        </><item>good</>
<!-- etc. -->
</list>
]]>
</eg>
 
Additionally, the  <gi>term</gi> and <gi>gloss</gi> elements discussed
in section <xref target=COHQU> might be used to make explicit the role
that each column in the glossary list has, as follows:
 
<eg>
<![ CDATA [
<list type=gloss>
<head>Unit Three -- Vocabulary</head>
<label><term lang=la>acerbus, -a, -m</term></>
<item><gloss>bitter, harsh</gloss></item>
<label><term lang=la>ager, agr&imacr;, M. </term></>
<item><gloss>field</gloss></item>
<label><term lang=la>audi&omacr;, &imacr;re,
       &imacr;v&imacr;, &imacr;tus  </term></>
<item><gloss>hear, listen (to)</gloss></item>
<label><term lang=la>bellum, -&imacr;, N. </term></>
<item><gloss>war</gloss></item>
<label><term lang=la>bonus, -a, -um</term></>
<item><gloss>good</gloss></item>
<!-- etc. -->
</list>
]]>
</eg>
 
Note in the above examples the use of the global <att>lang</att>
attribute to specify on the <gi>label</gi> (or <gi>term</gi>) element
what language the term is from.  For further discussion of the
<att>lang</att> attribute see section <xref type=div2 target=STGA>, and
section <xref type=div2 target=CHSH>.  A more elaborate markup for this
glossary would distinguish the headword forms from the grammatical
information (principal parts and gender), using tags described more
fully in chapters <xref type=div1 target=TE> or <xref type=div1
target=DI>.
 
<p>In addition to the <gi>head</gi> element used to supply
a title or heading for the whole list, headings for the two
columns of a glossary-style list may be specified using
the two special elements <gi>headLabel</gi> and <gi>headItem</gi>:
 
<eg><![ CDATA [
The simple, straightforward statement of an idea is
preferable to the use of a worn-out expression.
<list type=gloss>
<headLabel>TRITE</>
<headItem>SIMPLE, STRAIGHTFORWARD</>
<label>bury the hatchet  </><item>stop fighting, make peace</>
<label>at loose ends     </><item>disorganized</>
<label>on speaking terms </><item>friendly</>
<label>fair and square   </><item>completely honest</>
<label>at death's door   </><item>near death</>
</list>
]]>
</eg><!-- Warriner's English Composition p. 280                    -->
 
<p>The elements <gi>label</gi>, <gi>head</gi>, <gi>headLabel</gi>, and
<gi>headItem</gi> may contain only phrase-level elements.  The
<gi>item</gi> element however may contain paragraphs or other
<soCalled>chunks</soCalled>, including other lists.  In this example, a
glossary list contains two items, each of which is itself a simple list:
 
<eg>
<![ CDATA [
<list type=gloss><label>EVIL</label>
<item><list type=simple>
   <item>I am cast upon a horrible desolate island, void
          of all hope of recovery.</item>
   <item>I am singled out and separated as it were from
         all the world to be miserable.</item>
   <item>I am divided from mankind &mdash a solitaire; one
           banished from human society.</item>
     </list> <!-- end of first nested list --></item>
<label>GOOD</label>
<item><list type=simple>
     <item>But I am alive; and not drowned, as all my
              ship's company were.</item>
     <item>But I am singled out, too, from all the ship's
             crew, to be spared from death...</item>
     <item>But I am not starved, and perishing on a barren place,
            affording no sustenances....</item>
     </list><!-- end of second nested list --></item>
</list><!-- end of glossary list -->
]]>
</eg>
<!-- D Defoe,  Robinson Crusoe  -->
 
<p>Lists of different types may be nested to arbitrary depths in this
way.
 
<p>The formal declarations for lists and list items are as follows.
<dtdFrag n='Lists and List Items' id=DCOLI>
<tagDecl tagDoc=LIST>
<tagDecl tagDoc=ITEM>
<tagDecl tagDoc=LABEL>
<tagDecl tagDoc=HEAD>
<tagDecl tagDoc=HEADLAB>
<tagDecl tagDoc=HEADIT >
</dtdFrag>
<?tei:EOF p2coli.odd ?>
