Pointers and links

XLink

See ​XML Linking Language (XLink) Version 1.0.

Each element could use the XLink attributes for example:

• <p>The best german punk band is <div xlink:href="http://slime.de/">Slime</div>.</p>

XPointer

See ​XML Pointer Language (XPointer). XPointer could be used in URI's such as provided by XLink. Examples:

• <p>This is discussed in <div xlink:href="example.xml#xpointer((//p)[1])">the first paragraph of the example document</div>.</p>
• <p>This is discussed in <div xlink:href="example.xml#xpointer(id('4711')/div[1])">the first division of the example document</div>.</p>

XPoints

• Examples
  • point(1.0) is just inside the beginning of the p element.
  • point(1.2) is between the end of the em element and the following text node (which contains "world.").
  • point(.0) immediately precedes the root node.
  • point(1/2/1.1) immediately following the "b" in the middle text node.

Range

• xpointer(id("chap1")/range-to(id("chap2"))) (the range from the start point of the element with ID "chap1" to the end point of the element with ID "chap2")
• string-range(title,"Thomas Pynchon")[17] (the 17th of those "Thomas Pynchon" strings appearing in a title element)
• ...

TEI: Elements for simple pointers and links

• <ptr> a pointer to another location in the current document in terms of one or more identifiable elements.

• <ref> a reference to another location in the current document, in terms of one or more identifiable elements, possibly modified by additional text or comment.

• <link> defines an association or hypertextual link among elements or passages, of some type not more precisely specifiable by other elements (also possible between different documents)
  • Example: <note id="n3.284" type="imitation" place="foot" anchored="no"> <ref id="r3.284" rend="sc">...</ref> </note> <link targType="ref l" targOrder="Y" targets="r3.284 l3.284"/>

• <linkGrp> Link groups
  • Example: <linkGrp type="imitation" targType="note l" targOrder="Y"> <link targets="n2.79 l2.79"/> <link targets="n2.88 l2.88"/> <!-- ... --> <link targets="n3.284 l3.284"/> <!-- ... --> </linkGrp>

• <anchor> specifies a location or point within a document so that it may be pointed to.
• <seg> identifies a span or segment of text within a document so that it may be pointed to.

TEI: Elements for extended pointers

(also TEI XPointer could be used)

• <xptr> defines a pointer to another location in the current document or an external document.
  • Examples:
    • <p>This is discussed in <xptr doc="TEIP3"/>.</p>
    • <xptr doc="OrbisPictus?" from="id (animalia)"/>
    • <xptr doc="OrbisPictus?" from="id (animalia)" to="id (aquaticae)"/>
    • <xptr doc="P3" from="id (SA) child (3 p)"/> (the third <p> element directly contained by whatever element has the identifier SA)
    • <p>This is discussed in <xptr url="​http://www.tei-c.org/TEI/Guidelines/SA.html"/>

• <xref> defines a pointer to another location in the current document or an external document, possibly modified by additional text or comment.
  • Examples:
    • <p>This is discussed in <xref doc="TEIP3">The TEI Guidelines</xref>.</p>
    • <p>This is discussed in <xref url="​http://www.tei-c.org/TEI/Guidelines/SA.html">the chapter on linking</xref> --> HTML: <p>This is discussed in <a href="​http://www.tei-c.org/TEI/Guidelines/SA.html">the chapter on linking</a>
    • <p>This is discussed in <xref doc="TEIP3SA" from="id(SAXR)">the chapter on linking</xref>.</p> --> HTML: <p>This is discussed in <a href="​http://www.tei-c.org/TEI/Guidelines/SA.html#SAXR">the subsection on external linking</a>