<head>

<head> (heading) contains any type of heading, for example the title of a section, or the heading of a list, glossary, manuscript description, etc. [4.2.1. Headings and Trailers]

Module

core

Attributes

Attributes att.typed (type) att.placement (place) att.written (hand) att.global (@xml:id, @n, @xml:lang) lim.att.global.fragmentable (@part) att.global.source (@source)

rendition

points to a description of the rendering or presentation used for this element in the source text.

Derived from	att.global.rendition
Status	Optional
Schematron	The two column layout requires one item to be left and one item to be right. <sch:rule context="tei:[contains-token(@rendition,'rnd:two-column')]"> <sch:let name="children" value="child::tei:"/> <sch:let name="leftChild" value="$children[contains-token(@rendition,'rnd:left')]"/> <sch:let name="rightChild" value="$children[contains-token(@rendition, 'rnd:right')]"/> <sch:assert test="exists($children) and (count(($leftChild, $rightChild)) = count($children))">ERROR: Every child of a two column layout must have either a rnd:right or a rnd:left rendition value.</sch:assert> <sch:assert test="exists($leftChild) and exists($rightChild)">ERROR: There must be at least one rnd:left and one rnd:right child</sch:assert> </sch:rule>
Schematron	Some renditions contradict each other <sch:rule context="tei:*[@rendition]"> <sch:let name="rendition" value="@rendition"/> <sch:let name="ptrs" value="tokenize(@rendition,'\s+')"/> <sch:let name="tokens" value="for $p in $ptrs return substring-after($p,'rnd:')"/> <sch:let name="duplicates" value="$tokens[count(index-of($tokens, .)) gt 1]"/> <sch:assert test="empty($duplicates)">ERROR: Duplicate renditions found: <sch:value-of select="string-join($duplicates,', ')"/>. Do not use the same rendition more than once on a single element.</sch:assert> <sch:assert test="count($tokens[. = ('left','right','center')]) lt 2">ERROR: rnd:right, rnd:left, or rnd:center are mutually exclusive.</sch:assert> <sch:assert test="count($tokens[. = ('large','small')]) lt 2">ERROR: rnd:large and rnd:small are mutually exclusive.</sch:assert> <sch:assert test="count($tokens[. = ('bordered-bottom','bordered-bottom-dashed')]) lt 2">ERROR: rnd:bordered-bottom and rnd:bordered-bottom-dashed are mutually exclusive.</sch:assert> </sch:rule>
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace
Legal values are:	rnd:hidden (hidden) A heading that is hidden (for accessibility purposes).

Member of

model.headLike model.pLike.front

Contained by

core: divGen lg list listBibl

figures: figure table

lim: NB

msdescription: msDesc msPart

namesdates: listObject listOrg listPerson listPlace

textstructure: body div front postscript

May contain

analysis: pc w

core: abbr add biblStruct choice date del desc ellipsis emph foreign gap gloss graphic hi l label lb lg list listBibl mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs sic term time title unclear

figures: figure table

gaiji: g

header: idno

lim: noteMarker rule

linking: linkGrp

msdescription: locusGrp msDesc

namesdates: addName affiliation forename genName geo listObject listOrg listPerson listPlace location nameLink objectName orgName persName placeName roleName settlement surname

transcr: damage fw handShift subst supplied

character data

Note

The head element is used for headings at all levels; software which treats (e.g.) chapter headings, section headings, and list titles differently must determine the proper processing of a head element based on its structural position. A head occurring as the first element of a list is the title of that list; one occurring as the first element of a div1 is the title of that chapter or section.

Examples

The most common use for the head element is to mark the headings of sections. In older writings, the headings or incipits may be rather longer than usual in modern works. If a section has an explicit ending as well as a heading, it should be marked as a trailer, as in this example:

<div1 n="I" type="book">
   <head>In the name of Christ here begins the first book of the ecclesiastical history of
      Georgius Florentinus, known as Gregory, Bishop of Tours.</head>
   <div2 type="section">
      <head>In the name of Christ here begins Book I of the history.</head>
      <p>Proposing as I do ...</p>
      <p>From the Passion of our Lord until the death of Saint Martin four hundred and twelve
        years passed.</p>
      <trailer>Here ends the first Book, which covers five thousand, five hundred and ninety-six
        years from the beginning of the world down to the death of Saint Martin.</trailer>
   </div2>
</div1>

When headings are not inline with the running text (see e.g. the heading "Secunda conclusio") they might however be encoded as if. The actual placement in the source document can be captured with the place attribute.

<div type="subsection">
   <head place="margin">Secunda conclusio</head>
   <p>
      <lb n="1251"/>
      <hi rend="large">Potencia: habitus: et actus: recipiunt speciem ab obiectis<supplied>.</supplied>
      </hi>
      <lb n="1252"/>Probatur sic. Omne importans necessariam habitudinem ad proprium
       [...]
     </p>
</div>

The head element is also used to mark headings of other units, such as lists:

With a few exceptions, connectives are equally
useful in all kinds of discourse: description, narration, exposition, argument. <list rend="bulleted">
<head>Connectives</head>
<item>above</item>
<item>accordingly</item>
<item>across from</item>
<item>adjacent to</item>
<item>again</item>
<item></item>
</list>

Schematron

<sch:rule context="tei:head[matches(@rendition,'rnd:hidden')]">
<sch:assert test="$isBornDigital">ERROR: Only use rnd:hidden in born digital documents.</sch:assert>
</sch:rule>

Source

Github

<elementSpec rend="change" module="core" ident="head">
   <gloss>heading</gloss>
   <desc>contains any type of heading, for example the title of a section, or the heading of a list,
glossary, manuscript description, etc.</desc>
   <classes>
      <memberOf key="att.global"/>
      <memberOf key="att.typed"/>
      <memberOf key="att.placement"/>
      <memberOf key="att.written"/>
      <memberOf key="model.headLike"/>
      <memberOf key="model.pLike.front"/>
   </classes>
   <content>
      <alternate minOccurs="0" maxOccurs="unbounded">
         <textNode/>
         <elementRef key="lg"/>
         <classRef key="model.gLike"/>
         <classRef key="model.phrase"/>
         <classRef key="model.inter"/>
         <classRef key="model.lLike"/>
         <classRef key="model.global"/>
      </alternate>
   </content>
   <attList>
      <attDef ident="rendition" mode="change">
         <valList type="closed" mode="change">
            <valItem mode="add" ident="rnd:hidden">
               <gloss>hidden</gloss>
               <desc>A heading that is
                             hidden (for accessibility purposes).</desc>
            </valItem>
         </valList>
      </attDef>
   </attList>
</elementSpec>