<gap>

<gap> indicates a point where material has been omitted in a transcription, whether for editorial reasons described in the TEI header, as part of sampling practice, or because the material is illegible, invisible, or inaudible. 3.4.3 Additions, Deletions, and Omissions
Modulecore — 3 Elements Available in All TEI Documents
Attributes att.durationatt.duration.w3c (@dur) att.duration.iso (@dur-iso) att.editLike (@cert, @resp, @evidence, @source, @precision)
reasongives the reason for omission. Sample values include sampling, illegible, inaudible, irrelevant, cancelled, illegible.
Status Optional
Datatype 1–∞ occurrences of

<rng:ref name="data.word"/>
data.word
separated by whitespace
Values any short indication of the reason for the omission.
handin the case of text omitted from the transcription because of deliberate deletion by an identifiable hand, signifies the hand which made the deletion.
Status Optional
Datatype

<rng:ref name="data.pointer"/>
data.pointer
Values must be one of the hand identifiers declared in the document header (see section 11.4.1 Document Hands).
agentIn the case of text omitted because of damage, categorizes the cause of the damage, if it can be identified.
Status Optional
Datatype

<rng:ref name="data.enumerated"/>
data.enumerated
Sample values include:
rubbing
damage results from rubbing of the leaf edges
mildew
damage results from mildew on the leaf surface
smoke
damage results from smoke
extentindicates approximately how much text has been omitted from the transcription (using the unit specified on the unit attribute), either because of editorial policy or because a deletion, damage, or other cause has rendered transcription impossible.
Status Optional
Datatype

<rng:ref name="data.numeric"/>
data.numeric
Note
It is possible, but not always necessary, to provide measurements precise to the millimeter or even to the printer's point. The degree of precision attempted will vary with the purpose of the encoding and the nature of the material.
unitnames the unit used for describing the extent of the gap
Status Optional
Datatype

<rng:ref name="data.enumerated"/>
data.enumerated
Suggested values include:
lines
lines of text
chars
(characters) characters of text
pages
pages, i.e. one side of a leaf
cm
(centimetres)
mm
(millimetres)
in
(inches)
Used by model.global.edit
May contain
core: desc gloss
tagdocs: altIdent equiv
Declaration

<rng:element name="gap">
<rng:ref name="att.global.attributes"/>
<rng:ref name="att.duration.w3c.attributes"/>
<rng:ref name="att.duration.iso.attributes"/>
<rng:ref name="att.editLike.attributes"/>
<rng:optional>
 <rng:attribute name="reason">
  <rng:list>
   <rng:oneOrMore>
    <rng:ref name="data.word"/>
   </rng:oneOrMore>
  </rng:list>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="hand">
  <rng:ref name="data.pointer"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="agent">
  <rng:ref name="data.enumerated"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="extent">
  <rng:ref name="data.numeric"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="unit">
  <rng:choice>
   <rng:value>lines</rng:value>
   <rng:value>chars</rng:value>
   <rng:value>pages</rng:value>
   <rng:value>cm</rng:value>
   <rng:value>mm</rng:value>
   <rng:value>in</rng:value>
   <rng:data type="Name"/>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:zeroOrMore>
 <rng:ref name="model.glossLike"/>
</rng:zeroOrMore>
</rng:element>
element gap
{
   att.global.attributes,
   att.duration.w3c.attributes,
   att.duration.iso.attributes,
   att.editLike.attributes,
   attribute reason { list { data.word+ } }?,
   attribute hand { data.pointer }?,
   attribute agent { data.enumerated }?,
   attribute extent { data.numeric }?,
   attribute unit
   {
      "lines" | "chars" | "pages" | "cm" | "mm" | "in" | xsd:Name
   }?,
   model.glossLike*
}
Example
<gap extent="4unit="charsreason="illegible"/>
Example
<gap extent="1unit="essayreason="sampling"/>
Note
The gap, unclear, and del core tag elements may be closely allied in use with the damage and supplied elements, available when using the additional tagset for transcription of primary sources. See section 11.5.2 Use of the <gap>, <del>, <damage>, <unclear>, and <supplied> Elements in Combination for discussion of which element is appropriate for which circumstance.