<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE spec PUBLIC "-//W3C//DTD Specification V2.1//EN"
  "http://www.w3.org/XML/1998/06/xmlspec-v21.dtd" [
<!--ArborText, Inc., 1988-2000, v.4002-->
<!ENTITY linkbaselistprop "http://www.w3.org/1999/xlink/properties/linkbase">
<!ENTITY iso6.doc.date "20000703">
<!ENTITY showactuateattribs "xlink:show      (new
                  |replace
                  |embed
                  |other
                  |none)          #IMPLIED
  xlink:actuate   (onLoad
                  |onRequest
                  |other
                  |none)          #IMPLIED">
<!ENTITY fromtoatts "xlink:from      NMTOKEN         #IMPLIED
  xlink:to        NMTOKEN         #IMPLIED">
<!ENTITY hrefatt "xlink:href      CDATA           ">
<!ENTITY arcroleatt "xlink:arcrole   CDATA           #IMPLIED">
<!ENTITY labelatt "xlink:label     NMTOKEN         #IMPLIED">
<!ENTITY roleatt "xlink:role      CDATA           #IMPLIED">
<!ENTITY nsatt 'xmlns:xlink     CDATA           #FIXED "&xlinknsuri;"'>
<!ENTITY titleatt "xlink:title     CDATA           #IMPLIED">
<!ENTITY xmproleuri "http://www.example.com/linkprops/">
<!ENTITY graphic-loc "c:/my-documents/epicuser/xlink/">
<!ENTITY xlinknsuri "http://www.w3.org/1999/xlink">
]>
<?Pub UDT _bookmark _target?>
<spec w3c-doctype="cr" status="final">
<!--Last edited: 23 June 2000 by elm-->
<!--
To DO:
- Clean up links
- Make working examples available in files
- Link to errata list when this spec is a REC, and link from a
mention of it in the text to the real thing

-->
<header>
<title>XML Linking Language (XLink)</title>
<version>Version 1.0</version>
<w3c-designation> WD-xlink-&iso6.doc.date;</w3c-designation>
<w3c-doctype>W3C Candidate Recommendation</w3c-doctype>
<pubdate><day>3</day><month>July</month><year>2000</year></pubdate>
<publoc><loc href="http://www.w3.org/TR/2000/CR-xlink-&iso6.doc.date;.xml">http://www.w3.org/TR/2000/CR-xlink-&iso6.doc.date;.xml</loc> <loc
href="http://www.w3.org/TR/2000/CR-xlink-&iso6.doc.date;.html">http://www.w3.org/TR/2000/CR-xlink-&iso6.doc.date;.html</loc>
</publoc>
<latestloc><loc href="http://www.w3.org/TR/xlink/">http://www.w3.org/TR/xlink/</loc></latestloc>
<prevlocs><loc href="http://www.w3.org/TR/2000/WD-xlink-20000221/">http://www.w3.org/TR/2000/WD-xlink-20000221/</loc><!--<loc
href="http://www.w3.org/TR/WD-xlink-20000119">http://www.w3.org/TR/WD-xlink-20000119</loc>
http://www.w3.org/TR/WD-xlink-19991220
http://www.w3.org/1999/07/WD-xlink-19990726
http://www.w3.org/TR/1998/WD-xlink-19980303
http://www.w3.org/TR/WD-xml-link-970731--></prevlocs>
<authlist>
<author><name>Steve DeRose</name><affiliation>Brown University</affiliation>
<email href="mailto:Steven_DeRose@Brown.edu">Steven_DeRose@Brown.edu</email>
</author>
<author><name>Eve Maler</name><affiliation>Sun Microsystems</affiliation>
<email href="mailto:elm@east.sun.com">elm@east.sun.com</email></author>
<author><name>David Orchard</name><email href="mailto:dorchard@ca.ibm.com">orchard@pacificspirit.com</email>
</author>
<author><name>Ben Trafford</name><affiliation>Yomu</affiliation><email href="mailto:bent@exemplary.net">bent@exemplary.net</email>
</author>
</authlist>
<abstract>
<p>This specification defines the XML Linking Language (XLink), which allows
elements to be inserted into XML documents in order to create and describe
links between resources. It uses XML syntax to create structures that can
describe links similar to the simple unidirectional hyperlinks of today's
HTML, as well as more sophisticated links.</p>
</abstract>
<status>
<p>This document is a <loc href="/Consortium/Process/Process-19991111/process.html#RecsCR">Candidate
Recommendation</loc> of the <loc href="http://www.w3.org/">World Wide Web
Consortium</loc>. (For background on this work, please see the <loc href="http://www.w3.org/XML/Activity">XML
Activity Statement</loc>.) This specification is considered stable by the <loc
href="http://www.w3.org/XML/Activity#linking-wg">XML Linking Working Group</loc>
and is available for public review during the Candidate Recommendation stage
ending 3 October 2000.</p>
<p>The Working Group invites implementation feedback during this period. Comments
on this document should be sent to the public mailing list <loc href="mailto:www-xml-linking-comments@w3.org">www-xml-linking-comments@w3.org</loc
> (<loc href="http://lists.w3.org/Archives/Public/www-xml-linking-comments/">archive</loc>).
While we welcome implementation experience reports, the XML Linking Working
Group will not allow early implementation to constrain its ability to make
changes to this specification prior to final release.</p>
<p>For information about the XPointer language expected to be used with XLink,
see <bibref ref="xptr"/>.</p>
<p>See <bibref ref="xldp"/> for additional background on the design principles
informing XLink, and <bibref ref="xlreq"/> for the normative XLink requirements
that this document attempts to satisfy.</p>
<p>A list of current W3C Recommendations and other technical documents can
be found at <loc href="http://www.w3.org/TR">http://www.w3.org/TR</loc>.</p>
</status>
<pubstmt>
<p>Burlington, Seekonk, et al.: World-Wide Web Consortium, XML Working Group
and XML Linking Working Group, 1997-2000.</p>
</pubstmt>
<sourcedesc>
<p>Created in electronic form.</p>
</sourcedesc>
<langusage>
<language id="en">English</language>
</langusage>
<revisiondesc>
<slist>
<sitem>1997-01-15 : Skeleton draft by TB</sitem>
<sitem>1997-01-24 : Fleshed out by sjd</sitem>
<sitem>1997-04-08 : Substantive draft</sitem>
<sitem>1997-06-30 : Public draft</sitem>
<sitem>1997-08-01 : Public draft</sitem>
<sitem>1997-08-05 : Prose/organization work by sjd</sitem>
<sitem>1997-10-14: Conformance and design principles; a bit of cleanup by
elm</sitem>
<sitem>1997-11-07: Update for editorial issues per issues doc, by sjd.</sitem>
<sitem>1997-12-01: Update for editorial issues per issues doc in preparation
for F2F meeting, by sjd.</sitem>
<sitem>1998-01-13: Editorial cleanup, addition of new design principles, by
elm.</sitem>
<sitem>1998-02-27: Splitting out of XLink and XPointer, by elm.</sitem>
<sitem>1998-03-03: Moved most of the XPointer locator stuff here. elm</sitem>
<sitem>1999-04-24: Editorial rewrites to represent new ideas on XLink, especially
the inclusion of arcs. bent</sitem>
<sitem>1999-05-05: Prose/organization work by dorchard. Moved much of the
semantics section around, from: locators, link semantics, remote resource
semantics, local resource semantics; to: resource semantics, locators, behavior
semantics, link semantics, arc semantics. dorchard</sitem>
<sitem>1999-05-12: Prose/organization work. Re-organized some of the sections,
removed XML constructs from the document, added descriptive prose, edited
document text for clarity. Rewrote the link recognition section. bent</sitem>
<sitem>1999-05-17: Further prose work. Added non-normative examples. Clarified
arcs. bent</sitem>
<sitem>1999-05-23: Edited for grammar and clarity. bent</sitem>
<sitem>1999-05-27: Final once-over before sending to group. Fixed sjd's email
address. bent</sitem>
<sitem>1999-06-01: Added appendices placeholders, Acknowledgements, Processing,
list of outstanding editorial work items. Removed ednotes that were descriptions
of work done. dorchard</sitem>
<sitem>1999-06-01: Added ednote descriptions. bent</sitem>
<sitem>1999-06-03: Added many issues. dorchard</sitem>
<sitem>1999-06-11: Added elg section, Locator element, refined arc, started
examples, clarified content of xlink. dorchard</sitem>
<sitem>1999-06-24: updated element tree definition, added inclusion definition,
place holders for issues, Daniel Dardallier WAI 6/15/99 comments, HTML compatibility
issues, multiple roles issue, XSLT stylehseet example, couple of formatting
fixes to be done, removed Joel Nava's comment on link to web definitions,
added reference to URI RFC2396, conformance sentence about User Agents, creation
of explicit arcs from implicit arcs, removed groves from element tree.. dorchard</sitem>
<sitem>1999-06-28: Numerous updates: DanV's feedback from 06-26, arcs examples,
arcs text, introductory sections. dorchard</sitem>
<sitem>1999-06-30: Fixed typos, updated status, moved notations to document
conventions. dorchard</sitem>
<sitem>1999-07-01: Fixed Intro. dorchard.</sitem>
<sitem>1999-07-01: Edited locator discussion in sections 2, "Locator Syntax",
and 4.1., "Locator Attributes". General editing for clarification and appearance.
bent</sitem>
<sitem>1999-07-08: Added information about XLink namespace. Fixed section
4.1 (in terms of URI-references). Added issue about HTML compliance. General
grammar and spelling fix, and fixing XML and HTML source. bent</sitem>
<sitem>1999-07-09: Further cleaned up URI references. dorchard</sitem>
<sitem>1999-07-09: Fixed up examples appendix. dorchard</sitem>
<sitem>1999-07-12: Fixed spelling erros, xsl formatting, grammer, removed
issues from output for WD pub.</sitem>
<sitem>1999-09-17: Fixed descriptions for "replace", "new", and "auto". Returned
"embed" to the draft, and changed "user" to "onRequest". Removed "parsed".
Updated description of "role" with namespace-based design, and modified "locator"
elements accordingly, changing the stated DTD values in the examples. Updated
extended link description. Redefined XLink namespace, and fixed its use in
the specification's examples. Edited arcs, updating them to mention that they
have reverted to going to roles instead of ids. Fixed several XML validation
errors in the spec. bent</sitem>
<sitem>1999-09-17: Cleaned up section 4.4 Semantic Attributes, Behaviour attributes,
fixed namespaces to http://www.w3.org/namespace/xlink/1999/ as said in Sept
9 minutes, removed multiple-equivalent-roles issue, Fixed some examples to
use roles rather than IDs, added note about arcs to non-existant roles, added
issue about arcs to duplicate roles. dorchard</sitem>
<sitem>1999-10-13: Added example for the mapping of HTML IMG tag to the examples
section. Removed resolved issues from the draft. Updated external linksets
to remove non-indirected external linksets. Removed showdefault and actuatedefault
from extended links. bent</sitem>
<sitem>1999-10-15: Removed inline issue, removed any mention of default arc
traversals, added text about explicit arcs required, added simple link #2,
extended link #2 and #3, added inline-locator, cleaned up some syntax errors
in examples, removed issue "locator-container-or-content", removed issue "HTML
AccessKey", added title element in extended links, cleaned up some grammar
errors. dorchard</sitem>
<sitem>1999-10-17: Built an initial take on a normative XLink DTD. General
document cleanup and clarification. Yanked text claiming we'd describe locators
using EBNF syntax. Added note question requirement #3. Changed, throughout
document, the description of arcs as describing 'traversal behaviour' to 'traversal
semantics', which is actually more accurate. Clarified where URI-references
are used within XLink. Removed editor's note about 'forward compatible processing'.
Added references to other influential documents to the 'Relationship to Existing
Standards' section and the 'References' appendix. bent </sitem>
<sitem>1999-10-27: Added an issue about links inside simple links, removed
issue about inline attributes, removed any mention of default arc traversals,
removed issue "locator-container-or-content", removed issue "HTML AccessKey".
bent</sitem>
<sitem>1999-10-28: Cleaned up issues, worked on external linkset adding examples,
shortened processing section. dorchard</sitem>
<sitem>1999-11-11: Added elm to the list of editors. Changed bent's editorial
note on HTML support to an issue. Improved the description of a URI-reference.
Added RDF samples. bent</sitem>
<sitem>1999-11-15: elm's first editing session. Updated date etc. at top.
Removed mention of Inso.</sitem>
<sitem>1999-11-23: Updated arc attribute description. bent</sitem>
<sitem>1999-12-08: Incorporated provisional editors' decisions on XL24 through
XL29, plus the from/to asterisk idea. Also continued general editorial cleanup,
starting mostly with the arc attributes section. elm</sitem>
<sitem>1999-12-13: Incorporated new WG comments and continued general editorial
cleanup, focusing on the element structures and the DTD code. Also incorporated
new inline (self-locator, inline-locator) attribute, which was mostly overlooked
from a decision made in September and pointed out by Jonathan M. Used Daniel
V.'s suggestion for Status of This Document wording. We hope this will serve
as the last-call draft. elm</sitem>
<sitem>1999-12-15: Changed inline attribute to &ldquo;resource&rdquo; element,
fixing my earlier implementation of Jonathan's issue (see just above). This
was a fairly invasive change. elm</sitem>
<sitem>1999-12-17: Added title elements, according to decisions in this week's
telecon. Removed IMG example in appendix on request of the HTML WG. Added
&ldquo;meaningful&rdquo; examples. Added complete explanation of simple links
in terms of extended links. Fixed the simple RDF graphic to reflect recent
concrete syntax decisions (ran out of time to fix the other). elm</sitem>
<sitem>2000-01-04: Made revisions according to December 23 telecon: removed
link-events issue, added role and title to arc (arc-semantics issue), added
constraint about external linksets being XML (require-xls-to-be-xml issue),
added none value for xlink:type (non-an-xlink issue). Also incorporated comments
from WG/IG lists and the comments list (Dec 20 - Jan 3). elm</sitem>
<sitem>2000-01-08: Made revisions according to January 6 telecon: incorporated
more normative behavior attribute text, removed element method of link recognition
and all associated examples, used &ldquo;application&rdquo; consistently to
refer to XLink implementations, removed the examples appendix, and added XBase-related
wording. elm</sitem>
<sitem>2000-02-01: Incorporated decisions from January's decisions, the Jan
4-Jan 31 comments list, and private comments. elm</sitem>
<sitem>2000-02-03: Incorporated decisions from Feb 3 meeting and jmarsh comments
on WG list: changed NS URI to 1999 with no trailing slash, revised linkset
wording further, drew analogy to IMG for embed (non-&ldquo;parsed&rdquo;)
behavior, disallowed prefixes on XLink-special behavior values, reserved all
other non-prefixed values. elm</sitem>
<sitem>2000-02-10: Incorporated decisions from Feb 10 meeting: Removed RDF
appendix for now, softened URI conformance wording, fixed references to linksets
vs. linkbases. Removed dummy issue and dummy ednote and Open Issues appendix.
elm</sitem>
<sitem>2000-04-03: Changed Ben T.'s status to Yomu rep; added Chris M.'s name;
removed hyphen from &ldquo;URI reference&rdquo;; Susan Lesch edits; Bob DuCharme
edits; Dave Hollander edits; used new XMLspec V2.1 markup; sjd edits; referred
only to RFC 2376; changed whole terminology handling and munged inline/OOL/sub-rsrc
terms; fixed role interpretation along RDF lines; incorporated sample wording
for traversal when resource is &ldquo;multiple&rdquo;; Martin Duerst I18N
comments. elm</sitem>
<sitem>2000-04-18: Incorporated arc label attribute, arc role attribute, and
QName-to-URI change. elm</sitem>
<sitem>2000-06-23: Changed &ldquo;display&rdquo; language to &ldquo;presentation&rdquo;
language throughout to make the text slightly less vision-centric. Changed
linkbase handling to arc method. elm</sitem>
</slist>
</revisiondesc>
</header>
<body>
<div1 id="intro">
<head>Introduction</head>
<p>This specification defines the XML Linking Language (XLink), which allows
elements to be inserted into XML documents in order to create and describe <termref
def="dt-link">links</termref> between resources.</p>
<p>XLink provides a framework for creating both basic unidirectional links
and more complex linking structures. It allows XML documents to:</p>
<ulist>
<item><p>Assert linking relationships among more than two resources</p></item>
<item><p>Associate metadata with a link</p></item>
<item><p>Express links that reside in a location separate from the linked
resources</p></item>
</ulist>
<p>An important application of XLink is in hypermedia systems that have <termref
def="dt-hyperlink">hyperlinks</termref>. A simple case of a hyperlink is an
HTML <el>A</el> element, which has these characteristics:</p>
<p>This set of characteristics is powerful, but the model that underlies them
limits the range of possible hyperlink functionality. The model defined in
this specification shares with HTML the use of URI technology, but goes beyond
HTML in offering features, previously available only in dedicated hypermedia
systems, that make hyperlinking more scalable and flexible. Along with providing
linking data structures, XLink provides a minimal link behavior model; higher-level
applications layered on XLink will often specify alternate or more sophisticated
rendering and processing treatments.</p>
<p>Integrated treatment of specialized links used in other technical domains,
such as foreign keys in relational databases and reference values in programming
languages, is outside the scope of this specification.</p>
<div2 id="origin-goals">
<head>Origin and Goals</head>
<p>The design of XLink has been informed by knowledge of established hypermedia
systems and standards. The following standards have been especially influential:</p>
<ulist>
<item><p><emph>HTML</emph> <bibref ref="html"/>: Defines several element types
that represent links.</p></item>
<item><p><emph>HyTime</emph> <bibref ref="iso10744"/>: Defines inline and
inbound and third-party link structures and some semantic features, including
traversal control and presentation of objects.</p></item>
<item><p><emph>Text Encoding Initiative Guidelines</emph> <bibref ref="tei"/>:
Provides structures for creating links, aggregate objects, and link collections.</p>
</item>
</ulist>
<p>Many other linking systems have also informed the design of XLink, especially <bibref
ref="dexter"/>, <bibref ref="fress"/>, <bibref ref="ohs"/>, <bibref ref="microcosm"/>,
and <bibref ref="intermedia"/>.</p>
<p>See the XLink Requirements Document <bibref ref="xlreq"/> for a thorough
explanation of requirements for the design of XLink.</p>
</div2>
</div1>
<div1>
<head>XLink Concepts</head>
<p>This section describes the terms and concepts that are essential to understanding
XLink, without discussing the syntax used to create XLink constructs. A few
additional terms are introduced in later parts of this specification.</p>
<div2>
<head>Links and Resources</head>
<p><termdef id="dt-link" term="Link">An XLink <term>link</term> is an explicit
relationship between resources or portions of resources.</termdef> <termdef
id="dt-linkel" term="Linking element">It is made explicit by an XLink <term>linking
element</term>, which is an XLink-conforming XML element that asserts the
existence of a link.</termdef> There are six XLink elements; only two of them
are considered linking elements. The others provide various pieces of information
that describe the characteristics of a link. (The term <quote>link</quote>
as used in this specification refers only to an XLink link, though nothing
prevents non-XLink constructs from serving as links.)</p>
<p>The notion of resources is universal to the World Wide Web. <termdef id="dt-resource"
term="Resource">As discussed in <bibref ref="rfc2396"/>, a <term>resource</term>
is any addressable unit of information or service.</termdef> Examples include
files, images, documents, programs, and query results. The means used for
addressing a resource is a URI (Uniform Resource Identifier) reference (described
more in <specref ref="link-locators"/>). It is possible to address a portion
of a resource. For example, if the whole resource is an XML document, a useful
portion of that resource might be a particular element inside the document.
Following a link to it might result, for example, in highlighting that element
or scrolling to that point in the document.</p>
<p><termdef id="dt-particip-resource" term="Participating resource">When a
link associates a set of resources, those resources are said to <term>participate</term>
in the link.</termdef> Even though XLink links must appear in XML documents,
they are able to associate all kinds of resources, not just XML-encoded ones.</p>
<p>One of the common uses of XLink is to create hyperlinks. <termdef id="dt-hyperlink"
term="Hyperlink">A <term>hyperlink</term> is a link that is intended primarily
for presentation to a human user.</termdef> Nothing in XLink's design, however,
prevents it from being used with links that are intended solely for consumption
by computers.</p>
</div2>
<div2>
<head>Arcs, Traversal, and Behavior</head>
<p><termdef id="dt-traversal" term="Traversal">Using or following a link for
any purpose is called <term>traversal</term>.</termdef> Even though some kinds
of link can associate arbitrary numbers of resources, traversal always involves
a pair of resources (or portions of them); the source from which traversal
is begun is the <termdef id="dt-starting-resource" term="Starting resource"><term>starting
resource</term></termdef> and <termdef id="dt-ending-resource" term="Ending resource">the
destination is the <term>ending resource</term></termdef>. Note that the term <quote>resource</quote>
used in this fashion may at times apply to a resource portion, not a whole
resource.</p>
<p><termdef id="dt-arc" term="Arc">Information about how to traverse a pair
of resources, including the direction of traversal and possibly application
behavior information as well, is called an <term>arc</term></termdef>. If
two arcs in a link specify the same pair of resources, but they switch places
as starting and ending resources, then the link is multidirectional, which
is not the same as merely <quote>going back</quote> after traversing a link.</p>
</div2>
<div2>
<head>Resources in Relation to the Physical Location of a Linking Element</head>
<p><termdef id="dt-local-resource" term="Local resource">A <term>local resource</term>
is an XML element that participates in a link by virtue of having as its parent,
or being itself, a linking element</termdef>. <termdef id="dt-remote-resource"
term="Remote resource">Any resource or resource portion that participates
in a link by virtue of being addressed with a URI reference is considered
a <term>remote resource</term>, even if it is in the same XML document as
the link, or even inside the same linking element.</termdef> Put another way,
a local resource is specified <quote>by value,</quote> and a remote resource
is specified <quote>by reference.</quote></p>
<p><termdef id="dt-outbound" term="Outbound">An arc that has a local starting
resource and a remote ending resource goes <term>outbound</term>, that is,
away from the linking element.</termdef> (Examples of links with such an arc
are the HTML <el>A</el> element, HyTime <quote>clinks,</quote> and Text Encoding
Initiative <el>XREF</el> elements.) <termdef id="dt-inbound" term="Inbound">If
an arc's ending resource is local but its starting resource is remote, the
the arc goes <term>inbound</term>.</termdef> <termdef id="dt-third-party"
term="Third-party">If neither the starting resource nor the ending resource
is local, then the arc is a <term>third-party</term> arc.</termdef> Though
it is not required, any one link typically specifies only one kind of arc
throughout, and thus might be referred to as an inbound, outbound, or third-party
link.</p>
<p>To create a link that emanates from a resource to which you do not have
(or choose not to exercise) write access, or from a resource that offers no
way to embed linking constructs, it is necessary to use an inbound or third-party
arc. When such arcs are used, the requirements for discovery of the link are
greater than for outbound arcs. <termdef id="dt-linkbase" term="Linkbase">Documents
containing collections of inbound and third-party links are called link databases,
or <term>linkbases</term>.</termdef></p>
</div2>
</div1>
<div1 id="conformance">
<head>XLink Processing and Conformance</head>
<p>This section details processing and conformance requirements on XLink applications
and markup.</p>
<p><termdef id="dt-must" term="Must, May, etc.">The key words <term>must</term>, <term>must
not</term>, <term>required</term>, <term>shall</term>, <term>shall not</term>, <term>should</term>, <term>should
not</term>, <term>recommended</term>, <term>may</term>, and <term>optional</term>
in this specification are to be interpreted as described in <bibref ref="rfc2119"/>.</termdef></p>
<div2>
<head>Processing Dependencies</head>
<p>XLink processing depends on <bibref ref="XML"/>, <bibref ref="xname"/>, <bibref
ref="xbase"/>, and <bibref ref="rfc2396"/>.</p>
</div2>
<div2 id="markup-reqs">
<head>Markup Conformance</head>
<p>An XML element conforms to XLink if:</p>
<olist>
<item><p>it has a <att>type</att> attribute from the XLink namespace whose
value is one of <attval>simple</attval>, <attval>extended</attval>, <attval>locator</attval>, <attval>arc</attval>, <attval>resource</attval>, <attval
>title</attval>, or <attval>none</attval>, and</p></item>
<item><p>it adheres to the conformance constraints imposed by the chosen XLink
element type, as prescribed in this specification.</p></item>
</olist>
<p>This specification imposes no particular constraints on DTDs; conformance
applies only to elements and attributes.</p>
</div2>
<div2 id="app-reqs">
<head>Application Conformance</head>
<note>
<p>Editor's Note (stylesheet is suppressing the real ones!): The text below
about infosets and well-formedness is provisional. The issue was brought up
by Henry Thompson in his Last Call comments.</p>
</note>
<p>An XLink application is any software module that interprets well-formed
XML documents containing XLink elements and attributes, or XML information
sets <bibref ref="infoset"/> containing information items and properties corresponding
to XLink elements and attributes. (This document refers to elements and attributes,
but all specifications herein apply to their information set equivalents as
well.) Such an application is conforming if:</p>
<olist>
<item><p>it observes the mandatory conditions for applications (<quote>must</quote>)
set forth in this specification, and</p></item>
<item><p>for any optional conditions (<quote>should</quote> and <quote>may</quote>)
it chooses to observe, it observes them in the way prescribed, and</p></item>
<item><p>it performs markup conformance testing according to all the conformance
constraints appearing in this specification.</p></item>
</olist>
</div2>
</div1>
<div1 id="att-method">
<head>XLink Markup Design</head>
<p>This section describes the design of XLink's markup vocabulary.</p>
<p>Link markup needs to be recognized reliably by XLink applications in order
to be traversed and handled properly. XLink uses the mechanism described in
the Namespaces in XML Recommendation <bibref ref="xname"/> to accomplish recognition
of the constructs in the XLink vocabulary.</p>
<p>The XLink namespace defined by this specification has the following URI:</p>
<eg>&xlinknsuri;</eg>
<p>As dictated by <bibref ref="xname"/>, the use of XLink elements and attributes
requires declaration of the XLink namespace. For example, the following declaration
would make the prefix <att>xlink</att> available within the <el>myElement</el>
element to represent the XLink namespace:</p>
<eg>&lt;myElement
  xmlns:xlink="&xlinknsuri;">
  ...
&lt;/myElement></eg>
<note>
<p>Most code examples in this specification do not show an XLink namespace
declaration. The <att>xlink</att> prefix is used throughout to stand for the
declaration of the XLink namespace on elements in whose scope the so-marked
attribute appears (on the same element that bears the attribute or on some
ancestor element), whether or not an XLink namespace declaration is present
in the example.</p>
</note>
<p>XLink's namespace provides <term>global attributes</term> for use on elements
that are in any arbitrary namespace. The global attributes are <att>type</att>, <att>href</att>, <att>role</att>, <att>arcrole</att>, <att>title</att
>, <att>show</att>, <att>actuate</att>, <att>label</att>, <att>from</att>,
and <att>to</att>. Document creators use the XLink global attributes to make
the elements in their own namespace, or even in a namespace they do not control,
recognizable as XLink elements. The <att>type</att> attribute indicates the
XLink element type (simple, extended, locator, arc, resource, or title); the
element type dictates the XLink-imposed constraints that such an element <termref
def="dt-must">must</termref> follow and the behavior of XLink applications
on encountering the element.</p>
<p>Following is an example of a <el>crossReference</el> element from a non-XLink
namespace that has XLink global attributes:</p>
<eg>&lt;my:crossReference
  xmlns:my="http://example.com/"
  xmlns:xlink="&xlinknsuri;"
  xlink:type="simple"
  xlink:href="students.xml"
  xlink:role="studentlist"
  xlink:title="Student List"
  xlink:show="new"
  xlink:actuate="onRequest">
Current List of Students
&lt;/my:crossReference></eg>
<p>Using global attributes always requires the use of namespace prefixes on
the individual attributes and the use of the <att>type</att> attribute on
the element.</p>
<div2>
<head>XLink Attribute Usage Patterns</head>
<p>While the XLink attributes are considered global by virtue of their use
of the namespace mechanism, their allowed combinations on any one XLink element
type depend greatly on the value of the special <att>type</att> attribute
(see <specref ref="link-types"/> for more information) for the element on
which they appear. The conformance constraint notes in this specification
detail their allowed usage patterns. Following is a summary of the element
types (columns) on which the global attributes (rows) are allowed, with an
indication of whether a value is required (R) or optional (O):</p>
<table border="1"><thead><tr>
<th></th><th><el>simple</el></th><th><el>extended</el></th><th><el>locator</el></th>
<th><el>arc</el></th><th><el>resource</el></th><th><el>title</el></th>
</tr></thead><tbody><tr>
<td><att>type</att></td><td>R</td><td>R</td><td>R</td><td>R</td><td>R</td>
<td>R</td>
</tr><tr>
<td><att>href</att></td><td>O </td><td></td><td>R</td><td></td><td></td>
</tr><tr>
<td><att>role</att></td><td>O</td><td>O</td><td>O</td><td></td><td>O</td>
<td></td>
</tr><tr>
<td><att>arcrole</att></td><td>O</td><td></td><td></td><td>O</td><td></td>
<td></td>
</tr><tr>
<td><att>title</att></td><td>O</td><td>O</td><td>O</td><td>O</td><td>O</td>
<td></td>
</tr><tr>
<td><att>show</att></td><td>O</td><td></td><td></td><td>O</td><td></td><td></td>
</tr><tr>
<td><att>actuate</att></td><td>O</td><td></td><td></td><td>O</td><td></td>
<td></td>
</tr><tr>
<td><att>label</att></td><td></td><td></td><td>O</td><td></td><td>O</td><td></td>
</tr><tr>
<td><att>from</att></td><td></td><td></td><td></td><td>O</td><td></td><td></td>
</tr><tr>
<td><att>to</att></td><td></td><td></td><td></td><td>O</td><td></td><td></td>
</tr></tbody></table>
<p>This specification uses the convention <quote><var>xxx</var>-type element</quote>
to refer to elements that <termref def="dt-must">must</termref> adhere to
a named set of constraints associated with an XLink element type, no matter
what name the element actually has. For example, <quote><el>locator</el>-type
element</quote> would refer to all of the following elements:</p>
<eg>&lt;locator xlink:type="locator" ... />
&lt;loc xlink:type="locator" ... />
&lt;my:pointer xlink:type="locator" ... /></eg>
</div2>
<div2>
<head>XLink Element Type Relationships</head>
<p>Various XLink element types have special meanings dictated by this specification
when they appear as direct children of other XLink element types. Following
is a summary of the child element types that play a significant role in particular
parent element types. (Other combinations have no XLink-dictated significance.)</p>
<table border="1"><thead><tr>
<th>Parent type</th><th>Significant child types</th>
</tr></thead><tbody><tr>
<td><el>simple</el></td><td>none</td>
</tr><tr>
<td><el>extended</el></td><td><el>locator</el>, <el>arc</el>, <el>resource</el>, <el>title</el></td>
</tr><tr>
<td><el>locator</el></td><td><el>title</el></td>
</tr><tr>
<td><el>arc</el></td><td><el>title</el></td>
</tr><tr>
<td><el>resource</el></td><td>none</td>
</tr><tr>
<td><el>title</el></td><td>none</td>
</tr></tbody></table></div2>
<div2 id="defaulting">
<head>Attribute Value Defaulting</head>
<p>Using XLink potentially involves using a large number of attributes for
supplying important link information. In cases where the values of the desired
XLink attributes are unchanging across individual instances in all the documents
of a certain type, attribute value defaults (fixed or not) <termref def="dt-must">may</termref>
be added to a DTD so that the attributes do not have to appear physically
on element start-tags. For example, if attribute defaults were provided for
the <att>xmlns:xlink</att>, <att>xmlns:my</att>, <att>type</att>, <att>show</att>,
and <att>actuate</att> attributes in the example in the introduction to <specref
ref="att-method"/>, the example would look as follows:</p>
<eg>&lt;my:crossReference
  xlink:href="students.xml"
  xlink:role="studentlist"
  xlink:title="Student List">
Current List of Students
&lt;/my:crossReference></eg>
<p>Information sets that have been created under the control of a DTD have
all attribute values filled in.</p>
</div2>
<div2 id="integrating">
<head>Integrating XLink Usage with Other Markup</head>
<p>This specification defines only attributes and attribute values in the
XLink namespace. There is no restriction on using non-XLink attributes alongside
XLink attributes. In addition, most XLink attributes are optional and the
choice of simple or extended link is up to the markup designer or document
creator, so a DTD that uses XLink features need not use or declare the entire
set of XLink's attributes. Finally, while this specification identifies the
minimum constraints on XLink markup, DTDs that use XLink are free to tighten
these constraints. The use of XLink does not absolve a valid document from
conforming to the constraints expressed in its governing DTD.</p>
<p>Following is an example of a <el>crossReference</el> element with both
XLink and non-XLink attributes:</p>
<eg>&lt;my:crossReference
  xmlns:my="http://example.com/"
  my:lastEdited="2000-06-10"
  xmlns:xlink="&xlinknsuri;"
  xlink:type="simple"
  xlink:href="students.xml">
Current List of Students
&lt;/my:crossReference></eg>
</div2>
<div2 id="legacy">
<head>Using XLink with Legacy Markup</head>
<p>Because XLink's global attributes require the use of namespace prefixes,
non-XLink-based links in legacy documents generally do not serve as conforming
XLink constructs as they stand, even if attribute value defaulting is used.
For example, XHTML 1.0 has an <el>a</el> element with an <att>href</att> attribute,
but because the attribute is a local one attached to the <el>a</el> element
in the XHTML namespace, it is not the same as an <att>xlink:href</att> global
attribute in the XLink namespace.</p>
</div2>
</div1>
<div1 id="linking-elements">
<head>XLink Elements and Attributes</head>
<p>XLink offers two kinds of links:</p>
<glist>
<gitem><label>Extended links</label>
<def>
<p>Extended links offer full XLink functionality, such as inbound and third-party
arcs, as well as links that have arbitrary numbers of participating resources.
As a result, their structure can be fairly complex, including elements for
pointing to remote resources, elements for containing local resources, elements
for specifying arc traversal rules, and elements for specifying human-readable
resource and arc titles.</p>
<p>XLink defines a way to give an extended link special semantics for finding
linkbases; used in this fashion, an extended link helps an XLink application
process other links.</p>
</def></gitem>
<gitem><label>Simple links</label>
<def>
<p>Simple links offer shorthand syntax for a common kind of link, an outbound
link with exactly two participating resources (into which category HTML-style <el>A</el>
and <el>IMG</el> links fall). Because simple links offer less functionality
than extended links, they have no special internal structure.</p>
<p>While simple links are conceptually a subset of extended links, they are
syntactically different. For example, to convert a simple link into an extended
link, several structural changes would be needed.</p>
</def></gitem>
</glist>
<p>The following sections define the XLink elements and attributes.</p>
<div2 id="extended-link">
<head>Extended Links (<el>extended</el>-Type Element)</head>
<p><termdef id="dt-extendedlink" term="Extended link">An <term>extended link</term>
is a link that associates an arbitrary number of resources. The participating
resources <termref def="dt-must">may</termref> be any combination of remote
and local.</termdef></p>
<p>The only kind of link that is able to have inbound and third-party arcs
is an extended link. Typically, extended linking elements are stored separately
from the resources they associate (for example, in entirely different documents).
Thus, extended links are important for situations where the participating
resources are read-only, or where it is expensive to modify and update them
but inexpensive to modify and update a separate linking element, or where
the resources are in formats with no native support for embedded links (such
as many multimedia formats).</p>
<p>The following diagram shows an extended link that associates five remote
resources. This could represent, for example, information about a student's
course load: one resource being a description of the student, another being
a description of the student's academic advisor, two resources representing
courses that the student is attending, and the last resource representing
a course that the student is auditing.</p>
<graphic source="extended-ool.gif" alt="Stylized Diagram of Out-of-Line Extended Link"/>
<p>Without the extended link, the resources might be entirely unrelated; for
example, they might be in five separate documents. The lines emanating from
the extended link represent the association it creates among the resources.
However, notice that the lines do not have directionality. Directionality
is expressed with traversal rules; without such rules being provided, the
resources are associated in no particular order, with no implication as to
whether and how individual resources are accessed.</p>
<p>The following diagram shows an extended link that associates five remote
resources and one local resource (a special element inside the extended link
element). This could represent the same sort of course-load example as described
above, with the addition of the student's grade point average stored locally.
Again, the lines represent mere association of the six resources, without
traversal directions or behaviors implied.</p>
<graphic source="extended-inl.gif" alt="Stylized Diagram of Inline Extended Link"/>
<p>The XLink element type for extended links is any element with an attribute
in the XLink namespace called <att>type</att> with a value of <attval>extended</attval>.</p>
<p>The <el>extended</el>-type element <termref def="dt-must">may</termref>
contain a mixture of the following elements in any order, possibly along with
other content and markup:</p>
<ulist>
<item><p><el>locator</el>-type elements that address the remote resources
participating in the link</p></item>
<item><p><el>arc</el>-type elements that provide traversal rules among the
link's participating resources</p></item>
<item><p><el>title</el>-type elements that provide human-readable labels for
the link</p></item>
<item><p><el>resource</el>-type elements that supply local resources that
participate in the link</p></item>
</ulist>
<p>It is not an error for an <el>extended</el>-type element to associate fewer
than two resources. If the link has only one participating resource, or none
at all, it is simply untraversable. Such a link may still be useful, for example,
to associate properties with a single resource by means of XLink attributes,
or to provide a placeholder for link information that will be populated eventually.</p>
<p>Subelements of the <el>simple</el> or <el>extended</el> type anywhere inside
a parent <el>extended</el>-type element have no XLink-specified relationship
to the parent link. Subelements of the <el>locator</el>, <el>arc</el>, or <el>resource</el>
type that are not direct children of an <el>extended</el>-type element have
no XLink-specified relationship to the parent link.</p>
<p>The <el>extended</el>-type element <termref def="dt-must">may</termref>
have the semantic attributes <att>role</att> and <att>title</att> (see <specref
ref="link-semantics"/>). They supply semantic information about the link as
a whole; the <att>role</att> attribute indicates a property that the entire
link has, and the <att>title</att> attribute indicates a human-readable description
of the entire link. If other XLink attributes are present on the element,
they have no XLink-specified relationship to the link. If both a <att>title</att>
attribute and one or more <el>title</el>-type elements are present, they have
no XLink-specified relationship; a higher-level application built on XLink
will likely want to specify appropriate treatment (for example, precedence)
in this case.</p>
<example>
<head>Sample <el>extended</el>-Type Element Declarations and Instance</head>
<p>Following is a non-normative set of declarations for an <el>extended</el>-type
element and its subelements. Parts of this example are reused throughout this
specification. Note that the <att>type</att> attribute and some other attributes
are defaulted in the DTD in order to highlight the attributes that are changing
on a per-instance basis.</p>
<eg>&lt;!ELEMENT courseload ((tooltip|person|course|gpa|go)*)>
&lt;!ATTLIST courseload
  &nsatt;
  xlink:type      (extended)      #FIXED "extended"
  &roleatt;
  &titleatt;>

&lt;!ELEMENT tooltip ANY>
&lt;!ATTLIST tooltip
  xlink:type      (title)         #FIXED "title"
  xml:lang        CDATA           #IMPLIED>

&lt;!ELEMENT person EMPTY>
&lt;!ATTLIST person
  xlink:type      (locator)       #FIXED "locator"
  &hrefatt;#REQUIRED
  &roleatt;
  &titleatt;
  &labelatt;>

&lt;!ELEMENT course EMPTY>
&lt;!ATTLIST course
  xlink:type      (locator)       #FIXED "locator"
  &hrefatt;#REQUIRED
  xlink:role      CDATA           #FIXED "&xmproleuri;course"
  &titleatt;
  &labelatt;>

&lt;!ELEMENT gpa ANY>
&lt;!ATTLIST gpa
  xlink:type      (resource)      #FIXED "resource"
  xlink:role      CDATA           #FIXED "&xmproleuri;gpa"
  &titleatt;
  &labelatt;>

&lt;!ELEMENT go EMPTY>
&lt;!ATTLIST go
  xlink:type      (arc)           #FIXED "arc"
  &arcroleatt;
  &titleatt;
  &showactuateattribs;
  &fromtoatts;></eg>
<p>Following is how XML elements using these declarations might look.</p>
<eg>&lt;courseload xlink:title="Course Load for Pat Jones">

  &lt;person
    xlink:href="students/patjones62.xml"
    xlink:label="student62"
    xlink:role="&xmproleuri;student"
    xlink:title="Pat Jones" />

  &lt;person
    xlink:href="profs/jaysmith7.xml"
    xlink:label="prof7"
    xlink:role="&xmproleuri;professor"
    xlink:title="Dr. Jay Smith" />
  &lt;!-- more remote resources for professors, TAs, etc. -->

  &lt;course
    xlink:href="courses/cs101.xml"
    xlink:label="CS-101"
    xlink:title="Computer Science 101" />
  &lt;!-- more remote resources for courses, seminars, etc. -->

  &lt;gpa xlink:label="PatJonesGPA">3.5&lt;/gpa>

  &lt;go
    xlink:from="student62"
    xlink:to="PatJonesGPA"
    xlink:show="new"
    xlink:actuate="onRequest"
    xlink:title="Pat Jones's GPA" />
  &lt;go
    xlink:from="CS-101"
    xlink:arcrole="&xmproleuri;auditor"
    xlink:to="student62"
    xlink:show="replace"
    xlink:actuate="onRequest"
    xlink:title="Pat Jones, auditing the course" />
  &lt;go
    xlink:from="student62"
    xlink:arcrole="&xmproleuri;advisor"
    xlink:to="prof7"
    xlink:show="replace"
    xlink:actuate="onRequest"
    xlink:title="Dr. Jay Smith, advisor" />

&lt;/courseload></eg>
</example>
<div3 id="local-resource">
<head>Local Resources for an Extended Link  (<el>resource</el>-Type Element)</head>
<p>An extended link indicates its participating local resources by means of
special subelements that appear inside the extended link. An entire subelement,
together with all of its contents, makes up a local resource.</p>
<p>The XLink element for local resources is any element with an attribute
in the XLink namespace called <att>type</att> with a value of <attval>resource</attval>.</p>
<p>The <el>resource</el>-type element <termref def="dt-must">may</termref>
have any content; whatever content is present has no XLink-specified relationship
to the link. It is possible for a <el>resource</el>-type element to have no
content; in cases where it serves as a starting resource expected to be traversed
on request, interactive XLink applications will typically generate some content
in order to give the user a way to initiate the traversal.</p>
<p>The <el>resource</el>-type element <termref def="dt-must">may</termref>
have the semantic attributes <att>role</att> and <att>title</att> (see <specref
ref="link-semantics"/>) and the traversal attribute <att>label</att> (see <specref
ref="traversal-atts"/>). The semantic attributes supply information about
the resource in generic terms, outside of the context of a particular arc
that leads to it; the <att>role</att> attribute indicates a property of the
resource, and the <att>title</att> attribute indicates a human-readable description
of the resource. The <att>label</att> attribute provides a way for an <el>arc</el>-type
element to refer to it in creating a traversal arc.</p>
<example>
<head>Sample <el>resource</el>-Type Element Declarations and Instance</head>
<p>Following is a non-normative set of declarations for a <el>resource</el>-type
element.</p>
<eg>&lt;!ELEMENT gpa ANY>
&lt;!ATTLIST gpa
  xlink:type      (resource)      #FIXED "resource"
  xlink:role      CDATA           #FIXED "&xmproleuri;gpa"
  &titleatt;
  &labelatt;></eg>
<p>Following is how an XML element using these declarations might look.</p>
<eg>  &lt;gpa xlink:label="PatJonesGPA">3.5&lt;/gpa>
</eg>
</example></div3>
<div3 id="remote-resource">
<head>Remote Resources for an Extended Link (<el>locator</el>-Type Element)</head>
<p>An extended link indicates remote resources that participate in it by means
of locator elements.</p>
<p>The XLink element for locators is any element with an attribute in the
XLink namespace called <att>type</att> with a value of <attval>locator</attval>.</p>
<p>The <el>locator</el>-type element <termref def="dt-must">may</termref>
have any content. Other than <el>title</el>-type elements that are direct
children (see <specref ref="title-element"/>), whatever content is present
has no XLink-specified relationship to the link. If a <el>locator</el>-type
element contains nested XLink elements, such contained elements have no XLink-specified
relationship to the parent link. If a <el>locator</el>-type element has anything
other than an <el>extended</el>-type element for a parent, the <el>locator</el>-type
element has no XLink-specified meaning.</p>
<constraintnote id="cn-locator-atts" type="conformance">
<head>Attributes on Locator Element</head>
<p>The <el>locator</el>-type element <termref def="dt-must">must</termref>
have the locator attribute (see <specref ref="link-locators"/>). The locator
attribute (<att>href</att>) <termref def="dt-must">must</termref> have a value
supplied.</p>
</constraintnote>
<p>The <el>locator</el>-type element <termref def="dt-must">may</termref>
have the semantic attributes <att>role</att> and <att>title</att> (see <specref
ref="link-semantics"/>) and the traversal attribute <att>label</att> (see <specref
ref="traversal-atts"/>). The locator attribute provides a URI reference that
identifies a remote resource. The semantic attributes supply information about
the resource in generic terms, outside of the context of a particular arc
that leads to it; the <att>role</att> attribute indicates a property that
the resource has, and the <att>title</att> attribute indicates a human-readable
description of the resource. The <att>label</att> attribute provides a way
for an <el>arc</el>-type element to refer to it in creating a traversal arc.</p>
<note>
<p>A <el>locator</el>-type element, by itself, does not constitute a link
just because it has a locator (<att>href</att>) attribute; unlike a <el>simple</el>-type
element, it does not create an XLink-governed association between itself and
the referenced resource.</p>
</note>
<example>
<head>Sample <el>locator</el>-Type Element Declarations and Instance</head>
<p>Following is a non-normative set of declarations for a <el>locator</el>-type
element.</p>
<eg>&lt;!ELEMENT person EMPTY>
&lt;!ATTLIST person
  xlink:type      (locator)       #FIXED "locator"
  &hrefatt;#REQUIRED
  &roleatt;
  &titleatt;
  &labelatt;>

&lt;!ELEMENT course EMPTY>
&lt;!ATTLIST course
  xlink:type      (locator)       #FIXED "locator"
  &hrefatt;#REQUIRED
  xlink:role      CDATA           #FIXED "&xmproleuri;course"
  &titleatt;
  &labelatt;></eg>
<p>Following is how XML elements using these declarations might look.</p>
<eg>&lt;person
  xlink:href="students/patjones62.xml"
  xlink:label="student62"
  xlink:role="&xmproleuri;student"
xlink:title="Pat Jones" />

&lt;person
  xlink:href="profs/jaysmith7.xml"
  xlink:label="prof7"
  xlink:role="&xmproleuri;professor"
  xlink:title="Dr. Jay Smith" />

&lt;course
  xlink:href="courses/cs101.xml"
  xlink:label="CS-101"
  xlink:title="Computer Science 101" /></eg>
</example></div3>
<div3 id="xlink-arcs">
<head>Traversal Rules for an Extended Link  (<el>arc</el>-Type Element)</head>
<p>An extended link <termref def="dt-must">may</termref> indicate rules for
traversing among its participating resources by means of a series of optional
arc elements.</p>
<p>The XLink element for arcs is any element with an attribute in the XLink
namespace called <att>type</att> with a value of <attval>arc</attval>.</p>
<p>The <el>arc</el>-type element <termref def="dt-must">may</termref> have
any content. Other than <el>title</el>-type elements that are direct children
(see <specref ref="title-element"/>), whatever content is present has no XLink-specified
relationship to the link. If an <el>arc</el>-type element has anything other
than an <el>extended</el>-type element for its parent, the <el>arc</el>-type
element has no XLink-specified meaning.</p>
<p>The <el>arc</el>-type element <termref def="dt-must">may</termref> have
the traversal attributes <att>from</att> and <att>to</att> (see <specref ref="traversal-atts"/>),
the behavior attributes <att>show</att> and <att>actuate</att> (see <specref
ref="link-behaviors"/>) and the semantic attributes <att>arcrole</att> and <att>title</att>
(see <specref ref="link-semantics"/>).</p>
<p>The traversal attributes define the desired traversal between pairs of
resources that participate in the same link, where the resources are identified
by their <att>label</att> attribute values. The <att>from</att> attribute
defines resources from which traversal <termref def="dt-must">may</termref>
be initiated, that is, <termref def="dt-starting-resource">starting resources</termref>,
while the <att>to</att> attribute defines resources that <termref def="dt-must">may</termref>
be traversed to, that is, <termref def="dt-ending-resource">ending resources</termref>.
The behavior attributes specify the desired behavior for XLink applications
to use when traversing to the ending resource.</p>
<p>The semantic attributes describe the meaning of the arc's ending resource
relative to its starting resource. The <att>arcrole</att> attribute corresponds
to the <bibref ref="rdf"/> notion of a property, where the role can be interpreted
as stating that <quote><var>starting-resource</var> HAS <var>arc-role</var> <var>ending-resource</var>.</quote>
This contextual role can differ from the meaning of an ending resource when
taken outside the context of this particular arc. For example, a resource
might generically represent a <quote>person,</quote> but in the context of
a particular arc it might have the role of <quote>mother</quote> and in the
context of a different arc it might have the role of <quote>daughter.</quote></p>
<p>When the same resource serves as a starting resource in several arcs (whether
in a single link or across many links), traversal-request behavior is unconstrained
by this specification, but one possibility for interactive applications is
a pop-up menu that lists the relevant arc or link titles.</p>
<p>The following diagram shows an extended link that associates five remote
resources and provides rules for traversal among them. All of the arcs specified
are third-party arcs; that is, the arcs go exclusively between remote resources.
The nondirectional solid lines indicate, as before, that the link is associating
the five resources; the new dotted arrows indicate the traversal rules that
the link provides. Notice that some resources share the same <att>label</att>
value.</p>
<graphic source="extended-arcs.gif" alt="Stylized Diagram of Out-of-Link Extended Link with Arcs"/>
<p>This diagram reflects directional traversal arcs created by the following
settings, where both As and Cs are allowed to initiate traversal to all Bs.
Because some labels appear on several resources, each arc specification potentially
creates several traversal arcs at once:</p>
<eg>&lt;go xlink:type="arc" xlink:from="A" xlink:to="B" />
&lt;go xlink:type="arc" xlink:from="C" xlink:to="B" /></eg>
<p>As another example, assume an extended link that contains five locators,
two with <att>label</att> values of <attval>parent</attval> and three with <att>label</att>
values of <attval>child</attval>:</p>
<eg>&lt;extendedlink xlink:type="extended">
  &lt;loc xlink:type="locator" xlink:href="..." xlink:label="parent" xlink:title="p1" />
  &lt;loc xlink:type="locator" xlink:href="..." xlink:label="parent" xlink:title="p2" />
  &lt;loc xlink:type="locator" xlink:href="..." xlink:label="child"  xlink:title="c1" />
  &lt;loc xlink:type="locator" xlink:href="..." xlink:label="child"  xlink:title="c2" />
  &lt;loc xlink:type="locator" xlink:href="..." xlink:label="child"  xlink:title="c3" />
... &lt;!-- arc-type elements would go here -->
&lt;/extendedlink></eg>
<p>The following specifies traversal from parent resources to child resources,
which includes all of p1-c1, p1-c2, p1-c3, p2-c1, p2-c2, and p2-c3:</p>
<eg>&lt;go xlink:type="arc" xlink:from="parent" xlink:to="child" /></eg>
<p>If no value is supplied for a <att>from</att> or <att>to</att> attribute,
the missing value is interpreted as standing for <emph>all</emph> the labels
supplied on <el>locator</el>-type elements in that <el>extended</el>-type
element. For example, the following specifies traversal from parents to children
and also from children to children, which includes all of p1-c1, p1-c2, p1-c3,
p2-c1, p2-c2, p2-c3, c1-c1, c1-c2, c1-c3, c2-c1, c2-c2, c2-c3, c3-c1, c3-c2,
and c3-c3:</p>
<eg>&lt;go xlink:type="arc" xlink:to="child" /></eg>
<p>In this case, note that the traversal rules include arcs from some resources
to other resources with the same label (from children to other children),
as well as from some resources to themselves (from a child to itself); this
is not an error.</p>
<p>If no <el>arc</el>-type elements are provided in an extended link, then
by extension the missing <att>from</att> and <att>to</att> values are interpreted
as standing for all the labels in that link. This would be equivalent to the
following traversal specification:</p>
<eg>&lt;go xlink:type="arc" /></eg>
<p>When more than one locator has the same label, the set of locators with
the same label are to be understood as individual locators, rather than as
referring to an aggregate resource; the traversal behavior of such a link
might be the same as for a link where all the locators have different roles
and the appropriate arcs are specified to produce the identical traversal
pairs.</p>
<p>If the arc traversal rules for an extended link leave out any possible
traversal pairs, XLink defines no traversal for these pairs. A higher-level
application <termref def="dt-must">may </termref>perform non-XLink-directed
traversals; for example, a link-checking process might traverse all available
pairs of resources.</p>
<constraintnote id="cn-arc-duplicates" type="conformance">
<head>No Arc Duplication</head>
<p>Each <el>arc</el>-type element <termref def="dt-must">must</termref> have
a pair of <att>from</att> and <att>to</att> values that does not repeat the <att>from</att>
and <att>to</att> values (respectively) for any other <el>arc</el>-type element
in the same extended link; that is, each pair in a link <termref def="dt-must">must</termref>
be unique.</p>
</constraintnote>
<example>
<head>Sample <el>arc</el>-Type Element Declarations and Instance</head>
<p>Following is a non-normative set of declarations for an <el>arc</el>-type
element.</p>
<eg>&lt;!ELEMENT go EMPTY>
&lt;!ATTLIST go
  xlink:type      (arc)           #FIXED "arc"
  &arcroleatt;
  &titleatt;
  &showactuateattribs;
  &fromtoatts;></eg>
<p>Following is how XML elements using these declarations might look.</p>
<eg>&lt;go
  xlink:from="student62"
  xlink:to="PatJonesGPA"
  xlink:show="new"
  xlink:actuate="onRequest"
  xlink:title="Pat Jones's GPA" />
&lt;go
  xlink:from="CS-101"
  xlink:arcrole="&xmproleuri;auditor"
  xlink:to="student62"
  xlink:show="replace"
  xlink:actuate="onRequest"
  xlink:title="Pat Jones, auditing the course" />
&lt;go
  xlink:from="student62"
  xlink:arcrole="&xmproleuri;advisor"
  xlink:to="prof7"
  xlink:show="replace"
  xlink:actuate="onRequest"
  xlink:title="Dr. Jay Smith, advisor" /></eg>
</example></div3>
<div3 id="title-element">
<head>Titles for Extended Links, Locators, and Arcs (<el>title</el>-Type Element)</head>
<p>The <el>extended</el>-, <el>locator</el>-, and <el>arc</el>-type elements <termref
def="dt-must">may</termref> have the <att>title</att> attribute (more about
which see <specref ref="link-semantics"/>). However, they <termref def="dt-must">may</termref>
also have a series of one or more <el>title</el>-type elements. Such elements
are useful, for example, for cases where human-readable label information
needs further element markup, or where multiple titles are necessary. One
common motivation for using the <el>title</el>-type element is to account
for internationalization and localization. For example, title markup might
be necessary for bidirectional contexts or in East Asian languages, and multiple
titles might be necessary for different natural-language versions of a title.</p>
<p>The XLink element for titles is any element with an attribute in the XLink
namespace called <att>type</att> with a value of <attval>title</attval>.</p>
<p>The <el>title</el>-type element <termref def="dt-must">may</termref> have
any content. If a <el>title</el>-type element contains nested XLink elements,
such contained elements have no XLink-specified relationship to the parent
link containing the title. If a <el>title</el>-type element has anything other
than an <el>extended</el>-, <el>locator</el>-, or <el>arc</el>-type element
for a parent, the <el>title</el>-type element has no XLink-specified meaning.</p>
<example>
<head>Sample <el>title</el>-Type Element Declarations and Instance</head>
<p>Following is a non-normative set of declarations for a <el>title</el>-type
element. The element has been given the <att>xml:lang</att> attribute, which <termref
def="dt-must">may</termref> be used in conjunction with server settings or
other contextual information in determining which title to present.</p>
<eg>&lt;!ELEMENT advisorname (name)>
&lt;!ATTLIST advisorname
  xlink:type      (title)         #FIXED "title"
  xml:lang        CDATA           #IMPLIED>

&lt;!ELEMENT name (honorific?, given, family)>
&lt;!-- Further subelement declarations for names --></eg>
<p>Following is how XML elements using these declarations might look.</p>
<eg>&lt;advisor xlink:href="profs/jaysmith7.xml" ...>
  &lt;advisorname xml:lang="en">
    &lt;name>
      &lt;honorific>Dr.&lt;/honorific>
      &lt;given>Jay&lt;/given>
      &lt;family>Smith&lt;/family>
    &lt;/name>
  &lt;/advisorname>
&lt;/advisor></eg>
</example></div3>
<div3 id="xlg">
<head>Locating Linkbases (Special Arc Role)</head>
<p>For an XLink application to traverse from a starting resource to an ending
resource, it needs to locate both the starting resource and the link. Locating
the two pieces is not a problem in the case of outbound arcs because the starting
resource is either the linking element itself or a child of the linking element.
However, in the case of inbound and third-party arcs, the XLink application
needs to be able to find both pieces somehow.</p>
<p>In the course load example, extended links can associate pairs of remote
resources representing students and courses. In order for the system to load
and present a <quote>student resource</quote> (such as a description and picture
of the person) in a way that offers traversal to related information (for
example, by allowing users to click on the student's name to traverse to information
about the courses in which she is enrolled), it needs to locate and use the
extended links that contain the association.</p>
<p><termref def="dt-linkbase">Linkbases</termref> are often used to make link
management easier by gathering together a number of related linking elements.
XLink provides a way to instruct XLink applications to access potentially
relevant linkbases. The instruction takes the form of an arc specification
(whether an explicit one in an extended link, or an implicit one in a simple
link) that has the following value for its arcrole attribute:</p>
<eg>&linkbaselistprop;</eg>
<constraintnote id="require-xls-xml" type="conformance">
<head>Linkbases Must Be XML</head>
<p>Any linkbase specified as the ending resource of an arc with this special
value <termref def="dt-must">must</termref> be an XML document.</p>
</constraintnote>
<p>(XLink applications <termref def="dt-must">may</termref> also use any other
means to locate and process additional linkbases.)</p>
<p>The handling of a linkbase arc is much like the handling of a normal arc,
except that traversal entails loading the ending resource (the linkbase) to
extract its links for later use, rather than to present it to a user or to
perform some other processing. Its handling is also special in that XLink
applications <termref def="dt-must">must</termref> suspend traversal of linkbase
arcs at user option.</p>
<p>Specifically, on loading a linkbase arc, an XLink application <termref
def="dt-must">should</termref> keep track of what the starting resource is.
Whenever a document containing that starting resource is loaded and traversal
of the linkbase arc is actuated, the application <termref def="dt-must">should</termref>
access the linkbase and extract any extended links found inside it. In the
case that the extracted resource is a portion of a complete XML document,
such as a range or a string range, only those extended links completely contained
in the extracted portion <termref def="dt-must">should</termref> be made available.</p>
<p>The timing of linkbase arc traversal depends on the value of the <att>actuate</att>
attribute on the arc. For example, if the value is <attval>onLoad</attval>,
the linkbase is loaded and its links extracted as soon as the starting resource
is loaded. Any <att>show</att> attribute value on a linkbase arc <termref
def="dt-must">must</termref> be ignored, because traversal does not entail
presentation in this case.</p>
<p>Linkbases <termref def="dt-must">may</termref> be chained by virtue of
serving as the starting resource of yet another linkbase arc. The application
interpreting an initial linkbase arc <termref def="dt-must">may</termref>
choose to limit the number of steps processed in the chain.</p>
<p>An application <termref def="dt-must">should</termref> maintain a list
of extended links retrieved as a result of processing a linkbase, and <termref
def="dt-must">should not</termref> retrieve duplicate resources or links in
the case where a cyclic dependency exists. To ease XLink processing, document
creators <termref def="dt-must">may</termref> wish to define linkbase arcs
near the beginning of a document.</p>
<example>
<head>Annotating a Specification</head>
<p>Following is a non-normative set of declarations for an extended link that
specializes in providing linkbase arcs:</p>
<eg>&lt;!ELEMENT basesloaded ((startrsrc|linkbase|load)*)>
&lt;!ATTLIST basesloaded
  xlink:type      (extended)      #FIXED "extended">

&lt;!ELEMENT startrsrc EMPTY>
&lt;!ATTLIST startrsrc
  xlink:type      (locator)       #FIXED "locator"
  &hrefatt;#REQUIRED>
  &labelatt;>

&lt;!ELEMENT linkbase EMPTY>
&lt;!ATTLIST linkbase
  xlink:type      (locator)       #FIXED "locator"
  &hrefatt;#REQUIRED
  &labelatt;>

&lt;!ELEMENT load EMPTY>
&lt;!ATTLIST go
  xlink:type      (arc)           #FIXED "arc"
  xlink:arcrole   CDATA           #FIXED "&linkbaselistprop;"
  xlink:actuate   (onLoad
                  |onRequest
                  |other
                  |none)          #IMPLIED
  &fromtoatts;></eg>
<p>Following is how an XML element using these declarations might look. This
would indicate that when a specification document is loaded, a linkbase full
of annotations to it <termref def="dt-must">should</termref> automatically
be loaded as well, possibly necessitating re-rendering of the entire specification
document to reveal any regions within it that serve as starting resource in
the links found in the linkbase.</p>
<eg>&lt;basesloaded>
  &lt;startrsrc xlink:label="spec" xlink:href="spec.xml" />
  &lt;linkbase xlink:label="linkbase" xlink:href="linkbase.xml" />
  &lt;load xlink:from="spec" xlink:to="linkbase" actuate="onLoad" />
&lt;/basesloaded></eg>
<p>Following is how an XML element using these declarations might look if
the linkbase loading were on request. This time, the starting resource consists
of the words <quote>Click here to reveal annotations.</quote> If the starting
resource were the entire document as in the example above, a reasonable behavior
for allowing a user to actuate traversal would be a confirmation dialog box.</p>
<eg>&lt;basesloaded>
  &lt;startrsrc
    xlink:label="spec"
    xlink:href="spec.xml#string-range(//*,'Click here to reveal annotations.')" />
  &lt;linkbase xlink:label="linkbase" xlink:href="linkbase.xml" />
  &lt;load xlink:from="spec" xlink:to="linkbase" actuate="onRequest" />
&lt;/basesloaded></eg>
</example></div3>
</div2>
<div2 id="simple-links">
<head>Simple Links (<el>simple</el>-Type Element)</head>
<p><termdef id="dt-simplelink" term="Simple link">A <term>simple link</term>
is a link that associates exactly two <termref def="dt-resource">resources</termref>,
one <termref def="dt-local-resource">local</termref> and one <termref def="dt-remote-resource">remote</termref>,
with an arc going from the former to the latter. Thus, a simple link is always
an outbound link.</termdef></p>
<p>The purpose of a simple link is to be a convenient shorthand for the equivalent
extended link. A single simple linking element combines the basic functions
of an <el>extended</el>-type element, a <el>locator</el>-type element, an <el>arc</el>-type
element, and a <el>resource</el>-type element.</p>
<p>The following diagram shows the characteristics of a simple link; it associates
one local and one remote resource, and implicitly provides a single traversal
arc from the local resource to the remote one. This could represent, for example,
the name of a student appearing in text which, when clicked, leads to information
about the student.</p>
<graphic source="simple.gif" alt="Stylized Diagram of Simple Link"/><example>
<head>Simple Link Functionality Done with an Extended Link</head>
<p>A simple link could be represented by an extended link in approximately
the following way, where the labels are just for illustration of the single
allowed arc and cannot be set individually:</p>
<eg>&lt;studentlink xlink:type="extended">
  &lt;resource
    xlink:type="resource"
    xlink:label="local">Pat Jones&lt;/resource>
  &lt;locator
    xlink:type="locator"
    xlink:href="..."
    xlink:label="remote"
    xlink:role="..." />
    xlink:title="..."
  &lt;go
    xlink:type="arc"
    xlink:from="local"
    xlink:to="remote"
    xlink:arcrole="..."
    xlink:show="..."
    xlink:actuate="..." />
&lt;/studentlink></eg>
</example>
<p>A simple link combines all the features above (except for the label values)
into a single element. In cases where only this subset of features is required,
the XLink simple linking element is available as an alternative to the extended
linking element. The features missing from simple links are as follows:</p>
<ulist>
<item><p>Supplying arbitrary numbers of local and remote resources</p></item>
<item><p>Specifying an arc from its remote resource to its local resource</p>
</item>
<item><p>Associating a title with the single hardwired arc</p></item>
<item><p>Associating a role or title with the local resource</p></item>
<item><p>Associating a role or title with the link as a whole</p></item>
</ulist>
<p>The XLink element for simple links is any element with an attribute in
the XLink namespace called <att>type</att> with a value of <attval>simple</attval>.
The simple equivalent of the above extended link would be as follows:</p>
<eg>&lt;studentlink xlink:href="...">Pat Jones&lt;/studentlink></eg>
<p>The <el>simple</el>-type element <termref def="dt-must">may</termref> have
any content. The <el>simple</el>-type element itself, together with all of
its content, is the local resource of the link, as if the element were a <el>resource</el>-type
element. If a <el>simple</el>-type element contains nested XLink elements,
such contained elements have no XLink-specified relationship to the parent
link. It is possible for a <el>simple</el>-type element to have no content;
in cases where the link is expected to be traversed on request, interactive
XLink applications will typically generate some content in order to give the
user a way to initiate the traversal.</p>
<p>The <el>simple</el>-type element effectively takes the locator attribute <att>href</att>
and the semantic attributes <att>role</att> and <att>title</att> from the <el>locator</el>-type
element, and the behavior attributes <att>show</att> and <att>actuate</att>
and the single semantic attribute <att>arcrole</att> from the <el>arc</el>-type
element.</p>
<p>It is not an error for a <el>simple</el>-type element to have no locator
(<att>href</att>) attribute value. If a value is not provided, the link is
simply untraversable. Such a link may still be useful, for example, to associate
properties with the resource by means of XLink attributes.</p>
<example>
<head>Sample <el>simple</el>-Type Element Declarations and Instance</head>
<p>Following is a non-normative set of declarations for a <el>simple</el>-type
element.</p>
<eg>&lt;!ELEMENT studentlink ANY>
&lt;!ATTLIST studentlink
  xlink:type      (simple)        #FIXED "simple"
  &hrefatt;#IMPLIED
  xlink:role      NMTOKEN         #FIXED "&xmproleuri;student"
  &arcroleatt;
  &titleatt;
  &showactuateattribs;></eg>
<p>Following is how an XML document might use these declarations.</p>
<eg>..., and &lt;studentlink xlink:href="students/patjones62.xml">Pat
Jones&lt;/studentlink> is popular around the student union.</eg>
</example></div2>
<div2 id="link-types">
<head>XLink Element Type Attribute (<att>type</att>)</head>
<p>The attribute that identifies XLink element types is <att>type</att>.</p>
<constraintnote id="cn-type-value" type="Conformance">
<head>type Value</head>
<p>The value of the <att>type</att> attribute <termref def="dt-must">must</termref>
be supplied. The value <termref def="dt-must">must</termref> be one of <attval>simple</attval>, <attval>extended</attval>, <attval>locator</attval
>, <attval>arc</attval>, <attval>resource</attval>, <attval>title</attval>,
or <attval>none</attval>.</p>
</constraintnote>
<p>When the value of the <att>type</att> attribute is <attval>none</attval>,
the element has no XLink-specified meaning, and any XLink-related content
or attributes have no XLink-specified relationship to the element.</p>
<example>
<head>Sample <att>type</att> Attribute Declarations</head>
<p>Following is a non-normative attribute-list declaration for <att>type</att>
on an element intended to be <el>simple</el>-type.</p>
<eg>&lt;!ATTLIST xlink:simple
  xlink:type      (simple)        #FIXED "simple"
  ...></eg>
<p>For an element that serves as an XLink element only on some occasions,
one declaration might be as follows, where the document creator sets the value
to <attval>simple</attval> in some circumstances and <attval>none</attval>
in others. The use of <attval>none</attval> might be useful in helping XLink
applications to avoid checking for the presence of an <att>href</att> value.</p>
<eg>&lt;!ATTLIST commandname
  xlink:type      (simple|none)   #REQUIRED
  &hrefatt;#IMPLIED></eg>
</example></div2>
<div2 id="link-locators">
<head>Locator Attribute (<att>href</att>)</head>
<p>The attribute that supplies the data that allows an XLink application to
find a remote resource (or resource fragment) is <att>href</att>. It <termref
def="dt-must">may</termref> be used on <el>simple</el>-type elements, and <termref
def="dt-must">must</termref> be used on <el>locator</el>-type elements.</p>
<p>The value of the <att>href</att> attribute <termref def="dt-must">must</termref>
be a URI reference as defined in <bibref ref="rfc2396"/>. (However, because
it is impractical for any application to check that a value is a URI reference,
this specification follows the lead of <bibref ref="rfc2396"/> in this matter
and imposes no such conformance testing requirement on XLink applications.)
If the URI portion of the URI reference is relative, its absolute version <termref
def="dt-must">must</termref> be computed by the method of <bibref ref="xbase"/>
before use. As dictated by the rules of <bibref ref="rfc2396"/>, if the <att>href</att>
attribute has a value but that value is empty (<code>""</code>) or has an
empty URI portion, it is to be interpreted as identifying the resource in
which the <att>href</att> attribute itself appears.</p>
<p>Because <att>href</att> attributes contain URI references, some characters
in an <att>href</att> value that would normally be allowed by the rules of
XML are syntactically disallowed by the generic URI syntax. The disallowed
characters include all non-ASCII characters, plus the excluded characters
listed in Section 2.4 of <bibref ref="rfc2396"/> except for the crosshatch
(#) and percent sign (%) characters. Values containing disallowed characters <termref
def="dt-must">must</termref> be encoded specially, as follows:</p>
<olist>
<item><p>Each disallowed character is converted to UTF-8 as one or more bytes.</p>
</item>
<item><p>Each of these bytes is escaped with the URI escaping mechanism (that
is, converted to <code>%</code><var>HH</var>, where HH is the hexadecimal
notation of the byte value).</p></item>
<item><p>The original character is replaced by the resulting character sequence.</p>
</item>
</olist>
<p>For locators into XML resources, the format of the fragment identifier
(if any) used within the URI reference is specified by the XPointer specification <bibref
ref="xptr"/>.</p>
<example>
<head>Sample <att>href</att> Attribute Declarations</head>
<p>Following is a non-normative attribute-list declaration for <att>href</att>
on an element intended to be <el>simple</el>-type.</p>
<eg>&lt;!ATTLIST simplelink
  &hrefatt;#REQUIRED
  ...></eg>
</example></div2>
<div2 id="link-semantics">
<head>Semantic Attributes (<att>role</att>, <att>arcrole</att>, and <att>title</att>)</head>
<p>The attributes that describe the meaning of resources within the context
of a link are <att>role</att>, <att>arcrole</att>, and <att>title</att>. The <att>role</att>
and <att>title</att> attributes <termref def="dt-must">may</termref> be used
on <el>extended</el>-, <el>simple</el>-, <el>locator-</el>, and <el>resource</el>-type
elements. The <att>arcrole</att> and <att>title</att> attributes <termref
def="dt-must">may</termref> be used on <el>arc</el>-type elements.</p>
<p>The value of the <att>role</att> or <att>arcrole</att> attribute <termref
def="dt-must">must</termref> be a URI reference as defined in <bibref ref="rfc2396"/>.
The URI reference identifies some resource that describes the intended property.
When no value is supplied, no particular role value is to be inferred. Disallowed
URI reference characters in these attribute values <termref def="dt-must">must</termref>
be specially encoded as described in <specref ref="link-locators"/>.</p>
<p>The <att>title</att> attribute is used to describe the meaning of a link
or resource in a human-readable fashion, along the same lines as the <att>role</att>
or <att>arcrole</att> attribute. (However, see also <specref ref="title-element"/>.)
A value is optional; if a value is supplied, it <termref def="dt-must">should</termref>
contain a string that describes the resource. The use of this information
is highly dependent on the type of processing being done. It <termref def="dt-must">may</termref>
be used, for example, to make titles available to applications used by visually
impaired users, or to create a table of links, or to present help text that
appears when a user lets a mouse pointer hover over a starting resource.</p>
<example>
<head>Sample <att>role</att> and <att>title</att> Attribute Declarations</head>
<p>Following is a non-normative attribute-list declaration for <att>role</att>
and <att>title</att> on an element intended to be <el>simple</el>-type.</p>
<eg>&lt;!ATTLIST simplelink
  ...
  &roleatt;
  &titleatt;
  ...></eg>
<p>Following is a non-normative attribute-list declaration for <att>arcrole</att>
and <att>title</att> on an element intended to be <el>arc</el>-type.</p>
<eg>&lt;!ATTLIST go
  ...
  &arcroleatt;
  &titleatt;
  ...></eg>
</example></div2>
<div2 id="link-behaviors">
<head>Behavior Attributes (<att>show</att> and <att>actuate</att>) </head>
<p>The behavior attributes are <att>show</att> and <att>actuate</att>. They <termref
def="dt-must">may</termref> be used on the <el>simple</el>- and <el>arc</el>-type
elements. When used on a <el>simple</el>-type element, they signal behavior
intentions for traversal to that link's single remote ending resource. When
they are used on an <el>arc</el>-type element, they signal behavior intentions
for traversal to whatever ending resources (local or remote) are specified
by that arc.</p>
<p>The <att>show</att> and <att>actuate</att> attributes are not required.
When they are used, conforming XLink applications <termref def="dt-must">should</termref>
give them the treatment specified in this section. There is no hard requirement
(<quote>must</quote>) for this treatment because what makes sense for an interactive
application, such as a browser, is unlikely to make sense for a noninteractive
application, such as a robot. However, all applications <termref def="dt-must">should</termref>
take into account the full implications of ignoring the specified behavior
before choosing a different course.</p>
<example>
<head>Sample <att>show</att> and <att>actuate</att> Attribute Declarations</head>
<p>Following is a non-normative attribute-list declaration for <att>show</att>
and <att>actuate</att> on an element intended to be <el>simple</el>-type.</p>
<note>
<p>Editor's Note (stylesheet is suppressing the real ones!): No QNames allowed;
list of allowed values modified/expanded. Is this okay?</p>
</note>
<eg>&lt;!ATTLIST simplelink
  xlink:type      (simple)        #FIXED "simple"
  ...
  &showactuateattribs;
  ...></eg>
</example>
<p>Applications encountering <el>arc</el>-type elements in linkbase lists <termref
def="dt-must">must</termref> treat the behavior attributes as if they were
specified as <code>show="none"</code> and <code>actuate="onLoad"</code>, even
if other values were specified.</p>
<div3 id="show-att">
<head><att>show</att> Attribute</head>
<p>The <att>show</att> attribute is used to communicate the desired presentation
of the ending resource on traversal from the starting resource.</p>
<constraintnote id="cn-show-value" type="conformance">
<head>show Value</head>
<p>If a value is supplied for a <att>show</att> attribute, it <termref def="dt-must">must</termref>
be one of the values <attval>new</attval>, <attval>replace</attval>, <attval>embed</attval>, <attval>other</attval>,
and <attval>none</attval>.</p>
</constraintnote>
<p>Conforming XLink applications <termref def="dt-must">should</termref> apply
the following treatment for <att>show</att> values:</p>
<glist>
<gitem><label><attval>new</attval></label>
<def>
<p>An application traversing to the ending resource <termref def="dt-must">should</termref>
load it in a new window, frame, pane, or other relevant presentation context.
This is similar to the effect achieved by the following HTML fragment:</p>
<eg>&lt;A HREF="http://www.example.org" target="_blank">...&lt;/A></eg>
</def></gitem>
<gitem><label><attval>replace</attval></label>
<def>
<p>An application traversing to the ending resource <termref def="dt-must">should</termref>
load the resource in the same window, frame, pane, or other relevant presentation
context in which the starting resource was loaded. This is similar to the
effect achieved by the following HTML fragment:</p>
<eg>&lt;A HREF="http://www.example.org" target="_self">...&lt;/A></eg>
</def></gitem>
<gitem><label><attval>embed<?Pub Caret?></attval></label>
<def>
<p>An application traversing to the ending resource <termref def="dt-must">should</termref>
load it in place of the starting resource. This is similar to the effect achieved
by the following HTML fragment:</p>
<eg>&lt;IMG SRC="http://www.example.org/smiley.gif" ALT=":-)"></eg>
<p>The starting resource is typically not an entire document; it would be
the entire document only when the root element of the document is a simple
link. Thus, embedding typically has an effect distinct from replacing.</p>
<p>Just as for the HTML <el>IMG</el> element, embedding affects only the presentation
of the relevant resources; it does not dictate permanent transformation of
the starting resource. For example, if the ending resource is XML, it is not
parsed as if it were part of the starting resource.</p>
</def></gitem>
<gitem><label><attval>other</attval></label>
<def>
<p>The behavior of an application traversing to the ending resource is unconstrained
by this specification. The application <termref def="dt-must">should</termref>
look for other markup present in the link to determine the appropriate behavior.</p>
</def></gitem>
<gitem><label><attval>none</attval></label>
<def>
<p>The behavior of an application traversing to the ending resource is unconstrained
by this specification. No other markup is present to help the application
determine the appropriate behavior.</p>
</def></gitem>
</glist>
<p>Special conditions apply if the starting or ending resource is a portion
of an XML document that consists of other than a single node (see <bibref
ref="xptr"/> for more information about selecting fragments of XML documents):</p>
<ulist>
<item><p>If the starting resource is a fragment whose location set contains
multiple nodes, then an application <termref def="dt-must">should</termref>
treat each node of the starting resource as an individual starting resource
and traverse to the ending resource as a succession of single traversals in
the style of a programming <quote>foreach</quote> construct.</p></item>
<item><p>If the ending resource is a fragment whose location set contains
either multiple nodes or non-node content (such as a range or string range),
then an application <termref def="dt-must">should</termref>, on traversal,
present it as a unified concatenation of all the content in the location set.</p>
</item>
</ulist>
</div3>
<div3 id="actuate-att">
<head><att>actuate</att> Attribute</head>
<p>The <att>actuate</att> attribute is used to communicate the desired timing
of traversal from the starting resource to the ending resource..</p>
<constraintnote id="cn-actuate-value" type="conformance">
<head>actuate Value</head>
<p>If a value is supplied for an <att>actuate</att> attribute, it <termref
def="dt-must">must</termref> be be one of the values <attval>onLoad</attval>, <attval>onRequest</attval>, <attval>other</attval>,
and <attval>none</attval>.</p>
</constraintnote>
<p>Conforming XLink applications <termref def="dt-must">should</termref> apply
the following treatment for <att>actuate</att> values:</p>
<glist>
<gitem><label><attval>onLoad</attval></label>
<def>
<p>An application <termref def="dt-must">should</termref> traverse to the
ending resource immediately on loading the starting resource. This is similar
to the effect typically achieved by the following HTML fragment, when the
user agent is configured to display images:</p>
<eg>&lt;IMG SRC="http://www.example.org/smiley.gif" ALT=":-)"></eg>
<note>
<p>Editor's note (the stylesheet is suppressing the real ones!): How does
the following sound for handling multiple onLoad/replace arcs in a single
document?</p>
</note>
<p>For arcs whose behavior is set to <code>show="replace" actuate="onLoad"</code>,
special conditions apply as follows:</p>
<ulist>
<item><p>If a single resource contains more than one starting resource whose
traversal behavior is set in this fashion, the XLink application <termref
def="dt-must">should</termref> traverse only the first, as determined by document
order; the rest are untraversable.</p></item>
<item><p>In cases where one starting resource contains another and the two
share a starting point (for example, two string ranges in an XML document
that share the same first character but have different last characters), the
XLink application <termref def="dt-must">should</termref> traverse to the
larger starting resource.</p></item>
<item><p>In cases where several arcs (from either a single link or multiple
links) specify the identical starting resource, application behavior is unconstrained
by XLink.</p></item>
</ulist>
</def></gitem>
<gitem><label><attval>onRequest</attval></label>
<def>
<p>An application <termref def="dt-must">should</termref> traverse from the
starting resource to the ending resource only on a post-loading event triggered
for the purpose of traversal. An example of such an event might be when a
user clicks on the presentation of the starting resource, or a software module
finishes a countdown that precedes a redirect.</p>
</def></gitem>
<gitem><label><attval>other</attval></label>
<def>
<p>The behavior of an application traversing to the ending resource is unconstrained
by this specification. The application <termref def="dt-must">should</termref>
look for other markup present in the link to determine the appropriate behavior.</p>
</def></gitem>
<gitem><label><attval>none</attval></label>
<def>
<p>The behavior of an application traversing to the ending resource is unconstrained
by this specification. No other markup is present to help the application
determine the appropriate behavior.</p>
</def></gitem>
</glist>
</div3>
</div2>
<div2 id="traversal-atts">
<head>Traversal Attributes (<att>label</att>, <att>from</att>, and <att>to</att>)</head>
<p>The traversal attributes are <att>label</att>, <att>from</att>, and <att>to</att>.
The <att>label</att> attribute <termref def="dt-must">may</termref> be used
on the <el>resource</el>- and <el>locator</el>-type elements. The <att>from</att>
and <att>to</att> attributes <termref def="dt-must">may</termref> be used
on the <el>arc</el>-type element.</p>
<constraintnote id="cn-fromto-values" type="conformance">
<head><att>label</att>, <att>from</att>, and <att>to</att> Values</head>
<p>The value of a <att>label</att>, <att>from</att>, or <att>to</att> attribute
must be an <xnt href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</xnt>.
If a value is supplied for a <att>from</att> or <att>to</att> attribute, it <termref
def="dt-must">must</termref> correspond to the same value for some <att>label</att>
attribute on a <el>locator</el>- or <el>resource</el>-type element that appears
as a direct child inside the same <el>extended</el>-type element as does the <el>arc</el>-type
element. </p>
</constraintnote>
</div2>
</div1>
</body><back>
<div1 id="references">
<head>References</head>
<div2>
<head>Normative References</head>
<blist>
<bibl id="rfc2396" href="http://www.ics.uci.edu/pub/ietf/uri/rfc2396.txt"
key="IETF RFC 2396">IETF (Internet Engineering Task Force). <titleref>RFC
2396: Uniform Resource Identifiers</titleref>. 1995.</bibl>
<bibl id="XML" href="http://www.w3.org/TR/REC-xml" key="XML">Tim Bray, Jean
Paoli, and C.M. Sperberg-McQueen, editors. <emph>Extensible Markup Language
(XML) 1.0.</emph> World Wide Web Consortium, 1998.</bibl>
<bibl id="xbase" xmlns:xlink="http://www.w3.org/TR/WD-xlink" href="http://www.w3.org/TR/xmlbase"
key="XML Base">Jonathan Marsh, editor. <titleref>XML Base (XBase)</titleref>.
World Wide Web Consortium, 1999.</bibl>
<bibl id="xname" xmlns:xlink="http://www.w3.org/TR/WD-xlink" href="http://www.w3.org/TR/REC-xml-names/"
key="XML Names">Tim Bray, Dave Hollander, and Andrew Layman, editors. <titleref>Namespaces
in XML</titleref>. Textuality, Hewlett-Packard, and Microsoft. World Wide
Web Consortium, 1999.</bibl>
</blist></div2>
<div2>
<head>Non-Normative References</head>
<blist>
<bibl id="chum" key="CHUM">Steven J. DeRose and David G. Durand. 1995. "The
TEI Hypertext Guidelines." In <titleref>Computing and the Humanities</titleref>
29(3). Reprinted in <titleref>Text Encoding Initiative: Background and Context</titleref>,
ed. Nancy Ide and Jean Ronis, ISBN 0-7923-3704-2.</bibl>
<bibl id="dexter" key="Dexter">Halasz, Frank. 1994. <quote>The Dexter Hypertext
Reference Model.</quote> In Communications of the Association for Computing
Machinery 37 (2), February 1994: 30-39.</bibl>
<bibl id="fress" key="FRESS">Steven J. DeRose and Andries van Dam. 1999. <quote>Document
structure in the FRESS Hypertext System.</quote> Markup Languages 1 (1) Winter.
Cambridge: MIT Press: 7-32. (See also <loc href=" http://www.stg.brown.edu/~sjd/fress.html">
http://www.stg.brown.edu/~sjd/fress.html</loc> for more information.)</bibl>
<bibl id="html" href="http://www.w3.org/TR/html4/" key="HTML"><titleref>HTML
4.01 Specification</titleref>. World Wide Web Consortium, 1999. (See <loc
href="http://www.w3.org/TR/html4/">http://www.w3.org/TR/html4/</loc>.)</bibl>
<bibl id="rfc2119" key="IETF RFC 2119">S. Bradner, editor. <titleref>Key words
for use in RFCs to Indicate Requirement Levels</titleref>. March 1997. (See <loc
href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</loc>.)</bibl>
<bibl id="intermedia" key="Intermedia">Yankelovich, Nicole, Bernard J. Haan,
Norman K. Meyrowitz, and Steven M. Drucker. 1988. <quote>Intermedia: The Concept
and the Construction of a Seamless Information Environment.</quote> IEEE Computer
21 (January, 1988): 81-96.</bibl>
<bibl id="iso10744" key="ISO/IEC 10744">ISO (International Organization for
Standardization). <titleref>ISO/IEC 10744-1992 (E). Information technology-Hypermedia/Time-based
Structuring Language (HyTime).</titleref> [Geneva]: International Organization
for Standardization, 1992. <titleref>Extended Facilities Annex.</titleref>
[Geneva]: International Organization for Standardization, 1996. (See  <loc
href="http://www.ornl.gov/sgml/wg8/docs/n1920/">http://www.ornl.gov/sgml/wg8/docs/n1920/</loc>.)</bibl>
<bibl id="microcosm" key="MicroCosm">Hall, Wendy, Hugh Davis, and Gerard Hutchings.
1996. <titleref>Rethinking Hypermedia: The Microcosm Approach.</titleref>
Boston: Kluwer Academic Publishers. ISBN 0-7923-9679-0.</bibl>
<bibl id="ohs" href="http://aue.auc.dk/~kock/OHS-HT98/Papers/ossenbruggen.html"
key="OHS">van Ossenbruggen, Jacco, Anton Eliëns and Lloyd Rutledge. <quote>The
Role of XML in Open Hypermedia Systems.</quote> Position paper for the 4th
Workshop on Open Hypermedia Systems, ACM Hypertext '98. (See <loc href="http://aue.auc.dk/~kock/OHS-HT98/Papers/ossenbruggen.html">http://aue.auc.dk/~kock/OHS-HT98/Papers/ossenbruggen.html</loc
>.)</bibl>
<bibl id="rdf" xmlns:xlink="http://www.w3.org/TR/WD-xlink" href="http://www.w3.org/TR/REC-rdf-syntax"
key="RDF">Ora Lassila and Ralph Swick, editors. <titleref>Resource Description
Framework (RDF) Model and Syntax Specification</titleref>. World Wide Web
Consortium, 1999. (See <loc href="http://www.w3.org/TR/REC-rdf-syntax">http://www.w3.org/TR/REC-rdf-syntax</loc>.)</bibl>
<bibl id="tei" key="TEI">C. M. Sperberg-McQueen and Lou Burnard, editors.<titleref>Guidelines
for Electronic Text Encoding and Interchange</titleref>. Association for Computers
and the Humanities (ACH), Association for Computational Linguistics (ACL),
and Association for Literary and Linguistic Computing (ALLC). Chicago, Oxford:
Text Encoding Initiative, 1994.</bibl>
<bibl id="infoset" xmlns:xlink="http://www.w3.org/TR/WD-xlink" href="http://www.w3.org/TR/xml-infoset"
key="XIS">John Cowan and David Megginson, editors. <titleref>XML Information
Set</titleref>. World Wide Web Consortium, 1999. (See <loc href="http://www.w3.org/TR/xml-infoset">http://www.w3.org/TR/xml-infoset</loc>.)</bibl>
<bibl id="xlreq" xmlns:xlink="http://www.w3.org/TR/WD-xlink" key="XLREQ">Steven
DeRose, editor. <titleref>XML XLink Requirements Version 1.0</titleref>. Brown
University. Seekonk: World Wide Web Consortium, 1999. (See <loc href="http://www.w3.org/TR/NOTE-xlink-req">http://www.w3.org/TR/NOTE-xlink-req</loc
>.)</bibl>
<bibl id="xldp" href="http://www.w3.org/TR/NOTE-xlink-principles" key="XLDP">Eve
Maler and Steve DeRose, editors. <titleref>XML Linking Language (XLink) Design
Principles</titleref>. Seekonk: World Wide Web Consortium, 1998. (See <loc
href="http://www.w3.org/TR/NOTE-xlink-principles">http://www.w3.org/TR/NOTE-xlink-principles</loc>.)</bibl>
<bibl id="xptr" href="http://www.w3.org/TR/xptr" key="XPTR">Ron Daniel, Steve
DeRose, and Eve Maler, editors.<titleref> XML Pointer Language (XPointer)
V1.0</titleref>. Metacode Technologies, Brown University, and Sun Microsystems.
Burlington, Seekonk, et al.: World Wide Web Consortium, 1998. (See <loc href="http://www.w3.org/TR/xptr">http://www.w3.org/TR/xptr</loc>.)</bibl>
</blist></div2>
</div1>
<inform-div1 id="acknowledgements">
<head>Working Group Members and Acknowledgments</head>
<p>This specification was produced in the XML Linking Working Group, with
the following members active at the completion of this specification:</p>
<ulist>
<item><p>Peter Chen (LSU, Bootstrap Alliance)</p></item>
<item><p>Ron Daniel (Metacode Technologies, Inc.)</p></item>
<item><p>Steve DeRose (Brown University Scholarly Technology Group), XLink
co-editor</p></item>
<item><p>David Durand (University of Southhampton, Boston University, Dynamic
Diagrams)</p></item>
<item><p>Masatomo Goto (Fujitsu Laboratories)</p></item>
<item><p>Paul Grosso (Arbortext)</p></item>
<item><p>Eduardo Gutentag (Sun Microsystems)</p></item>
<item><p>Chris Maden (Yomu)</p></item>
<item><p>Eve Maler (Sun Microsystems), co-chair and XLink co-editor</p></item>
<item><p>Murray Maloney (Commerce One)</p></item>
<item><p>Jonathan Marsh (Microsoft)</p></item>
<item><p>David Orchard, XLink co-editor</p></item>
<item><p>Ben Trafford, XLink co-editor</p></item>
<item><p>Daniel Veillard (W3C staff contact), co-chair</p></item>
</ulist>
<p>The editors wish to acknowledge substantial contributions from Tim Bray,
who previously served as co-editor and co-chair. We would also like to acknowledge
important contributions from Gabe Beged-Dov, who wrote the XArc proposal.
Finally, we would like to thank the XML Linking Interest Group and Working
Group for their support and input.</p>
</inform-div1>
</back></spec>
<?Pub *0000096305?>
