<gap>

<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.5.3. Additions, Deletions, and Omissions]
Modulecore
AttributesAttributes att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.dimensions (@precision, @unit, @quantity, @extent, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.timed (@start, @end) att.duration.iso (@dur-iso)
reason
Status Required
Legal values are:
lost
Text completely lost from the surface and unrecoverable
illegible
Traces of text remains on the surface but cannot be interpreted
omitted
Text erroneously omitted from the surface by the scribe/cutter
ellipsis
Text omitted from the edition by the editor, for whatever reason (brevity, context, language, etc.)
undefined
Text omitted from the edition by the editor without specification of current state of this text (NB this should not be possible with valid Leiden Conventions)
agent(agent) in the case of text omitted because of damage, categorizes the cause of the damage, if it can be identified. Sample values include: 1] rubbing(rubbing) ; 2] mildew(mildew) ; 3] smoke(smoke)
Status Optional
Datatype
Sample values include:
rubbing
(rubbing) damage results from rubbing of the leaf edges
mildew
(mildew) damage results from mildew on the leaf surface
smoke
(smoke) damage results from smoke
Member of
Contained by
May contain
certainty: certainty precision
core: desc
Declaration
element gap
{
   tei_att.global.attributes,
   tei_att.timed.attribute.start,
   tei_att.timed.attribute.end,
   tei_att.duration.iso.attribute.dur-iso,
   tei_att.editLike.attributes,
   tei_att.dimensions.attributes,
   attribute reason
   {
      "lost" | "illegible" | "omitted" | "ellipsis" | "undefined"
   },
   attribute agent { text }?,
   ( tei_model.descLike | tei_model.certLike )*
}
Schematron

<sch:rule context="tei:gap">
<sch:report test="@quantity and @extent">gap may have @quantity (a figure) or @extent (a descriptive text value) but not both</sch:report>
<sch:report test="@quantity and not(@unit)">If gap has @quantity then @unit is required</sch:report>
<sch:report test="not(@reason='ellipsis') and ancestor::tei:supplied[not(@reason='undefined')]">gap may not appear within supplied text</sch:report></sch:rule>
Example
<gap quantity="4unit="chars"
 reason="illegible"/>
Example
<gap quantity="1unit="essay"
 reason="sampling"/>
Example
<del>
 <gap atLeast="4atMost="8unit="chars"
  reason="illegible"/>

</del>
Example
<gap extent="several linesreason="lost"/>
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.3.3.2. Use of the gap, del, damage, unclear, and supplied Elements in Combination for discussion of which element is appropriate for which circumstance.

The gap tag simply signals the editors decision to omit or inability to transcribe a span of text. Other information, such as the interpretation that text was deliberately erased or covered, should be indicated using the relevant tags, such as del in the case of deliberate deletion.