| | 1 | == Simple pointers and links: within a document by Id attribute == |
| | 2 | |
| | 3 | <ptr> a pointer to another location in the current document in terms of one or more identifiable elements. |
| | 4 | |
| | 5 | <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. |
| | 6 | |
| | 7 | <link> defines an association or hypertextual link among elements or passages, of some type not more precisely specifiable by other elements. |
| | 8 | (auch zwischen verschiedenen Dokumenten möglich) |
| | 9 | Beispiel: |
| | 10 | <note id="n3.284" type="imitation" place="foot" anchored="no"> |
| | 11 | <ref id="r3.284" rend="sc"> |
| | 12 | <!-- ... --> |
| | 13 | </ref> |
| | 14 | </note> |
| | 15 | <link targType="ref l" targOrder="Y" targets="r3.284 l3.284"/> |
| | 16 | |
| | 17 | <linkGrp> Linkgruppen |
| | 18 | Beispiel: |
| | 19 | <linkGrp type="imitation" targType="note l" targOrder="Y"> |
| | 20 | <link targets="n2.79 l2.79"/> |
| | 21 | <link targets="n2.88 l2.88"/> |
| | 22 | <!-- ... --> |
| | 23 | <link targets="n3.284 l3.284"/> |
| | 24 | <!-- ... --> |
| | 25 | </linkGrp> |
| | 26 | |
| | 27 | <anchor> specifies a location or point within a document so that it may be pointed to. |
| | 28 | <seg> identifies a span or segment of text within a document so that it may be pointed to. |
| | 29 | |
| | 30 | == Extended pointers: Between documents and by XPointer == |
| | 31 | |
| | 32 | <xptr> defines a pointer to another location in the current document or an external document. |
| | 33 | Examples: |
| | 34 | <p>This is discussed in <xptr doc="TEIP3"/>.</p> |
| | 35 | <xptr doc="OrbisPictus" from="id (animalia)"/> |
| | 36 | <xptr doc="OrbisPictus" from="id (animalia)" to="id (aquaticae)"/> |
| | 37 | <xptr doc="P3" from="id (SA) child (3 p)"/> (the third <p> element directly contained by whatever element has the identifier SA) |
| | 38 | HTML: |
| | 39 | <p>This is discussed in <xptr url="http://www.tei-c.org/TEI/Guidelines/SA.html"/> |
| | 40 | |
| | 41 | <xref> defines a pointer to another location in the current document or an external document, possibly modified by additional text or comment. |
| | 42 | Examples: |
| | 43 | <p>This is discussed in <xref doc="TEIP3">The TEI Guidelines</xref>.</p> |
| | 44 | HTML: |
| | 45 | <p>This is discussed in <xref url="http://www.tei-c.org/TEI/Guidelines/SA.html">the chapter on linking</xref> |
| | 46 | --> HTML: <p>This is discussed in <a href="http://www.tei-c.org/TEI/Guidelines/SA.html">the chapter on linking</a> |
| | 47 | <p>This is discussed in <xref doc="TEIP3SA" from="id(SAXR)">the chapter on linking</xref>.</p> |
| | 48 | --> HTML: <p>This is discussed in <a href="http://www.tei-c.org/TEI/Guidelines/SA.html#SAXR">the subsection on external linking</a> |
| | 49 | |
| | 50 | In a URL: |
| | 51 | |
| | 52 | example.xml#xpointer((//p)[1]) |
| | 53 | example.xml#xpointer(id('4711')/div[1]) |
