<ptr> is an empty internal linking element that uses attributes to provide for movement from one place in a finding aid to another place in the same finding aid. As an empty element, it cannot contain text or subelements. If the referenced object should be described, use <ref>. If the link should point to an external electronic object which is not part of the described materials, use <extptr> instead.
<ptr> may be used within: <abstract>, <addressline>, <archref>, <author>, <bibref>, <bibseries>, <container>, <corpname>, <creation>, <date>, <descrules>, <dimensions>, <edition>, <emph>, <entry>, <event>, <extent>, <extref>, <extrefloc>, <famname>, <function>, <genreform>, <geogname>, <head>, <head01>, <head02>, <imprint>, <indexentry>, <item>, <label>, <langmaterial>, <language>, <langusage>, <legalstatus>, <materialspec>, <name>, <num>, <occupation>, <origination>, <p>, <persname>, <physdesc>, <physfacet>, <physloc>, <ptrgrp>, <publisher>, <ref>, <refloc>, <repository>, <runner>, <sponsor>, <subarea>, <subject>, <subtitle>, <title>, <titleproper>, <unitdate>, <unitid>, and <unittitle>.
Attributes
- ALTRENDER – not required. Use if the content of the element should be displayed or printed differently than the rendering established in a style sheet for other occurrences of the element.
- AUDIENCE – not required. Use to set whether the element’s contents will be visible to external users or to internal ones. Possible values are: “internal” and “external.”
- ID – not required. Creates an ID for element. Can be used for linking.
- ACTUATE – not required. Controls whether the link occurs automatically or requires user request. Values are: “onload” (automatically), “onrequest” (if user requests), “actuateother” (some other action occurs), and “actuatenone” (no action occurs).
- ARCROLE – not required. URI preference that identifies a resource that describes some property of an arc-type or simple-type linking element.
- HREF – not required. The locator for a remote resource in a simple or extended link. An HREF takes the form of a Uniform Resource Identifier (URI). If no URI is specified, the locator is assumed to be within the document that contains the linking element.
- LINKTYPE – fixed. Value must be “simple.”
- ROLE – not required. Information that explains to application software the part that a remote resource plays in a link.
- SHOW – not required. Used in conjunction with ACTUATE to define whether a remote resource that is the target of a link appears at the point of the link, replaces the existing link, or appears in a new window. Possible values are: “embed” (target displays at point of link), “new” (target appears in new window), “replace” (target resource replaces currently-displayed resource), “showother” (take some other action), and “shownone” (no target resource displays).
- TARGET – not required. Points to the ID of another element. Must be an ID reference.
- TITLE – not required. A viewable caption.
- XPOINTER – not required. The locator for a remote resource in a simple or locator link. The XPOINTER attribute takes the form of a Uniform Resource Identifier plus a reference, formulated in XPOINTER syntax, to a sub-resource of the remote resource. XPOINTER enables linking to specific sections of a document that are relative, i.e., based on their position in the document or their content, rather than by reference to a specific identifier such as an ID.
Subelements
None.
Examples
<appraisal> <p> This collection was re-appraised by repository staff in 1992 in order to facilitate use by weeding the collection of materials no longed deemed as having evidential or informational value. A list of materials removed from the collection after the re-appraisal is provided at the end of this guide. <ptr linktype="simple" actuate="onrequest" show="replace" target="mss1982-062_add2"/> </p> </appraisal> |
