## Text Encoding Initiative

### The XML Version of the TEI Guidelines

# xPointer

`xPointer` | (extended-pointer elements) defines a set of attributes used by all those elements which use the TEI extended pointer mechanism to point at locations which have neither an SGML nor an XML ID.
Member of classes | pointer
Members | xptr xref

Declaration

    <!ENTITY % a.xPointer '
          %a.pointer;
          doc ENTITY #IMPLIED
          from %extPtr; "ROOT"
          to %extPtr; "DITTO"'>

Attributes

(In addition to global attributes and those inherited from pointer)

`doc` | (document or file) specifies the document within which the desired location is to be found.
| Datatype: ENTITY
| Values: The name of a system entity associated with the document within which the target of this extended pointer is to be found, by default the current document.
| Default: #IMPLIED

Example:

    <xptr doc="Chap2" from="id (e23)"/>

Note | The system entity named by this attribute must be declared in the DTD of the document containing the extended pointer. This should be declared as an external entity (parsed or unparsed); in an SGML document it may be declared as a SUBDOC entity, but this is not recommended.

`from` | specifies the start of the destination of the pointer, as an expression in the TEI extended-pointer notation described in section 14.2.2 Extended Pointer Syntax.
| Datatype: %extPtr;
| Values: The value specified must be a valid expression in the TEI extended pointer notation defined in section 14.2.2 Extended Pointer Syntax.
| Default: ROOT

Example:

Note | If no value is specified, the target is the whole of the document identified by the `doc` attribute.
`to` | specifies the endpoint of the destination of the pointer, as an expression in the TEI extended pointer notation.
| Datatype: %extPtr;
| Values: The value specified must be a valid expression in the TEI extended pointer notation defined in section 14.2 Extended Pointers.
| Default: DITTO

Example:

    <xptr doc="OrbisPictus" from="id (animalia)" to="id (aquaticae)"/>

Note

This attribute may only be supplied if the `from` attribute is also supplied, in which case the destination is defined to extend from the beginning of the location specified by the `from` attribute, up to the end of that specified by the `to` attribute. It is an error for the `to` attribute to specify a location whose end precedes the beginning of the location specified by `from`; it is not an error for the scopes to overlap.

If no value is specified, the target is the location specified by the `from` attribute.

Note

This class belongs to the larger class pointer, which means its elements also inherit the attributes of that class.

Module Declared in file dummy; Declared in file teiclas2.ent; Additional tag set for Linking and Segmentation: enabled by TEI.linking
Class pointer
See further 14.2 Extended Pointers

Up: 33 Element Classes