TEI element refState (reference state)

<refState>

<refState> (reference state) specifies one component of a canonical reference defined by the milestone method. [2.3.5.3 Milestone Method 2.3.5 The Reference System Declaration]

Module

header — 2 The TEI Header

Attributes

att.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) att.sourced (@ed)

unit

indicates what kind of state is changing at this milestone.

Status	Required
Datatype	<rng:ref name="data.enumerated"/> data.enumerated
Suggested values include:	page page breaks in the reference edition. column column breaks. line line breaks. book any units termed book, liber, etc. poem individual poems in a collection. canto cantos or other major sections of a poem. stanza stanzas within a poem, book, or canto. act acts within a play. scene scenes within a play or act. section sections of any kind. absent passages not present in the reference edition.

length

specifies the fixed length of the reference component.

Status	Optional
Datatype	<rng:ref name="data.count"/> data.count
Values	Should be a positive integer; if no value is provided, the length is unlimited and goes to the next delimiter or to the end of the value.
Note	When constructing a reference, if the reference component found is of numeric type, the length is made up by inserting leading zeros; if it is not, by inserting trailing blanks. In either case, reference components are truncated if necessary at the right hand side. When seeking a reference, the length indicates the number of characters which should be compared. Values longer than this will be regarded as matching, if they start correctly.

delim

(delimiter) supplies a delimiting string following the reference component.

Status	Optional
Datatype	<rng:text/> text
Values	If a single space is used it is interpreted as whitespace.

Used by

Contained by

header: refsDecl

May contain

Empty element

Declaration


<rng:element name="refState">
 <rng:ref name="att.global.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.sourced.attributes"/>
 <rng:attribute name="unit">
  <rng:choice>
   <rng:value>page</rng:value>
   <rng:value>column</rng:value>
   <rng:value>line</rng:value>
   <rng:value>book</rng:value>
   <rng:value>poem</rng:value>
   <rng:value>canto</rng:value>
   <rng:value>stanza</rng:value>
   <rng:value>act</rng:value>
   <rng:value>scene</rng:value>
   <rng:value>section</rng:value>
   <rng:value>absent</rng:value>
   <rng:data type="Name"/>
  </rng:choice>
 </rng:attribute>
 <rng:optional>
  <rng:attribute name="length">
   <rng:ref name="data.count"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="delim">
   <rng:text/>
  </rng:attribute>
 </rng:optional>
 <rng:empty/>
</rng:element>

element refState
{
   att.global.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.sourced.attributes,
   attribute unit
   {
      "page"
    | "column"
    | "line"
    | "book"
    | "poem"
    | "canto"
    | "stanza"
    | "act"
    | "scene"
    | "section"
    | "absent"
    | xsd:Name
   },
   attribute length { data.count }?,
   attribute delim { text }?,
   empty
}

Example

Show all

P5: Guidelines for Electronic Text Encoding and Interchange

<refState>