refState

<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

In addition to global attributes

(edition) indicates which edition or version the milestone applies to.

Status	Optional
Datatype	<rng:ref name="data.code"/> data.code
Values	Any string of characters; usually a siglum conventionally used for the edition.
Note	If ed is not specified, then any milestone tag with an appropriate unit attribute will be selected.

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.

Declaration

<rng:element name="refState">
 <rng:ref name="att.global.attributes"/>
 <rng:optional>
  <rng:attribute name="ed">
   <rng:ref name="data.code"/>
  </rng:attribute>
 </rng:optional>
 <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,
   attribute ed { data.code }?,
   attribute unit
   {
      "page"
    | "column"
    | "line"
    | "book"
    | "poem"
    | "canto"
    | "stanza"
    | "act"
    | "scene"
    | "section"
    | "absent"
    | xsd:Name
   },
   attribute length { data.count }?,
   attribute delim { text }?,
   empty
}

Example

Contained by

refsDecl

May contain

Empty element

P5: Guidelines for Electronic Text Encoding and Interchange

<refState>