<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
In addition to global attributes att.pointing (@type, @evaluate) att.declaring (@decls)
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 whitespace. 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 value of cRef should be constructed so that when the algorithm for the resolution of canonical references (described in section 16.2.5 Canonical References) is applied to it the result is 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.
Used by
model.ptrLike
May contain
analysis: c cl interp interpGrp m pc phr s span spanGrp w
certainty: certainty precision respons
core: abbr add address bibl biblStruct binaryObject cb choice cit corr date del desc distinct email emph expan foreign gap gloss graphic hi index label lb list listBibl measure measureGrp mentioned milestone name note num orig pb ptr q quote ref reg rs said sic soCalled stage term time title unclear
dictionaries: lang oRef oVar pRef pVar
drama: camera caption castList move sound tech view
figures: figure formula table
gaiji: g
header: biblFull
iso-fs: fLib fs fvLib
linking: alt altGrp anchor join joinGrp link linkGrp seg timeline
msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc origDate origPlace secFol signatures stamp watermark width
namesdates: addName affiliation bloc country district forename genName geo geogFeat geogName listEvent listNym listOrg listPerson listPlace nameLink offset orgName persName placeName region roleName settlement state surname
spoken: incident kinesic pause shift vocal writing
tagdocs: att classSpec code eg egXML elementSpec gi ident listRef macroSpec moduleRef moduleSpec specDesc specGrp specGrpRef specList tag val
textcrit: app listWit witDetail
transcr: addSpan am damage damageSpan delSpan ex fw handShift restore space subst supplied surplus
verse: caesura rhyme
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
<ref
  target="http://www.natcorp.ox.ac.uk/Texts/A02.xml#s2"> See especially the second
sentence</ref> See also <ref>s.v. <term>locution</term>
</ref>.>
Note
The target and cRef attributes are mutually exclusive.