<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>HLink</title>
<style type="text/css">
.unfinished { font-style: normal; background-color: #FFFF33}
.dtd-code { font-family: monospace; background-color: #dfdfdf; white-space: pre; border: #000000; border-style: solid; border-top-width: 1px; border-right-width: 1px; border-bottom-width: 1px; border-left-width: 1px}
code {
color: green;
font-family: monospace;
font-weight: bold;
}
h4 { color: #005A9C; background: white }
code.greenmono {
color: green;
font-family: monospace;
font-weight: bold;
}
.example {
border: solid green;
border-width: 2px;
color: green;
font-weight: bold;
margin-right: 5%;
margin-left: 0;
}
.bad {
border: solid red;
border-width: 2px;
margin-left: 0;
margin-right: 5%;
color: rgb(192, 101, 101);
}
div.navbar { text-align: center; }
div.contents {
background-color: rgb(204,204,255);
padding: 0.5em;
border: none;
margin-right: 5%;
}
.tocline { list-style: none; }
td { text-align: left }
.ins { background-color: yellow }
.del { background-color: yellow; text-decoration: line-through }
.issue {
background-color: #cfc ;
border: none ;
margin-right: 5% ;
}
pre.dtd, pre.rng, pre.xsd {
white-space: pre;
font-family: monospace;
font-weight: normal;
margin-right: 0;
margin-left: 0;
}
</style>
<link rel="stylesheet" type="text/css" href="https://www.w3.org/StyleSheets/TR/W3C-WG-NOTE" />
</head>
<body>
<div class="head">
<img height="48" width="72" alt="W3C" src="https://www.w3.org/Icons/w3c_home" />
<h1>HLink</h1>
<h2>Link recognition for the XHTML Family</h2>
<h2>W3C Working Group Note 16 December 2010</h2>
<dl>
<dt>This version:</dt>
<dd>http://www.w3.org/TR/2010/NOTE-hlink-20101216</dd>
<dt>Latest version:</dt>
<dd>http://www.w3.org/TR/hlink</dd>
<dt>Previous version:</dt>
<dd>http://www.w3.org/TR/2002/WD-hlink-20020913</dd>
<dt>Diff-marked version:</dt>
<dd>hlink-diff.html</dd>
<dt>Editors:</dt>
<dd>Steven Pemberton, CWI/W3C</dd>
<dd>Masayasu Ishikawa, W3C</dd>
</dl>
<p>This document is also available in these non-normative formats:
PostScript version,
PDF
version,
ZIP archive, and
Gzip'd TAR archive.</p>
<p class="copyright">Copyright © 2002-2010 W3C<sup>®</sup> (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.</p>
<hr />
</div>
<h2>Abstract</h2>
<p>The HLink module defined in this specification provides XHTML Family
Members with the ability to specify which attributes of elements represent
links, and how those links should be traversed, and extends XLink use to a
wider class of languages than those restricted to the syntactic style allowed
by XLink.</p>
<h2>Status of This Document</h2>
<p>This section describes the status of this document at the time
of its publication. Other documents may supersede this document. A
list of current W3C publications and the latest revision of this
technical report can be found in the W3C technical reports index at
http://www.w3.org/TR/.</p>
<p>This document is a Working Group Note. The XHTML2 Working Group's
charter expired before it could complete work on this document. It is possible
that the work will be continued by another group in the future.</p>
<p>Publication as a Working Group Note does not imply endorsement by
the W3C Membership. This is a draft document and may be updated,
replaced or obsoleted by other documents at any time. It is
inappropriate to cite this document as other than work in
progress.</p>
<p>This document has been produced by the W3C XHTML 2 Working Group as part of the HTML Activity. The goals of
the XHTML 2 Working Group are discussed in the XHTML 2 Working Group charter.</p>
<p>This document was produced by a group operating under the 5 February 2004 W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for
disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential
Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.</p>
<p>Public discussion of HTML takes place on
[email protected]
(archive).
To subscribe send an email to
[email protected]
with the word subscribe in the subject line.</p>
<p>Please report errors in this document to
[email protected]
(archive).
</p>
<div class="toc">
<h2>Contents</h2>
</div>
<h2>
1. Introduction</h2>
<p>
This section is informative.</p>
<p>This document defines markup that can be used to describe links in XHTML
Family members. It consists of two elements that are used to associate
properties with markup elements and attributes to describe how they behave as
links. Many of the descriptive properties are taken from XLink [
XLINK], but with additions to support the behaviour of
links in XHTML.</p>
<h2 id="s_definitions">2. Definitions</h2>
<p>[TBD]</p>
<h2>
3. The HLink Module</h2>
<p>
This section is normative.</p>
<p>This specification defines a module called HLink. The module uses the XML
Namespaces [
NAME] identifier
http://www.w3.org/2002/06/hlink.</p>
<p>Examples in this document that use the namespace prefix
"
hlink" all assume an
xmlns declaration
xmlns:hlink="http://www.w3.org/2002/06/hlink" somewhere suitable
in the document involved. All examples are informative.</p>
<p>The remainder of this section describes the elements and attributes in
this module, the semantics, and provides an abstract module definition as
required in [
XHTMLMOD].</p>
<p>The HLink Module supports the following element and attributes:</p>
<table class="moduledef" border="1"
summary="Element and Attributes for HLink Module">
<thead>
<tr>
<th>Element</th>
<th>Attributes</th>
<th>Minimal Content Model</th>
</tr>
</thead>
<tbody>
<tr>
<td>hlinks</td>
<td>-</td>
<td>hlink+</td>
</tr>
<tr>
<td>hlink</td>
<td>namespace* (
URI),
element (
NAME),<br
/>
locator (
NAME),
locatorValue (
URI),<br
/>
effect (
NAME),
effectValue (
URI),<br
/>
actuate (
NAME),
actuateValue (
URI),<br
/>
replacement (
NAME),
replacementValue (
URI),<br
/>
role (
NAME),
roleValue (
URI),
<br />
shape (
CDATA),
shapeValue (TBD), <br />
coords (
CDATA),
coordsValue (TBD),
<br />
contentType
(ContentType), contentTypeValue (TBD), <br />
onSuccess (
CDATA),
onSuccessValue (TBD),<br />
onFailure (
CDATA),
onFailureValue (TBD)
</td>
<td>EMPTY</td>
</tr>
</tbody>
</table>
<p>Implementations:
DTD,
RELAX NG,
XML Schema</p>
<h3>
3.1. The hlinks
Element</h3>
<p>The
hlinks element exists only to be a root element for a
document containing only
hlink elements; see
section 4 Usage, and the hlink:definition attribute
defined there.</p>
<div class="issue">
<p>[[Issue: you could define inheritance in nested
hlink
elements:</p>
<pre><hlink namespace="...">
<hlink element="a" ... />
<hlink element="b" ... />
</hlink></pre>
<p>which would make writing descriptions easier, and make an outer
hlinks elements unnecessary, though at the cost of slightly
complicating implementation]]</p>
</div>
<h3>
3.2. The hlink
Element</h3>
<p>Element
hlink is used to identify an element and/or
attributes within a namespace, and associate properties with them to specify
how the element should be treated as a link, or how the attributes contribute
to an element that is a link. The
hlink element has the
following attributes:</p>
<dl>
<dt>namespace</dt>
<dd>This required attribute specifies a namespace URI that the element
identified in the
element attribute belongs to, or the
other attributes when the
element attribute is
omitted.</dd>
<dt>element</dt>
<dd>This optional attribute specifies an element in the namespace
identified by the attribute
namespace. The rest of the
attributes below specify properties of this element. If this attribute
is absent, then the attributes describe global attributes (as defined
in [
NAME]) within the namespace instead; these
attributes then describe the element that they are actually on in the
markup. If this attribute has the special value "
*" then
the rest of the attributes describe all suitable elements in the
namespace (as defined by a DTD or schema); for instance, if the
hlink element defines an attribute
href for
an
element value of
*, then all elements that
the DTD allows to have an attribute
href are so
defined.</dd>
</dl>
<p>The remaining attributes come in two variants: one variant specifies a
value that indicates how the element is to behave as a link-related element,
and the other specifies the name of an attribute on the element being defined
that supplies the value. For instance:</p>
<pre>locatorValue="http://www.w3.org/"</pre>
<p>says that the element in question is a locator for a fixed URI, namely
http://www.w3.org/. On the other hand:</p>
<pre>locator="href"</pre>
<p>says that the element in question has an attribute named
href, that contains the URI of the locator.</p>
<p>If both variants are used, then the attribute-name version takes
precedence: if the named attribute (for instance
locator) has a
value, that value is used, otherwise the value attribute is used (in this
case
locatorValue).</p>
<p>As a shorthand, whenever this specification refers to a
property,
it means the final value via the combination of such a pair. For instance "if
the
effect property has the value
replace" means
"if the
effect attribute refers to an attribute that has the
value
replace or the
effectValue attribute has the
value
replace".</p>
<p>The properties are:</p>
<dl>
<dt>locator</dt>
<dd>This property specifies a URI-reference [anyURI] for the link. There
is no default value.<br />
<span class="issue">[[Issue: URI lists, like html:archive]]</span></dd>
<dt>effect</dt>
<dd>This property specifies the effect of actuating the link. It has the
following possible values:
<dl>
<dt>new</dt>
<dd>The resource identified by the
locator property is
loaded in a new context. For instance in a windowing environment,
the resource is loaded in a new window.</dd>
<dt>replace</dt>
<dd>A suitable context, as identified by the
replacement property, is located, and the resource
in that context is replaced by the resource identified by the
locator property. If no such resource can be
located, a new context with that name is created, initialised
with the identified resource. If there is no
replacement property then the initiating resource is
replaced by the resource identified by the
locator
property.</dd>
<dt>embed</dt>
<dd>The resource identified by the
locator property is
considered to be embedded in the environment of the initiating
resource. This includes images and other media resources, as well
as such resources as scripts and style sheets.
<p><span class="issue">[[Issue: define embed more
precisely]]</span></p>
</dd>
<dt>submit</dt>
<dd>The locator is used to submit a form.
<p><span class="issue">[[More needs to be described here]]<br />
[[Issue: is form submission linking?]]</span></p>
</dd>
<dt>map</dt>
<dd>The resource identified by the
locator property
describes how the presentation of the current element is to be
interpreted as a series of links to further resources.
<p><span class="issue">[[More/better: this is here as a
placeholder to describe XHTML's image maps]]</span></p>
</dd>
</dl>
<p>The default value is
replace.</p>
</dd>
<dt>actuate</dt>
<dd>This property specifies the manner that the link should or can be
actuated. It has the following possible values:
<dl>
<dt>onLoad</dt>
<dd>Actuation of the link is done on loading the initiating
resource.</dd>
<dt>onRequest</dt>
<dd>Actuation is done by the user using the primary actuation
method or by a method (such as scripting) imitating this
behavior.</dd>
<dt>onRequestSecondary</dt>
<dd>Actuation is done by the user using a secondary actuation
method or by a method (such as scripting) imitating this
behavior. For instance, an element specifying a link (such as
XHTML's
a element) may contain an image (for
instance using XHTML's
img element) that
additionally has a link to a resource describing that image (such
as XHTML's
longdesc attribute). The primary
actuation method must activate the
a element; the
secondary actuation method must allow the user to request
activation of any of the other resources available at that point
(for instance via a pop-up menu).</dd>
</dl>
<p>The default value is
onRequest.</p>
</dd>
<dt>replacement</dt>
<dd>This property specifies an environment in the case that the
effect property has the value
replace. If the
effect property does not have that value, the
replacement property is ignored.</dd>
<dt>role</dt>
<dd><p>This property gives information to the user agent about the role
the link plays. <span class="issue">[[More]]</span></p>
<p class="issue">[[These are the values that rel and rev can take
according to HTML 4: Contents Glossary Copyright Chapter Section
Subsection Appendix Help Bookmark Index Next Prev Alternate Start
Stylesheet, and other specifications have added other values; e.g.
P3P]]</p>
</dd>
<dt>shape</dt>
<dd class="issue">[[for image maps: default rect circle poly]]</dd>
<dt>coords</dt>
<dd class="issue">[[For image maps: list of coordinates [[or
percentages?]]]]</dd>
<dt>contentType</dt>
<dd>This property specifies the allowable content types of the relevant
resource. At its most general, it is a comma-separated list of media
ranges with optional accept parameters, as defined in section 14.1 of
[
RFC2616]
as the field value of the accept request header.
<p>In its simplest case, this is just a media type, such as "image/png"
or "application/xml", but it may also contain asterisks, such as
"image/*" or "*/*", or lists of acceptable media types, such as
"image/png, image/gif, image/jpeg".</p>
<p>The user agent must combine this list it with its own list of
acceptable media types by taking the intersection, and then use the
resulting list as the field value of the
accept request
header when requesting the resource using HTTP.</p>
<p>For instance, if the property specifies the value "image/png,
image/gif, image/jpeg", but the user agent does not accept images of
type "image/gif" then the resultant accept header would contain
"image/png, image/jpeg".</p>
<p>A user agent should imitate similar behavior when using other
methods than HTTP. For instance, when accessing files in a local
filestore, a
contentType property of
"image/png,
image/jpeg" might cause the user agent first to look for a file
with extension
.png, and then for one with extension
.jpg.</p>
<p>If this property is not present, "*/*" is used for its value.</p>
</dd>
<dt>onSuccess</dt>
<dd>This property indicates the required processing after successfully
actuating a link that has an
effect property of
embed and an
actuate property of
onLoad. It has two values:
<dl>
<dt>processChildren</dt>
<dd>processing should continue by processing the children of the
element</dd>
<dt>ignoreChildren</dt>
<dd>processing should continue by ignoring the children of the
element</dd>
</dl>
<p>(If the element has no children, these two values are equivalent)</p>
<p>The default value is
ignoreChildren.</p>
</dd>
<dt>onFailure</dt>
<dd>This property indicates the required processing when a link that has
an
effect property of
embed and an
actuate property of
onLoad cannot be
actuated, either because of network failure or the resource not being
available or found, or because the user agent cannot process the
resource or the
contentType property indicates that the user
agent would not be able to process the resource. It has four possible
values:
<dl>
<dt>processChildren</dt>
<dd>processing should continue by processing the children of the
element</dd>
<dt>ignoreChildren</dt>
<dd>processing should continue by ignoring the children of the
element</dd>
<dt>warn</dt>
<dd>processing continues, though it must be made obvious to the
user that the actuation failed</dd>
<dt>fail</dt>
<dd>processing stops with an error message</dd>
</dl>
<p>The default value is
warn.</p>
</dd>
</dl>
<p class="issue">[[Issue: onSuccess and onFailure need more work to cover
other onLoad cases]]</p>
<p><span class="issue">[[Issue: replace onSuccess/onFailure with
fallback="..."?]]</span></p>
<p class="issue">[[Issue: markup for case where link has a side-effect
needed?]]</p>
<h2>
3.3. Examples</h2>
- The definition of the
<a href="..."> element in
XHTML:
<pre><hlink namespace="http://www.w3.org/1999/xhtml"
element="a"
locator="href"
effectValue="replace"
actuateValue="onRequest"
replacement="target"/></pre>
- Defining
<img/> in XHTML
<pre><hlink namespace="http://www.w3.org/1999/xhtml"
element="img"
locator="src"
effectValue="embed"
actuateValue="onLoad"
onFailureValue="warn"/>
<hlink namespace="http://www.w3.org/1999/xhtml"
element="img"
locator="longdesc"
effectValue="new"
actuateValue="onRequestSecondary"/>
<hlink namespace="http://www.w3.org/1999/xhtml"
element="img"
locator="usemap"
effectValue="map"
actuateValue="onLoad"/></pre>
- Defining
<object> in XHTML
<pre><hlink namespace="http://www.w3.org/1999/xhtml"
element="object"
locator="data"
effectValue="embed"
actuateValue="onLoad"
onFailureValue="processChildren"
onSuccessValue="ignoreChildren"/></pre>
- Defining a new
<home/> element
<pre><hlink namespace="http://www.example.com/markup"
element="home"
locatorValue="/"
effectValue="replace"
actuateValue="onRequest"/>
<hlink namespace="http://www.example.com/markup"
element="home"
locatorValue="/icons/home.png"
effectValue="embed"
actuateValue="onLoad"/></pre>
<p>In the context of this definition, and the namespace declaration</p>
<pre>xmlns="http://www.example.com/markup"</pre>
<p>the markup</p>
<pre><home/></pre>
<p>will display a clickable icon that takes the user to the home page.</p>
- Defining redirection:
<pre><hlink namespace="http://www.example.com/markup"
element="redirect"
locator="href"
effectValue="replace"
actuateValue="onLoad"/></pre>
<p>In the context of this definition and a suitable namespace
declaration, the following markup will cause the initiating resource to
be redirected:</p>
<pre><redirect href="whereever">This page has moved</redirect></pre>
- Defining
<html:blockquote>
<pre><hlink namespace="http://www.w3.org/1999/xhtml"
element="blockquote"
locator="cite"
effectValue="new"
actuateValue="onRequestSecondary"/></pre>
- Defining RDF
<pre><hlink namespace="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
element="Description"
locator="about"
effectValue="new"
actuateValue="onRequestSecondary"/>
<hlink namespace="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
locator="resource"
effectValue="new"
actuateValue="onRequestSecondary"/></pre>
<h2>
4. Usage</h2>
<p>
This section is normative.</p>
<p>There are two ways to use HLink. The first is <span class="issue">[[by
putting the
<hlink>s in the
<head>, and
the other by putting them in a separate resource, and referring to that
resource by a
hlink:definition URI attribute on the root element
of the document</span></p>
<div class="issue">
<p>Either this</p>
<pre><html hlink:definition="http://www.example.org/whatever" ...></pre>
<p>or this:</p>
<pre><html ...>
<head>
<hlink:hlink ... />
...
</head></pre>
<p>]]</p>
</div>
<h2>
A. Module
Implementations</h2>
<p>This appendix is
normative.</p>
<p>[[NOT YET UP TO DATE]]</p>
<h3>
A.1. DTD
Implementation</h3>
<h3>
A.1.1. HLink DTD</h3>
<pre class="dtd"><?xml version="1.0" encoding="UTF-8"?>
<!-- ...................................................................... -->
<!-- HLink DTD ............................................................ -->
<!-- URI: http://www.w3.org/2002/06/hlink.dtd
This is HLink - a link recongnition mechanism for the XHTML Family.
Copyright ©2002 W3C (MIT, INRIA, Keio), All Rights Reserved.
Editor: Masayasu Ishikawa <
[email protected]>
Revision: $Id: Overview.html,v 1.5 2018/10/09 13:23:57 denis Exp $
Permission to use, copy, modify and distribute the HLink DTD and its
accompanying documentation for any purpose and without fee is hereby
granted in perpetuity, provided that the above copyright notice and
this paragraph appear in all copies. The copyright holders make no
representation about the suitability of this DTD for any purpose.
It is provided "as is" without expressed or implied warranty.
This DTD module is identified by the PUBLIC and SYSTEM identifiers:
PUBLIC "-//W3C//DTD HLink 1.0//EN"
SYSTEM "http://www.w3.org/2002/06/hlink.dtd"
Revisions:
(none)
....................................................................... -->
<!-- HLink
hlinks, hlink
This HLink DTD declares elements and attributes defining
HLink, a link recongnition mechanism for the XHTML Family.
-->
<!-- Datatypes
defines containers for the following datatypes, many of
these imported from other specifications and standards -
not quite used at the moment.
-->
<!-- media type, as per [RFC2045] -->
<!ENTITY % ContentType.datatype "CDATA" >
<!-- comma separated list of coordinates to use in defining areas -->
<!ENTITY % Coords.datatype "CDATA" >
<!-- space-separated list of link types -->
<!ENTITY % LinkTypes.datatype "NMTOKENS" >
<!-- the shape of a region -->
<!ENTITY % Shape.datatype "( default | rect | circle | poly )">
<!-- a Uniform Resource Identifier reference, as per anyURI in
XML Schema Part 2 [SCHEMA]
-->
<!ENTITY % URI.datatype "CDATA" >
<!-- HLink Qname (Qualified Name) Module -->
<!ENTITY % hlink-qname.mod
PUBLIC "-//W3C//ENTITIES HLink Qualified Names 1.0//EN"
"hlink-qname.mod" >
%hlink-qname.mod;
<!-- hlinks element .................................... -->
<!ELEMENT %HLINK.hlinks.qname; ( %HLINK.hlink.qname; )+ >
<!ATTLIST %HLINK.hlinks.qname;
%HLINK.xmlns.attrib;
>
<!-- hlink element ..................................... -->
<!ELEMENT %HLINK.hlink.qname; EMPTY >
<!ATTLIST %HLINK.hlink.qname;
%HLINK.xmlns.attrib;
namespace %URI.datatype; #REQUIRED
element NMTOKEN #IMPLIED
locator CDATA #IMPLIED
effect CDATA #IMPLIED
actuate CDATA #IMPLIED
replacement CDATA #IMPLIED
role CDATA #IMPLIED
reverseRole CDATA #IMPLIED
shape CDATA #IMPLIED
coords CDATA #IMPLIED
arcrole CDATA #IMPLIED
label CDATA #IMPLIED
from CDATA #IMPLIED
to CDATA #IMPLIED
contentType CDATA #IMPLIED
onSuccess CDATA #IMPLIED
onFailure CDATA #IMPLIED
>
<!-- end of hlink.dtd --></pre>
<h3>
A.1.2. HLink Qname Module</h3>
<pre class="dtd"><?xml version="1.0" encoding="UTF-8"?>
<!-- ....................................................................... -->
<!-- HLink Qname Module ................................................... -->
<!-- URI: http://www.w3.org/2002/06/hlink-qname.mod
This is HLink - a link recongnition mechanism for the XHTML Family.
Copyright ©2002 W3C (MIT, INRIA, Keio), All Rights Reserved.
Revision: $Id: Overview.html,v 1.5 2018/10/09 13:23:57 denis Exp $
This DTD module is identified by the PUBLIC and SYSTEM identifiers:
PUBLIC "-//W3C//ENTITIES HLink Qualified Names 1.0//EN"
SYSTEM "http://www.w3.org/2002/06/hlink-qname.mod"
Revisions:
(none)
....................................................................... -->
<!-- HLink Qname (Qualified Name) Module
This module is contained in two parts, labeled Section 'A' and 'B':
Section A declares parameter entities to support namespace-
qualified names, namespace declarations, and name prefixing
for HLink and extensions.
Section B declares parameter entities used to provide
namespace-qualified names for all HLink element types:
%HLINK.hlinks.qname; the xmlns-qualified name for <hlinks>
...
-->
<!-- Section A: HLink XML Namespace Framework :::::::::::::::::::: -->
<!-- 1. Declare a %HLINK.prefixed; conditional section keyword, used
to activate namespace prefixing. The default value should
inherit '%HLINK.NS.prefixed;' from the DTD driver, so that unless
overridden, the default behaviour follows the overall DTD
prefixing scheme.
-->
<!ENTITY % HLINK.NS.prefixed "IGNORE" >
<!ENTITY % HLINK.prefixed "%HLINK.NS.prefixed;" >
<!-- 2. Declare a parameter entity (eg., %HLINK.xmlns;) containing
the URI reference used to identify the HLink namespace
-->
<!ENTITY % HLINK.xmlns "http://www.w3.org/2002/06/hlink" >
<!-- 3. Declare parameter entities (eg., %MODULE.prefix;) containing
the default namespace prefix string(s) to use when prefixing
is enabled. This may be overridden in the DTD driver or the
internal subset of an document instance. If no default prefix
is desired, this may be declared as an empty string.
NOTE: As specified in [XMLNAMES], the namespace prefix serves
as a proxy for the URI reference, and is not in itself significant.
-->
<!ENTITY % HLINK.prefix "hlink" >
<!-- 4. Declare parameter entities (eg., %HLINK.pfx;) containing the
colonized prefix(es) (eg., '%HLINK.prefix;:') used when
prefixing is active, an empty string when it is not.
-->
<![%HLINK.prefixed;[
<!ENTITY % HLINK.pfx "%HLINK.prefix;:" >
]]>
<!ENTITY % HLINK.pfx "" >
<!-- declare qualified name extensions here ............ -->
<!ENTITY % hlink-qname-extra.mod "" >
%hlink-qname-extra.mod;
<!-- 5. The parameter entity %HLINK.xmlns.extra.attrib; may be
redeclared to contain any non-HLink namespace declaration
attributes for namespaces embedded in XML. The default
is an empty string. XLink should be included here if used
in the DTD.
-->
<!ENTITY % HLINK.xmlns.extra.attrib "" >
<![%HLINK.prefixed;[
<!ENTITY % HLINK.NS.decl.attrib
"xmlns:%HLINK.prefix; %URI.datatype; #FIXED '%HLINK.xmlns;'
%HLINK.xmlns.extra.attrib;"
>
]]>
<!ENTITY % HLINK.NS.decl.attrib
"%HLINK.xmlns.extra.attrib;"
>
<!-- Declare a parameter entity %HLINK.NS.decl.attrib; containing all
XML namespace declaration attributes used by HLink, including
a default xmlns declaration when prefixing is inactive.
-->
<![%HLINK.prefixed;[
<!ENTITY % HLINK.xmlns.attrib
"%HLINK.NS.decl.attrib;"
>
]]>
<!ENTITY % HLINK.xmlns.attrib
"xmlns %URI.datatype; #FIXED '%HLINK.xmlns;'
%HLINK.xmlns.extra.attrib;"
>
<!-- Section B: XML Qualified Names ::::::::::::::::::::::::::::: -->
<!-- 6. This section declares parameter entities used to provide
namespace-qualified names for all HLink element types.
-->
<!ENTITY % HLINK.hlinks.qname "%HLINK.pfx;hlinks" >
<!ENTITY % HLINK.hlink.qname "%HLINK.pfx;hlink" >
<!-- end of hlink-qname.mod --></pre>
<h3>
A.2. RELAX NG
Implementation</h3>
<pre class="rng"><?xml version="1.0" encoding="UTF-8"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0"
xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0"
ns="http://www.w3.org/2002/06/hlink"
datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
<start>
<choice>
<ref name="hlinks"/>
</choice>
</start>
<a:documentation>
HLink in RELAX NG
URI: http://www.w3.org/2002/06/hlink.rng
This is HLink - a link recongnition mechanism for the XHTML Family.
Copyright ©2002 W3C (MIT, INRIA, Keio), All Rights Reserved.
Editor: Masayasu Ishikawa (
[email protected])
Revision: $Id: Overview.html,v 1.5 2018/10/09 13:23:57 denis Exp $
Permission to use, copy, modify and distribute the HLink RELAX NG
schema and its accompanying documentation for any purpose and
without fee is hereby granted in perpetuity, provided that
the above copyright notice and this paragraph appear in all copies.
The copyright holders make no representation about the suitability
of this RELAX NG schema for any purpose.
It is provided "as is" without expressed or implied warranty.
Revisions:
(none)
</a:documentation>
<a:documentation>
HLink
hlinks, hlink
This HLink RELAX NG schema declares elements and attributes defining
HLink, a link recongnition mechanism for the XHTML Family.
</a:documentation>
<a:documentation>
Datatypes
defines containers for the following datatypes, many of
these imported from other specifications and standards.
</a:documentation>
<define name="AttName">
<a:documentation>
the name of an attribute which begins with "@", a la @name
</a:documentation>
<data type="string">
<param name="pattern">@\c+</param>
</data>
</define>
<define name="ContentType">
<a:documentation>
media type, as per [RFC2045]
</a:documentation>
<text/>
</define>
<define name="Coords">
<a:documentation>
comma separated list of coordinates to use in defining areas
</a:documentation>
<data type="string">
<param name="pattern"
>[-+]?(\d+|\d+(\.\d+)?%)(,\s*[-+]?(\d+|\d+(\.\d+)?%))*</param>
</data>
</define>
<define name="LinkTypes">
<a:documentation>
space-separated list of link types
</a:documentation>
<data type="NMTOKENS"/>
</define>
<define name="Shape">
<a:documentation>
the shape of a region
</a:documentation>
<choice>
<value>default</value>
<value>rect</value>
<value>circle</value>
<value>poly</value>
</choice>
</define>
<define name="URI">
<a:documentation>
a Uniform Resource Identifier reference, as per anyURI in
XML Schema Part 2 [SCHEMA]
</a:documentation>
<data type="anyURI"/>
</define>
<define name="hlinks">
<a:documentation>
hlinks element
</a:documentation>
<element name="hlinks">
<oneOrMore>
<ref name="hlink"/>
</oneOrMore>
</element>
</define>
<define name="hlink">
<a:documentation>
hlink element
</a:documentation>
<element name="hlink">
<ref name="hlink.attlist"/>
</element>
</define>
<define name="hlink.attlist">
<attribute name="namespace">
<ref name="URI"/>
</attribute>
<optional>
<attribute name="element">
<data type="NMTOKEN"/>
</attribute>
</optional>
<optional>
<attribute name="locator">
<choice>
<ref name="URI"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="effect" a:defaultValue="replace">
<choice>
<value>new</value>
<value>replace</value>
<value>embed</value>
<value>submit</value>
<value>map</value>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="actuate" a:defaultValue="onRequest">
<choice>
<value>onLoad</value>
<value>onRequest</value>
<value>onRequestSecondary</value>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="replacement"/>
</optional>
<optional>
<attribute name="role">
<choice>
<ref name="LinkTypes"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="reverseRole">
<choice>
<ref name="LinkTypes"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="shape" a:defaultValue="default">
<choice>
<ref name="Shape"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="coords">
<choice>
<ref name="Shape"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="arcrole">
<choice>
<ref name="URI"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="label"/>
</optional>
<optional>
<attribute name="from"/>
</optional>
<optional>
<attribute name="to"/>
</optional>
<optional>
<attribute name="contentType">
<choice>
<ref name="ContentType"/>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="onSuccess" a:defaultValue="ignoreChildren">
<choice>
<value>processChildren</value>
<value>ignoreChildren</value>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
<optional>
<attribute name="onFailure" a:defaultValue="warn">
<choice>
<value>processChildren</value>
<value>ignoreChildren</value>
<value>warn</value>
<value>fail</value>
<ref name="AttName"/>
</choice>
</attribute>
</optional>
</define>
</grammar></pre>
<h3>
A.3. XML
Schema Implementation</h3>
<pre class="xsd"><?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.w3.org/2002/06/hlink"
xmlns="http://www.w3.org/2002/06/hlink"
elementFormDefault="qualified">
<xs:annotation>
<xs:documentation>
HLink in XML Schema
URI: http://www.w3.org/2002/06/hlink.xsd
This is HLink - a link recongnition mechanism for the XHTML Family.
Copyright ©2002 W3C (MIT, INRIA, Keio), All Rights Reserved.
Editor: Masayasu Ishikawa (
[email protected])
Revision: $Id: Overview.html,v 1.5 2018/10/09 13:23:57 denis Exp $
Permission to use, copy, modify and distribute the HLink XML Schema
and its accompanying documentation for any purpose and without fee
is hereby granted in perpetuity, provided that the above copyright
notice and this paragraph appear in all copies.
The copyright holders make no representation about the suitability
of this XML Schema for any purpose.
It is provided "as is" without expressed or implied warranty.
Revisions:
(none)
</xs:documentation>
</xs:annotation>
<xs:annotation>
<xs:documentation>
HLink
hlinks, hlink
This HLink XML Schema declares elements and attributes defining
HLink, a link recongnition mechanism for the XHTML Family.
</xs:documentation>
</xs:annotation>
<xs:annotation>
<xs:documentation>
Datatypes
defines containers for the following datatypes, many of
these imported from other specifications and standards.
</xs:documentation>
</xs:annotation>
<xs:simpleType name="AttName">
<xs:annotation>
<xs:documentation>
the name of an attribute which begins with "@", a la @name
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="@\c+"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ContentType">
<xs:annotation>
<xs:documentation>
media type, as per [RFC2045]
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string"/>
</xs:simpleType>
<xs:simpleType name="Coords">
<xs:annotation>
<xs:documentation>
comma separated list of lengths
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern
value="[-+]?(\d+|\d+(\.\d+)?%)(,\s*[-+]?(\d+|\d+(\.\d+)?%))*"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="LinkTypes">
<xs:annotation>
<xs:documentation>
space-separated list of link types
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:NMTOKENS"/>
</xs:simpleType>
<xs:simpleType name="Shape">
<xs:restriction base="xs:token">
<xs:enumeration value="default"/>
<xs:enumeration value="rect"/>
<xs:enumeration value="circle"/>
<xs:enumeration value="poly"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="URI">
<xs:annotation>
<xs:documentation>
a Uniform Resource Identifier reference, as per anyURI in
XML Schema Part 2 [SCHEMA]
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:anyURI"/>
</xs:simpleType>
<xs:simpleType name="Effect">
<xs:restriction base="xs:token">
<xs:enumeration value="new"/>
<xs:enumeration value="replace"/>
<xs:enumeration value="embed"/>
<xs:enumeration value="submit"/>
<xs:enumeration value="map"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Actuate">
<xs:restriction base="xs:token">
<xs:enumeration value="onLoad"/>
<xs:enumeration value="onRequest"/>
<xs:enumeration value="onRequestSecondary"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="OnSuccess">
<xs:restriction base="xs:token">
<xs:enumeration value="processChildren"/>
<xs:enumeration value="ignoreChildren"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="OnFailure">
<xs:restriction base="xs:token">
<xs:enumeration value="processChildren"/>
<xs:enumeration value="ignoreChildren"/>
<xs:enumeration value="warn"/>
<xs:enumeration value="fail"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="hlinks">
<xs:annotation>
<xs:documentation>
hlinks element
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" ref="hlink"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="hlink">
<xs:annotation>
<xs:documentation>
hlink element
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attributeGroup ref="hlink.attlist"/>
</xs:complexType>
</xs:element>
<xs:attributeGroup name="hlink.attlist">
<xs:attribute name="namespace" use="required" type="URI"/>
<xs:attribute name="element" type="xs:NMTOKEN"/>
<xs:attribute name="locator">
<xs:simpleType>
<xs:union memberTypes="URI AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="effect" default="replace">
<xs:simpleType>
<xs:union memberTypes="Effect AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="actuate" default="onRequest">
<xs:simpleType>
<xs:union memberTypes="Actuate AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="replacement"/>
<xs:attribute name="role">
<xs:simpleType>
<xs:union memberTypes="LinkTypes AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="reverseRole">
<xs:simpleType>
<xs:union memberTypes="LinkTypes AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="shape" default="default">
<xs:simpleType>
<xs:union memberTypes="Shape AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="coords">
<xs:simpleType>
<xs:union memberTypes="Coords AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="arcrole">
<xs:simpleType>
<xs:union memberTypes="URI AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="label"/>
<xs:attribute name="from"/>
<xs:attribute name="to"/>
<xs:attribute name="contentType">
<xs:simpleType>
<xs:union memberTypes="ContentType AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="onSuccess" default="ignoreChildren">
<xs:simpleType>
<xs:union memberTypes="OnSuccess AttName"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="onFailure" default="warn">
<xs:simpleType>
<xs:union memberTypes="OnFailure AttName"/>
</xs:simpleType>
</xs:attribute>
</xs:attributeGroup>
</xs:schema></pre>
<h2>
B. References</h2>
<p>This appendix is
normative.</p>
<h3>
B.1. Normative References</h3>
<dl>
<dt>[
XLINK]</dt>
<dd>"<cite>
XML
Linking Language (XLink)</cite>", W3C Recommendation, S. DeRose
<span xml:lang="lt" lang="lt">et al.</span> (editors), 27 June 2001.
Available at: http://www.w3.org/TR/2001/REC-xlink-20010627<br />
The
latest version is
available at: http://www.w3.org/TR/xlink</dd>
<dt>[
URI]</dt>
<dd>"<cite>
Uniform
Resource Identifiers (URI): Generic Syntax</cite>" (RFC 2396), T.
Berners-Lee <span xml:lang="lt" lang="lt">et al.</span>, August 1998.
Available at: http://www.rfc-editor.org/rfc/rfc2396.txt</dd>
<dt>[
XML]</dt>
<dd>"<cite>
Extensible Markup
Language (XML) 1.0 Specification (Second Edition)</cite>", W3C
Recommendation, T. Bray <span xml:lang="lt" lang="lt">et al.</span>
(editors), 6 October 2000. Available at:
http://www.w3.org/TR/2000/REC-xml-20001006<br />
The
latest version is
available at: http://www.w3.org/TR/REC-xml</dd>
<dt>[
NAME]</dt>
<dd>"<cite>
Namespaces in
XML</cite>", W3C Recommendation, T. Bray <span xml:lang="lt"
lang="lt">et al.</span> (editors), 14 January 1999. Available at:
http://www.w3.org/TR/1999/REC-xml-names-19990114<br />
The
latest version is
available at: http://www.w3.org/TR/REC-xml-names</dd>
<dt>[
SCHEMA]</dt>
<dd>"<cite>
XML Schema
Part 2: Datatypes</cite>", W3C Recommendation, P. V. Biron <span
xml:lang="lt" lang="lt">et al.</span> (editors), 2 May 2001. Available
at: http://www.w3.org/TR/2001/REC-xmlschema-2-20010502<br />
The
latest version is
available at: http://www.w3.org/TR/xmlschema-2</dd>
</dl>
<h3>
B.2. Other References</h3>
<dl>
<dt>[
HTML4]</dt>
<dd>"<cite>
HTML
4.01 Specification</cite>", W3C Recommendation, D. Raggett <span
xml:lang="lt" lang="lt">et al.</span> (editors), 24 December 1999.
Available at: http://www.w3.org/TR/1999/REC-html401-19991224<br />
The
latest version of HTML
4.01 is available at: http://www.w3.org/TR/html401<br />
The
latest version of HTML 4
is available at: http://www.w3.org/TR/html4</dd>
<dt>[
XHTML]</dt>
<dd>"<cite>
XHTML™ 1.0 The
Extensible HyperText Markup Language (Second Edition): A Reformulation
of HTML 4 in XML 1.0</cite>", W3C Recommendation, S. Pemberton
<span xml:lang="lt" lang="lt">et al.</span>, August 2002. Available at:
http://www.w3.org/TR/2002/REC-xhtml1-20020801<br />
The
latest version is
available at: http://www.w3.org/TR/xhtml1</dd>
<dt>[
XHTMLMOD]</dt>
<dd>"<cite>
Modularization
of XHTML™</cite>", W3C Recommendation, M. Altheim, <span
xml:lang="lt" lang="lt">et al.</span> (editors), 10 April 2001.
Available at:
http://www.w3.org/TR/2001/REC-xhtml-modularization-20010410<br />
The
latest
version is at: http://www.w3.org/TR/xhtml-modularization</dd>
</dl>
<h2>
C. Acknowledgments</h2>
<p>
This section is informative.</p>
<p>This document was prepared by
the
W3C
XHTML2 Working Group.
The members at the time of publication of the Note were:</p>
- Markus Gylling, DAISY Consortium
(XHTML 2 Working Group Co-Chair)
- Steven Pemberton, CWI
(XHTML 2 Working Group Co-Chair)
- Mark Birbeck, Sidewinder Labs (Invited Expert)
- Susan Borgrink, Progeny Systems
- Christina Bottomley, Society for Technical Communication (STC)
- Alessio Cartocci, International Webmasters Association / HTML Writers Guild (IWA-HWG)
- Alexander Graf, University of Innsbruck
- Tina Holmboe, Greytower Technologies (Invited Expert)
- John Kugelman, Progeny Systems
- Luca Mascaro, International Webmasters Association / HTML Writers Guild (IWA-HWG)
- Shane McCarron, Applied Testing and Technology, Inc. (Invited Expert)
- Michael Rawling, IVIS Group Limited
- Gregory Rosmaita, Invited Expert
- Sebastian Schnitzenbaumer, Dreamlab Technologies AG
- Richard Schwerdtfeger,
IBM
- Elias Torres,
IBM
- Masataka Yakura, Mitsue-Links Co., Ltd.
- Toshihiko Yamakami, ACCESS Co., Ltd.
<script type="application/javascript" src="https://www.w3.org/scripts/TR/fixup.js"></script></body>
</html>