<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
Attributes
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.
Status Optional
Datatype teidata.enumerated
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
model.global.edit
Contained by
analysis: m phr s w
core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unit
dictionaries: form gen lang
figures: cell figure table
header: authority change classCode distributor edition extent funder geoDecl handNote language licence principal scriptNote sponsor
linking: ab seg
msdescription: accMat acquisition additions catchwords collation collection colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit institution layout material msItem musicNotation objectType origDate origPlace origin provenance repository rubric secFol signatures source stamp summary support surrogates typeNote watermark
namesdates: addName birth bloc country death district eventName floruit forename genName gender geogFeat geogName objectName offset orgName persName persPronouns person personGrp persona placeName region roleName settlement surname
textcrit: lem rdg wit
textstructure: back body dateline div docAuthor docDate docEdition docImprint docTitle epigraph floatingText front group text
transcr: damage fw line metamark mod retrace secl sourceDoc supplied surface surfaceGrp surplus zone
May contain
certainty: certainty precision
core: desc
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.

Example
<gap quantity="4" unit="chars"
 reason="illegible"/>
Example
<gap quantity="1" unit="essay"
 reason="sampling"/>
Example
<del>
 <gap atLeast="4" atMost="8" unit="chars"
  reason="illegible"/>
</del>
Example
<gap extent="several lines" reason="lost"/>
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>
Content model
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>
Schema 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 { teidata.enumerated }?,
   ( tei_model.descLike | tei_model.certLike )*
}