<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]
Modulecore — 3 Elements Available in All TEI Documents
Attributesatt.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.pointing (@target, @evaluate) att.internetMedia (@mimeType) att.typed (@type, @subtype) att.declaring (@decls)
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
Contained by
analysis: cl phr s span
core: abbr add addrLine analytic author bibl biblScope cit corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned monogr name note num orig p pubPlace publisher q quote ref reg relatedItem resp rs said series sic soCalled speaker stage street term textLang time title unclear
corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose
dictionaries: case colloc def dictScrap entry entryFree etym form gen gram gramGrp hyph iType lang lbl mood number orth per pos pron re sense stress subc syll tns usg xr
drama: actor camera caption castItem role roleDesc sound tech view
figures: cell figDesc notatedMusic
header: application authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage typeNote
iso-fs: fDescr fsDescr
linking: ab seg
msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates watermark
namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogName langKnown nameLink nationality occupation orgName persName placeName region residence roleName settlement sex socecStatus surname
nets: eLeaf eTree
spoken: u writing
tagdocs: valDesc
textcrit: lem rdg wit witDetail witness
textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer
transcr: damage fw metamark mod restore retrace supplied surplus
verse: metSym rhyme
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 gb 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 notatedMusic table
gaiji: g
header: biblFull idno
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 objectType origDate origPlace secFol signatures stamp watermark width
namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listOrg listPerson listPlace listRelation location nameLink offset orgName persName placeName population region relationGrp roleName settlement state surname terrain trait
spoken: incident kinesic pause shift vocal writing
tagdocs: att classSpec code eg egXML elementSpec gi ident listRef macroSpec moduleSpec specDesc specGrp specGrpRef specList tag val
textcrit: app listWit witDetail
textstructure: floatingText
transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace space subst substJoin supplied surplus undo
verse: caesura rhyme
Declaration

<rng:element name="ref">
 <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.pointing.attributes"/>
 <rng:ref name="att.internetMedia.attributes"/>
 <rng:ref name="att.typed.attributes"/>
 <rng:ref name="att.declaring.attributes"/>
 <rng:optional>
  <rng:attribute name="cRef">
   <rng:list>
    <rng:ref name="data.word"/>
    <rng:zeroOrMore>
     <rng:ref name="data.word"/>
    </rng:zeroOrMore>
   </rng:list>
  </rng:attribute>
 </rng:optional>
 <rng:ref name="macro.paraContent"/>
</rng:element>
element ref
{
   att.global.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.pointing.attributes,
   att.internetMedia.attributes,
   att.typed.attributes,
   att.declaring.attributes,
   attribute cRef { list { data.word, data.word* } }?,
   macro.paraContent
}
Schematron

<s:report test="@target and @cRef">Only one of the
attributes 'target' and 'cRef' may be supplied.</s:report>
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.