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 or inaudible. 3.4.3 Additions, Deletions, and Omissions

Module

core — 3 Elements Available in All TEI Documents

Attributes

[att.duration att.editLike ]

reason

gives the reason for omission. Sample values include sampling, illegible, inaudible, irrelevant, cancelled, cancelled and 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)

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.

Contained by

model.global.edit

May contain

core: desc gloss

tagdocs: altIdent equiv

P5: Guidelines for Electronic Text Encoding and Interchange

<gap>