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.4.3 Additions, Deletions, and Omissions

Module

core — 3 Elements Available in All TEI Documents

Attributes

att.duration att.duration.w3c (@dur) att.duration.iso (@dur-iso) att.editLike (@cert, @resp, @evidence, @source)

reason

gives 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.

hand

in 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).

agent

In 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

extent

indicates 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.

unit

names 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

Example

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.

P5: Guidelines for Electronic Text Encoding and Interchange

<gap>