ref

<ref>

<ref> (reference) defines a reference to another location, possibly modified by additional text or comment. 3.6 Simple Links and Cross References 16.1 Links

Module core — 3 Elements Available in All TEI Documents

Attributes

[att.pointing att.declaring ]

target

specifies the destination of the reference by supplying one or more URI References

Status	Optional
Datatype	1–∞ occurrences of <rng:ref name="data.pointer"/> data.pointer separated by whitespace
Values	One or more syntactically valid URI references, separated by white space. Because whitespace is used to separate URIs, no whitespace is permitted inside a single URI. If a whitespace character is required in a URI, it should be escaped with the normal mechanism, e.g. `TEI%20Consortium`.

cRef

(canonical reference) specifies the destination of the reference by supplying a canonical reference from a scheme defined in a refsDecl element in the TEI header

Status	Optional
Datatype	1–∞ occurrences of <rng:ref name="data.word"/> data.word separated by whitespace
Values	the result of applying the algorithm for the resolution of canonical references (described in section 16.2.5 Canonical References) should be a valid URI reference to the intended target
Note	The refsDecl to use may be indicated with the decls attribute. Currently these Guidelines only provide for a single canonical reference to be encoded on any given ref element.

Declaration

<rng:element name="ref">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.pointing.attributes"/>
 <rng:ref name="att.declaring.attributes"/>
 <rng:choice>
  <rng:optional>
   <rng:attribute name="target">
    <rng:list>
     <rng:oneOrMore>
      <rng:ref name="data.pointer"/>
     </rng:oneOrMore>
    </rng:list>
   </rng:attribute>
  </rng:optional>
  <rng:optional>
   <rng:attribute name="cRef">
    <rng:list>
     <rng:oneOrMore>
      <rng:ref name="data.word"/>
     </rng:oneOrMore>
    </rng:list>
   </rng:attribute>
  </rng:optional>
 </rng:choice>
 <rng:ref name="macro.paraContent"/>
</rng:element>

element ref
{
   att.global.attributes,
   att.pointing.attributes,
   att.declaring.attributes,
   (
      attribute target { list { data.pointer+ } }?
    | attribute cRef { list { data.word+ } }?
   ),
   macro.paraContent
}

Example