<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]
Module core — Elements Available in All TEI Documents
Attributes
reason⚓︎ (reason) gives the reason for omission
Status Optional
Datatype 1–∞ occurrences of teidata.enumerated separated by whitespace
Suggested values include:
cancelled
(cancelled)
deleted
(deleted)
editorial
(editorial) for features omitted from transcription due to editorial policy
illegible
(illegible)
inaudible
(inaudible)
irrelevant
(irrelevant)
sampling
(sampling)
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: cl m phr s span w
cmc: post
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 unclear unit
corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose
dictionaries: case colloc def dictScrap entry entryFree etym form gen gram gramGrp hom hyph iType lang lbl mood number orth per pos pron re sense stress subc syll tns usg xr
drama: actor camera caption castGroup castItem castList epilogue performance prologue role roleDesc set sound spGrp tech view
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 affiliation age birth bloc country death district education eventName faith floruit forename genName gender geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname
nets: graph
spoken: u writing
tagdocs: eg valDesc
textcrit: lem rdg wit witDetail
textstructure: argument back body byline closer dateline div div1 div2 div3 div4 div5 div6 div7 docAuthor docDate docEdition docImprint docTitle epigraph floatingText front group imprimatur opener postscript salute signed text titlePage titlePart trailer
transcr: damage fw line metamark mod restore retrace secl sourceDoc supplied surface surfaceGrp surplus zone
verse: metSym rhyme
May contain
certainty: certainty precision respons
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 12.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"/>
Content model 
<content>
 <alternate minOccurs="0"
  maxOccurs="unbounded">
  <classRef key="model.descLike"/>
  <classRef key="model.certLike"/>
 </alternate>
</content>
Schema Declaration 
<rng:element name="gap">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.global.source.attributes"/>
 <rng:ref name="att.timed.attributes"/>
 <rng:ref name="att.duration.w3c.attributes"/>
 <rng:ref name="att.duration.iso.attributes"/>
 <rng:ref name="att.editLike.attributes"/>
 <rng:ref name="att.dimensions.attributes"/>
 <rng:ref name="att.ranging.attributes"/>
 <rng:ref name="att.cmc.attributes"/>
 <rng:optional>
  <rng:attribute name="reason">
   <rng:list>
    <rng:oneOrMore>
     <rng:choice>
      <rng:value>cancelled</rng:value>
      <rng:value>deleted</rng:value>
      <rng:value>editorial</rng:value>
      <rng:value>illegible</rng:value>
      <rng:value>inaudible</rng:value>
      <rng:value>irrelevant</rng:value>
      <rng:value>sampling</rng:value>
      <rng:ref name="teidata.enumerated"/>
     </rng:choice>
    </rng:oneOrMore>
   </rng:list>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="agent">
   <rng:ref name="teidata.enumerated"/>
  </rng:attribute>
 </rng:optional>
 <rng:zeroOrMore>
  <rng:choice>
   <rng:ref name="model.descLike"/>
   <rng:ref name="model.certLike"/>
  </rng:choice>
 </rng:zeroOrMore>
</rng:element>
element gap
{
   att.global.attributes,
   att.global.rendition.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.global.responsibility.attributes,
   att.global.source.attributes,
   att.timed.attributes,
   att.duration.w3c.attributes,
   att.duration.iso.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   att.ranging.attributes,
   att.cmc.attributes,
   attribute reason
   {
      list
      {
         (
            "cancelled"
          | "deleted"
          | "editorial"
          | "illegible"
          | "inaudible"
          | "irrelevant"
          | "sampling"
          | teidata.enumerated
         )+
      }
   }?,
   attribute agent { teidata.enumerated }?,
   ( model.descLike | model.certLike )*
}