You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2396 lines
186 KiB
2396 lines
186 KiB
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
|
<head>
|
|
<title>Protocol for Web Description Resources (POWDER): Description Resources</title>
|
|
<style type="text/css">
|
|
li, dt, dd {margin-top: 1em;}
|
|
ul, ol, dl {margin-top: 1em; margin-bottom: 1em;}
|
|
ol ol {list-style-type: lower-alpha}
|
|
ol ol ol {list-style-type: lower-roman}
|
|
.comment {margin-left: 2em; font-style: italic;}
|
|
.example {padding: 0.5em; background-color: rgb(204, 255, 204); border:thin dotted black; white-space:nowrap; overflow:auto}
|
|
.oq {border-style: dotted; border-width: 1px; background-color:#ccffcc; padding:1em}
|
|
table.vocab {margin: 0 auto; border-collapse:collapse; border:thin solid black}
|
|
td, th {border:thin solid black; padding:0.5em}
|
|
caption {caption-side:bottom; padding-top:1em; margin:0 auto}
|
|
p.caption {font-weight:bold}
|
|
.toc1 {padding:0 0 0.5em 0}
|
|
.toc2 {padding:0 0 0.5em 1em}
|
|
.toc3 {padding:0 0 0.5em 2em}
|
|
.semext {padding: 0.5em; background-color:#cccccc; border:thin dotted black;}
|
|
</style>
|
|
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-REC.css"/>
|
|
<!-- <link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-WD"/> -->
|
|
|
|
</head>
|
|
<body>
|
|
<div class="head">
|
|
<a href="http://www.w3.org/"><img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/></a>
|
|
<h1>Protocol for Web Description Resources (POWDER): Description Resources</h1>
|
|
<h2>W3C Recommendation 1 September 2009</h2>
|
|
<dl>
|
|
<dt>This version</dt><dd><a href="http://www.w3.org/TR/2009/REC-powder-dr-20090901/">http://www.w3.org/TR/2009/REC-powder-dr-20090901/</a></dd>
|
|
<dt>Latest version</dt><dd><a href="http://www.w3.org/TR/powder-dr/">http://www.w3.org/TR/powder-dr/</a></dd>
|
|
<dt>Previous version</dt><dd><a href="http://www.w3.org/TR/2009/PR-powder-dr-20090604/">http://www.w3.org/TR/2009/PR-powder-dr-20090604/</a></dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>Editors:</dt>
|
|
<dd>Phil Archer, Institute of Informatics & Telecommunications (IIT), NCSR "Demokritos" (formerly with FOSI)</dd>
|
|
<dd>Kevin Smith, Vodafone Group R & D</dd>
|
|
<dd>Andrea Perego, Università degli Studi dell'Insubria</dd>
|
|
</dl>
|
|
|
|
<p>Please refer to the <a href="http://www.w3.org/2007/powder/powder-errata"><strong>errata</strong></a> for this document, which may include some normative corrections.</p>
|
|
|
|
<p>See also <a href=" http://www.w3.org/2003/03/Translations/byTechnology?technology=powder-dr"> <strong>translations</strong></a>.</p>
|
|
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2009 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>, <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>
|
|
<hr />
|
|
</div>
|
|
|
|
<h2 id="abstract">Abstract</h2>
|
|
<p>The purpose of the Protocol for Web Description Resources (POWDER) is to provide a means for individuals or organizations to describe a group of resources through the publication of machine-readable metadata, as motivated by the POWDER Use Cases <a href="#usecases">[USECASES]</a>. This document details the creation and lifecycle of Description Resources (DRs), which encapsulate such metadata. These are typically represented in a highly constrained XML dialect that is relatively human-readable. The meaning of such DRs are underpinned by formal semantics, accessible by performing a GRDDL Transform.</p>
|
|
|
|
<h2 id="status">Status of this document</h2>
|
|
<p><em>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 <a href="http://www.w3.org/TR/" shape="rect">W3C technical reports index</a> at http://www.w3.org/TR/.</em></p>
|
|
|
|
<p>This document is a W3C Recommendation that was developed by the <a href="http://www.w3.org/2007/powder/" shape="rect">POWDER Working Group</a>.</p>
|
|
|
|
|
|
<p>Please see the Working Group's <a href="http://www.w3.org/2007/powder/Group/features.html">implementation report</a>
|
|
and <a href="http://lists.w3.org/Archives/Public/public-powderwg/2009Apr/0015.html">Disposition of Last Call Comments</a>.
|
|
The disposition of comments received during previous calls are also <a href="http://lists.w3.org/Archives/Public/public-powderwg/2009Feb/0006.html">available</a>.
|
|
Changes since the <a href="http://www.w3.org/TR/2009/PR-powder-dr-20090604/">previous version</a> of this document are minor in nature and are fully documented in the <a href="#sincePR">Change log</a>.</p>
|
|
|
|
<p>Publication of this Recommendation is synchronized with several other documents:</p>
|
|
<ul>
|
|
<li><a href="http://www.w3.org/TR/2009/REC-powder-grouping-20090901/">POWDER: Grouping of Resources</a> (Recommendation)</li>
|
|
<li><a href="http://www.w3.org/TR/2009/REC-powder-formal-20090901/">POWDER: Formal Semantics</a> (Recommendation)</li>
|
|
<li><a href="http://www.w3.org/TR/2009/NOTE-powder-primer-20090901/">POWDER: Primer</a> (Working Group Note)</li>
|
|
<li><a href="http://www.w3.org/TR/2009/NOTE-powder-test-20090604/">POWDER: Test Suite</a> (Working Group Note)</li>
|
|
</ul>
|
|
|
|
<p>The W3C Membership and other interested parties are invited to review
|
|
the document and send comments to <a href="mailto:public-powderwg@w3.org">public-powderwg@w3.org</a> (with <a href="http://lists.w3.org/Archives/Public/public-powderwg/" shape="rect">public archive</a>).</p>
|
|
|
|
<p>This document has been reviewed by W3C Members, by software developers, and by other W3C groups and interested parties, and is endorsed by the Director as a W3C Recommendation. It is a stable document and may be used as reference material or cited from another document. W3C's role in making the Recommendation is to draw attention to the specification and to promote its widespread deployment. This enhances the functionality and interoperability of the Web.</p>
|
|
|
|
<p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent Policy</a>. W3C maintains a <a rel="disclosure" href="http://www.w3.org/2004/01/pp-impl/40243/status">public list of any patent disclosures</a> 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 <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>. </p>
|
|
|
|
<h2 id="toc">Table of Contents</h2>
|
|
<div class="toc1">1 <a href="#intro">Introduction</a></div>
|
|
<div class="toc2">1.1 <a href="#opAndForm">Operational and Formal Semantics</a></div>
|
|
<div class="toc2">1.2 <a href="#namespaces">Namespaces and Terminology</a></div>
|
|
<div class="toc1">2 <a href="#structure">POWDER Structure and Semantics</a></div>
|
|
<div class="toc2">2.1 <a href="#operational">Operational Semantics</a></div>
|
|
<div class="toc2">2.2 <a href="#formalSemantics">Formal Semantics: POWDER-S</a></div>
|
|
<div class="toc2">2.3 <a href="#olDR">Exclusive Description Resources</a></div>
|
|
<div class="toc2">2.4 <a href="#multiIRIsets">DRs with Multiple IRI Sets</a></div>
|
|
<div class="toc2">2.5 <a href="#directDescript">Direct Resource Description</a></div>
|
|
<div class="toc2">2.6 <a href="#preDefinedDescriptors">Pre-Defined Descriptors</a></div>
|
|
<div class="toc2">2.7 <a href="#tags">Free Text Tags, Comments, Labels and "See Also"</a></div>
|
|
<div class="toc2">2.8 <a href="#multiDesc">Multiple Descriptor Sets and POWDER Flexibility</a></div>
|
|
<div class="toc2">2.8 <a href="#flexibility">POWDER Flexibility</a></div>
|
|
<div class="toc3">2.8.1 <a href="#multiDesc">Multiple Descriptor Sets</a></div>
|
|
<div class="toc3">2.8.2 <a href="#xmldata">XML Data in POWDER</a></div>
|
|
<div class="toc3">2.8.3 <a href="#extensibility">Extensibility</a></div>
|
|
<div class="toc3">2.8.4 <a href="#localization">Localization</a></div>
|
|
<div class="toc2">2.9 <a href="#powderconformance">Conformance Statement: POWDER and POWDER-S Documents</a></div>
|
|
<div class="toc1">3 <a href="#powderprocessor">The POWDER Processor</a></div>
|
|
<div class="toc2">3.1 <a href="#ppErrorhandling"> Error Handling</a></div>
|
|
<div class="toc2">3.2 <a href="#conformance">POWDER Processor Conformance Statement</a></div>
|
|
<div class="toc1">4 <a href="#assoc">Associating Resources and DRs</a></div>
|
|
<div class="toc2">4.1 <a href="#assoc-linking">Linking a Resource to a POWDER Document</a></div>
|
|
<div class="toc3">4.1.1 <a href="#assoc-markup">(X)HTML <code>link</code> Elements</a></div>
|
|
<div class="toc3">4.1.2 <a href="#atom">ATOM <code>link</code> Elements</a></div>
|
|
<div class="toc3">4.1.3 <a href="#httplink">HTTP Link Headers</a> (Informative)</div>
|
|
<div class="toc3">4.1.4 <a href="#semlink">Semantic Linkage Using the <code>describedby</code> Property</a></div>
|
|
<div class="toc2">4.2 <a href="#linktopp">Linking a Resource to a POWDER Processor to Acquire RDF</a></div>
|
|
<div class="toc2">4.3 <a href="#linkingDRdocs">Linking POWDER documents</a></div>
|
|
<div class="toc2">4.4 <a href="#DRfromRepository">Requesting a DR from a Repository</a></div>
|
|
<div class="toc1">5 <a href="#trust">Trust</a></div>
|
|
<div class="toc2">5.1 <a href="#discover">Discovering the Trust Mechanism: the <code>authenticate</code> Property</a></div>
|
|
<div class="toc2">5.2 <a href="#certification">Certification using POWDER</a></div>
|
|
<div class="toc3">5.2.1 <a href="#interpretCert">Full Interpretation of Example 5-1</a></div>
|
|
<div class="toc2">5.3 <a href="#evidence">Supporting Evidence: The <code>supportedby</code> Property</a></div>
|
|
<div class="toc2">5.4 <a href="#trustedHost">Trusted Source</a></div>
|
|
<div class="toc2">5.5 <a href="#machineLearn">Machine Learning</a></div>
|
|
<div class="toc2">5.6 <a href="#trustsummary">Trust Summary</a></div>
|
|
<div class="toc1">6 <a href="#references">References</a></div>
|
|
<div class="toc2">6.1 <a href="#normRefs">Normative References</a></div>
|
|
<div class="toc2">6.2 <a href="#infoRefs">Informative References</a></div>
|
|
<div class="toc1">7 <a href="#ack">Acknowledgements</a></div>
|
|
<div class="toc1">8 <a href="#change">Change Log</a></div>
|
|
<div class="toc1">Appendix A <a href="#appA">POWDER Elements & Properties Defined in this Document</a></div>
|
|
<div class="toc2">A.1 <a href="#xmlElements">XML Elements</a></div>
|
|
<div class="toc2">A.2 <a href="#rdfProperties">RDF/OWL Classes and Properties</a></div>
|
|
<div class="toc1">Appendix B <a href="#appB">POWDER Internet Media Type and Macintosh File Type</a></div>
|
|
<div class="toc1">Appendix C <a href="#appC">POWDER-S Internet Media Type and Macintosh File Type</a></div>
|
|
<div class="toc1">Appendix D <a href="#appD">describedby Link Relationship</a></div>
|
|
|
|
<h2 id="intro">1 Introduction</h2>
|
|
<p>The Protocol for Web Description Resources (POWDER) facilitates the publication of descriptions of multiple resources such as all those available from a Web site. These descriptions are always attributed to a named individual, organization or entity that may or may not be the creator of the described resources. This contrasts with more usual metadata that typically applies to a single resource, such as a specific document's title, which is usually provided by its author.</p>
|
|
<p>This document sets out how Description Resources (DRs) can be created and published, how to link to DRs from other online resources, and, crucially, how DRs may be authenticated and trusted. The aim is to provide a platform through which opinions, claims and assertions about online resources can be expressed by people and exchanged by machines. POWDER has evolved from the data model developed for the final report [<a href="#xgr">XGR</a>] of the Web Content Label Incubator Group [<a href="#wclxg">WCL-XG</a>], from which we define a Description Resource as: "a resource that contains a description, a definition of the scope of the description and assertions about both the circumstances of its own creation and the entity that created it."</p>
|
|
<p>The next section introduces the division between the operational semantics of POWDER (designed to be easy and practical to use in everyday situations) and the more formal semantics (designed to make POWDER available on the broader Semantic Web). This division means that there are several components to the Protocol for Web Description Resources which in turn leads to there being several documents in the set.</p>
|
|
<p>The method of defining the scope of a DR, that is, defining what is being described, is provided in Grouping of Resources [<a href="#group">GROUP</a>]. The layered semantics of POWDER is defined in a Formal Semantics document [<a href="#formal">FORMAL</a>]. It is hoped that the provision of those documents allows the present one to give a clearer, more concise definition of the structure and use of Description Resources. The full set of POWDER documents also includes its <a href="#usecases">Use Cases</a>, <a href="#primer">Primer</a> and <a href="#testsuite">Test Suite</a>, together with the namespace documents [<a href="#wdr">WDR</a>, <a href="#wdrs">WDRS</a> <span id="noGRDDLdoc"> and <a href="#wdrd">WDRD</a>].</span></p>
|
|
<p>POWDER takes a very broad approach so that it is possible for both the resource creator and third parties to make assertions about all kinds of things, with no architectural limits on what they are making claims about. For example, medically proficient organizations might be concerned with properties of the agencies and processes that produce Web content (e.g. companies, people, and their credentials). Equally, a 'Mobile Web' application might need to determine the properties of various devices, such as their screen dimensions, and those device types might be described with such properties by their manufacturer or by others. Although the broad approach is supported, we have focused on Web resources rather than trying to define a universal labelling system for objects. In practice, POWDER associates a description with one or more IRIs [<a href="#iri">IRI</a>] that must then be interpreted as being descriptions of the resources dereferenced from those IRIs.</p>
|
|
<p>Trust is a central theme of POWDER; however, we do not prescribe a single method through which trust must be conferred on Description Resources. By its very nature, trust is a human judgment that can only be made by weighing the likelihood that the data is true against the consequences of it being false. This judgment is highly dependant on the circumstances under which the need to extend trust arises. POWDER does, however, provide support for, and is amenable to, a variety of methods through which users and user agents can establish trust.</p>
|
|
<p>Reference is made throughout this document to <a name="powder-doc"><em>POWDER documents</em></a>. Unless otherwise stated, these are XML documents that have their root element in the POWDER namespace. A <em>POWDER processor</em> is software that can process POWDER documents, the minimum specification for which is set out in <a href="#powderprocessor">Section 3</a>.</p>
|
|
|
|
<h3 id="opAndForm">1.1 Operational and Formal Semantics</h3>
|
|
<p>The Protocol for Web Description Resources has been designed with a variety of content production workflows in mind. It offers a practical contribution to such areas as content discovery, personalization and access control; one that can be implemented readily by non-specialists. There is, however, a tension between this operational approach and the broader goal of making the data available in a format that can be processed on the Semantic Web. By making data from potentially disparate sources interoperable, and by enabling machines to process the meaning of that data, the Semantic Web offers exciting possibilities in precisely the areas of interest to POWDER.</p>
|
|
<p>The tension between what can be processed by humans and what can be processed by machines is resolved by defining both operational and formal semantics of Description Resources, and by bridging much of the gap between the two by way of a <a href="#grddl">GRDDL</a> transform that is associated with the root POWDER namespace. POWDER documents are written in a highly constrained dialect of XML that may also include RDF/XML constructs within some elements. Such documents may be processed directly in specialized systems; however, for more general environments, it is appropriate to perform the GRDDL transform to render the data as syntactically valid RDF/OWL (see <a href="#formalSemantics">Section 2.2</a> below). The semantics of such documents, known as POWDER-S documents, are defined in a companion Formal Semantics document [<a href="#formal">FORMAL</a>]. <span id="paf1">This defines the GRDDL transform from POWDER to POWDER-S and includes a </span><strong>Semantic Extension</strong> to RDF that must be understood if the OWL data is to be processed effectively.</p>
|
|
|
|
<h3 id="namespaces">1.2 Namespaces and Terminology.</h3>
|
|
<p>The POWDER vocabulary namespace is <code>http://www.w3.org/2007/05/powder#</code> for which we use the prefix <code>wdr</code>. The POWDER-S namespace is <code>http://www.w3.org/2007/05/powder-s#</code> for which we use the prefix <code>wdrs</code>. All prefixes used in this document, together with their associated namespaces, are shown in the table below.</p>
|
|
<table id="table1" style="border-collapse:collapse">
|
|
<tr><th>Prefix</th><th>Namespace</th></tr>
|
|
<tr><td style="padding:1em 0.5em"><code>wdr</code></td><td><code>http://www.w3.org/2007/05/powder#</code></td></tr>
|
|
<tr><td style="padding:1em 0.5em"><code>wdrs</code></td><td><code>http://www.w3.org/2007/05/powder-s#</code></td></tr>
|
|
<tr><td><code>rdf</code></td><td><code>http://www.w3.org/1999/02/22-rdf-syntax-ns#</code></td></tr>
|
|
<tr><td><code>rdfs</code></td><td><code>http://www.w3.org/2000/01/rdf-schema#"</code></td></tr>
|
|
<tr><td><code>owl</code></td><td><code>http://www.w3.org/2002/07/owl#</code></td></tr>
|
|
<tr><td><code>foaf</code></td><td><code>http://xmlns.com/foaf/0.1/</code></td></tr>
|
|
<tr><td><code>dcterms</code></td><td><code>http://purl.org/dc/terms/</code></td></tr>
|
|
<tr><td><code>xsd</code></td><td><code><span id="ns_typo">http://www.w3.org/2001/XMLSchema</span></code></td></tr>
|
|
<tr><td><code>ex</code></td><td>An arbitrary prefix used to denote an 'example vocabulary' <span id="pa6">from the <code>example.org</code> domain.</span></td></tr>
|
|
</table>
|
|
<p>In this document, the words MUST, MUST NOT, SHOULD, SHOULD NOT, <span id="recommended">RECOMMENDED</span> and MAY are to be interpreted as described in <a href="#ref-rfc2119">RFC2119</a>.</p>
|
|
<p id="whitespace">POWDER makes substantial use of XML, the processing rules for which MUST be followed faithfully. The processing rules for
|
|
<a href="http://www.w3.org/TR/REC-xml/#AVNormalize">attribute-value normalization</a> are particularly relevant when considering the white space
|
|
separated lists of values that occur in POWDER. A space-separated list is a string of which the items are separated by one or more space characters (in
|
|
any order). The string may also be prefixed or suffixed with zero or more of those characters. To obtain the values from a space-separated list user
|
|
agents MUST replace any sequence of space characters with a single #x20 character, dropping any leading or trailing #x20 character, and then
|
|
chopping the resulting string at each occurrence of a #x20 character, dropping that character in the process.</p>
|
|
<p>The (unqualified) terms POWDER, POWDER Document and Description Resource (DR) refer to operational representations that are encoded largely in XML. The term POWDER-S refers to RDF/OWL representations, the full semantics of which are expressed when account is taken of the extension defined in the Formal Semantics document [<a href="#formal">FORMAL</a>].</p>
|
|
|
|
<h2 id="structure">2 POWDER Structure and Semantics</h2>
|
|
<h3 id="operational">2.1 Operational Semantics</h3>
|
|
<p>The following natural language statement:</p>
|
|
<blockquote id="exampleStatement" style="font-style: italic;">
|
|
<p>On 14th December 2007, the entity described at http://authority.example.org/company.rdf#me said that everything on example.com is red and square.</p>
|
|
</blockquote>
|
|
<p>is encoded in POWDER as shown in the example below, which in turn is followed by explanatory notes.</p>
|
|
<div class="example" id="eg2-1">
|
|
<p class="caption">Example 2-1: Generic Example of a POWDER Document Containing a Single Description Resource [<a href="dr-example_2_01.xml">XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
1 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
xmlns:ex="http://example.org/vocab#">
|
|
|
|
2 <attribution>
|
|
3 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
4 <issued>2007-12-14T00:00:00</issued>
|
|
5 </attribution>
|
|
|
|
6 <dr>
|
|
7 <iriset>
|
|
8 <includehosts>example.com</includehosts>
|
|
9 </iriset>
|
|
|
|
10 <descriptorset>
|
|
11 <ex:color>red</ex:color>
|
|
12 <ex:shape>square</ex:shape>
|
|
13 <displaytext>Everything on example.com is red and square</displaytext>
|
|
14 <displayicon src="http://authority.example.org/icon.png" />
|
|
15 </descriptorset>
|
|
16 </dr>
|
|
|
|
17 </powder></pre>
|
|
</div>
|
|
<p>Explanation:</p>
|
|
<dl>
|
|
<dt>Line 1</dt>
|
|
<dd>All POWDER documents have the root element of <a href="#powder"><code>powder</code></a>. The <code>ex</code> namespace is used to exemplify a descriptive vocabulary and is fictitious.</dd>
|
|
<dt>Lines 2 - 5</dt>
|
|
<dd>
|
|
<p>All POWDER documents MUST have exactly one <a href="#attribution"><code>attribution</code></a> element. This contains, or points to, information about who has provided the description and typically will also include information about when it was created and any validity period. The GRDDL transform renders the <code>attribution</code> element as an OWL ontology header [<a href="#owl">OWL</a>] and each child element of <code>attribution</code> is therefore transformed into an <code>owl:AnnotationProperty</code> as discussed below. The exception to this is the <code>abouthosts</code> element which is introduced in <a href="#olDR">Section 2.3</a>.</p>
|
|
</dd>
|
|
<dt id="line3">Line 3</dt>
|
|
<dd>
|
|
<p>Exactly one <a href="#issuedby"><code>issuedby</code></a> element MUST be included and it <span id="noInlineFOAF1">MUST use the <code>src</code> attribute</span> to point to an RDF resource that describes the entity that created the POWDER document. It is RECOMMENDED that this be done using an instance of the Agent class from either the <a href="#foaf">FOAF</a> or <a href="#dc">Dublin Core</a> vocabularies.</p>
|
|
</dd>
|
|
<dt id="line4">Line 4</dt>
|
|
<dd>
|
|
<p>The <a href="#issued"><code>issued</code></a> element within the attribution element is optional and <span id="issuedMap">is
|
|
simply mapped to <a href="#issued-s"><code>wdrs:issued</code></a> by the GRDDL transform</span>.
|
|
Likewise the <code>validfrom</code> and <code>validuntil</code> elements discussed in <a href="#certification">Section 5.2</a>
|
|
may be included in the attribution element and <span id="dateformat">the dates and times given SHOULD</span> be <span id="dc2">conformant with
|
|
the <a href="#xmldatetime">XML dateTime</a> datatype</span>. Arbitrary OWL annotation properties that describe the POWDER document may also be included.</p>
|
|
|
|
</dd>
|
|
<dt id="lines6-16">Lines 6 - 16</dt>
|
|
<dd>
|
|
<p>This particular POWDER document contains a single Description Resource (<a href="#dr"><code>dr</code></a>).</p>
|
|
</dd>
|
|
<dt id="lines7-9">Lines 7 - 9</dt>
|
|
<dd>
|
|
<p>The scope of the DR — i.e. what is described — is defined as set out in the Grouping of Resources document [<a href="#group">GROUP</a>]. In this case, the scope is <span id="comNotOrg">'everything on example.com'</span>. All Description Resources MUST contain at least one <a href="#iriset"><code>iriset</code></a> element and, as described in the Grouping document, this MUST NOT be empty and MUST NOT contain any elements from any other namespace. If more than one <code>iriset</code> element is included then the scope of the DR is the union of the resources identified by the IRIs in all sets.</p>
|
|
</dd>
|
|
<dt id="lines10-15">Lines 10 - 15</dt>
|
|
<dd id="err2">
|
|
<p>The description itself. A DR MUST contain at least one <a href="#descriptorset"><code>descriptorset</code></a> element (and/or <code>tagset</code> see <a href="#tags">Section 2.7</a>) that MUST NOT be empty and MAY contain RDF/XML that describes the IRIs in the IRI set. Since the subject of the triples is not explicit and is only accessed through processing, <span id="arbitRDF">there are limitations on the RDF that can safely be included</span>, specifically, only RDF properties that take literals (including XML Literals) or values for the <code>rdf:resource</code> attribute so long as this does not point to a blank node. Other RDF/XML constructs, particularly blank nodes, MUST NOT be included. <a href="#multiDesc">Section 2.8</a> shows how to assert the <code>rdf:type</code> relationship. The Formal Semantics document [<a href="#formal">FORMAL</a>] provides full details (and warnings) concerning the semantics of the descriptor set.</p>
|
|
<p id="line13">As shown in lines 13 and 14, a textual and/or graphic summary that can be displayed to
|
|
end users may be included using <a href="#displaytext"><code>displaytext</code></a> and
|
|
<a href="#displayicon"><code>displayicon</code></a> respectively. The GRDDL transform maps these to
|
|
<span id="textandlogo"> <a href="#text"><code>wdrs:text</code></a> and <a href="#logo"><code>wdrs:logo</code></a> respectively.</span>
|
|
Further optional elements are introduced throughout this document and summarized in the <a href="#appA">Appendix</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
<p>Operationally, a user (or user agent) should begin the examination of a POWDER document
|
|
by considering the attribution element which, if the document is
|
|
<a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-valid">valid</a> in the XML-sense of the term, will
|
|
be present and contain an <code>issuedby</code> element. This element is mandatory as, for most people,
|
|
deciding whether to trust a given description is typically most dependent on answering the question
|
|
"who says?" If the IRI that is the value of the <code>src</code> attribute of the <code>issuedby</code>
|
|
element points to a description of a trusted <span id="noInlineFOAF2">individual or entity</span> the data provided in the remainder of the document will usually be trusted, subject to integrity-checking mechanisms such as those discussed in <a href="#trust">Section 5</a>.</p>
|
|
<p>If the user (or user agent) confers his/her trust in the document, then the remainder of the data can be processed, either in an entirely operational manner or by performing the GRDDL transform associated with the POWDER namespace and merging the resulting RDF graph (see <a href="#formalSemantics">Section 2.2</a> below).</p>
|
|
<p>Either way, example 2-1 means that the processor can be confident that any resource identified by an IRI with a host having 'example.com' as its last two components will be red and square. Conversely, an agent seeking resources that are red and square will trust example.com to provide them.</p>
|
|
<p>User agents MAY display the text and/or icon to end users in any way deemed appropriate. <span id="oneDisplay">Since a DR can contain any
|
|
number of <code>descriptorset</code> elements and therefore any number of <code>displaytext</code> and <code>displayicon</code> elements,
|
|
exactly how, or whether, these are displayed is up to the application. As a result, DR publishers are strongly advised to
|
|
include no more than one <code>displaytext</code> and <code>displayicon</code> per DR</span> <span id="xmllang">except where differentiated using <code>xml:lang</code> attributes.</span></p>
|
|
<p>A POWDER document may contain any number of DRs, each describing its own IRI set(s), each of which will be attributed to the same person or entity. Where those IRI sets overlap, the descriptions are additive. In Example 2-2 below, the opinion of <span id="noInlineFOAF3">the entity described at http://authority.example.org/company.rdf#me</span> is that everything on example.com is red; IRIs on example.com where the path starts with /foo can be dereferenced to resources that are BOTH red AND shiny.</p>
|
|
<div class="example" id="eg2-2">
|
|
<p class="caption">Example 2-2: Generic Example of a POWDER Document Containing Multiple Description Resources [<a href="example_2_2.xml">XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
1 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
2 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <span id="noInlineFOAF4"><attribution>
|
|
5 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
6 </attribution></span>
|
|
|
|
7 <dr>
|
|
8 <iriset>
|
|
9 <includehosts>example.com</includehosts>
|
|
10 </iriset>
|
|
|
|
11 <descriptorset>
|
|
12 <ex:color>red</ex:color>
|
|
13 </descriptorset>
|
|
14 </dr>
|
|
|
|
15 <dr>
|
|
16 <iriset>
|
|
17 <includehosts>example.com</includehosts>
|
|
18 <includepathstartswith>/foo</includepathstartswith>
|
|
19 </iriset>
|
|
|
|
20 <descriptorset>
|
|
21 <ex:finish rdf:resource="http://example.org/vocab#shiny" />
|
|
22 </descriptorset>
|
|
23 </dr>
|
|
|
|
24 </powder></pre>
|
|
</div>
|
|
<p>It is possible to create sets of Description Resources that are exclusive, i.e. where only one of a given list applies, as detailed in <a href="#olDR">Section 2.3</a>. Other variations on the basic POWDER model set out in the preceding examples are discussed in later sections of this document.</p>
|
|
|
|
<h3 id="formalSemantics">2.2 Formal Semantics: POWDER-S</h3>
|
|
<p>The operational semantics of POWDER, as defined above, are underpinned by more formal semantics.
|
|
A <span id="depXSLT">GRDDL Transformation</span> is associated with the POWDER namespace. When the transformation is performed on a POWDER document, a Semantic POWDER document (POWDER-S) is its output. <span id="paf2">A POWDER-S document is an OWL ontology and the attribution information in the source document is encoded as an ontology header. Both IRI sets and descriptor sets are represented as OWL classes. To complete the encoding of a DR, a sub-class relationship is then asserted between the IRI set and the descriptor set from which it can be deduced that all instances of the IRI set are also instances of the descriptor set.</span></p>
|
|
<p>The aim of POWDER-S is to make POWDER data available to more general Semantic Web tools, not to create an alternative encoding. All POWDER-S documents are syntactically valid RDF/OWL documents; however, logical inferences may only be drawn by applications that implement the semantic extension defined in the Formal Semantics document [<a href="#formal">FORMAL</a>]. That document provides full details of the transformation, which is split into two steps. In brief: the first step reformulates the IRI set definition purely in terms of regular expressions that are matched against a candidate IRI. <span id="xq">The regular expression syntax used is defined by XML schema as modified by XQuery 1.0 and
|
|
XPath 2.0 Functions and Operators [<a href="#xqxp">XQXP</a>]</span>. Other elements of the document are unaffected in this intermediate stage, which is known as POWDER-BASE. The second step transforms POWDER-BASE into POWDER-S. This document is not concerned with the intermediate step and presents only POWDER and POWDER-S examples.</p>
|
|
<div class="example" id="eg2-3">
|
|
<p class="caption">Example 2-3: Generic example of a POWDER-S Document Containing a Single Description Resource [<a href="dr-example_2_01.rdf">RDF/XML</a>]</p>
|
|
<p>This is the result of the GRDDL transform performed on example 2-1</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:ex="http://example.org/vocab#">
|
|
8
|
|
9 <owl:Ontology rdf:about="">
|
|
10 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
11 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
12 </owl:Ontology>
|
|
13
|
|
14 <owl:Class rdf:nodeID="iriset_1">
|
|
15 <owl:equivalentClass>
|
|
16 <owl:Class>
|
|
17 <owl:intersectionOf rdf:parseType="Collection">
|
|
18 <owl:Restriction>
|
|
19 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
20 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(:([0-9]+))?\/</owl:hasValue>
|
|
21 </owl:Restriction>
|
|
22 </owl:intersectionOf>
|
|
23 </owl:Class>
|
|
24 </owl:equivalentClass>
|
|
25 </owl:Class>
|
|
26
|
|
27 <owl:Class rdf:nodeID="descriptorset_1">
|
|
28 <rdfs:subClassOf rdf:resource="http://www.w3.org/2002/07/owl#Thing"/>
|
|
29 <rdfs:subClassOf>
|
|
30 <owl:Class>
|
|
31 <owl:intersectionOf rdf:parseType="Collection">
|
|
32 <owl:Restriction>
|
|
33 <owl:onProperty rdf:resource="http://example.org/vocab#color" />
|
|
34 <owl:hasValue>red</owl:hasValue>
|
|
35 </owl:Restriction>
|
|
36 <owl:Restriction>
|
|
37 <owl:onProperty rdf:resource="http://example.org/vocab#shape" />
|
|
38 <owl:hasValue>square</owl:hasValue>
|
|
39 </owl:Restriction>
|
|
40 </owl:intersectionOf>
|
|
41 </owl:Class>
|
|
42 </rdfs:subClassOf>
|
|
43 <wdrs:text>Everything on example.com is red and square</wdrs:text>
|
|
44 <wdrs:logo rdf:resource="http://example.org/icon.png" />
|
|
45 </owl:Class>
|
|
46
|
|
47 <span id="oldRDF"><owl:Class rdf:nodeID="iriset_1">
|
|
48 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
49 </owl:Class></span>
|
|
50
|
|
51 </rdf:RDF></pre>
|
|
</div>
|
|
|
|
<p>It is anticipated that POWDER-S documents will typically be generated by performing the GRDDL transform associated with POWDER after validity and trust has been conferred on the input document. However, a POWDER-S document may be created independently, in which case the question of trust remains open.</p>
|
|
<p>If trust is conferred on a POWDER-S document directly, or is inherited from the POWDER document that was transformed to generate it, <em>then</em> the graph can be merged with other graphs available to the processor.</p>
|
|
<p id="creatorDiff2">The <a href="#issuedby-s"><code>wdrs:issuedby</code></a> property (line 10) is an OWL annotation property with a domain of <a href="#Document"><code>wdrs:Document</code></a> but no defined range. As noted <a href="#line3">above</a>, however, it is RECOMMENDED that the filler be an instance of the <code>Agent</code> class from either the <code>dcterms</code> or <code>foaf</code> namespace. <span id="clarifyIssuedby">For the avoidance of doubt: it is the POWDER document that is <code>issuedby</code> the <code>Agent</code> not the resources that the POWDER document describes.</span></p>
|
|
<p>The <a href="#matchesregex"><code>matchesregex</code></a> property restriction in the IRI set class (lines 14-25) draws on
|
|
a <strong>semantic extension</strong> defined in the Formal Semantics document [<a href="#formal">FORMAL</a>] <span>(the <a href="#notmatchesregex"><code>notmatchesregex</code></a> property is also defined)</span>.
|
|
This supports the critical matching of an IRI against a regular expression to confer class membership on the resource denoted by that IRI. For emphasis we repeat that if the POWDER semantic extension is not understood, a generic RDF/OWL tool will not be able to ascribe any meaning to the properties of the IRI set class.</p>
|
|
<p>Notice that an <code>rdf:nodeID</code> is used to identify the IRI set and descriptor set classes, meaning that they cannot be referenced by external documents. This is deliberate and ensures that further properties cannot be added that might render the assertions made the POWDER document author incorrect.</p>
|
|
<p>The descriptor set class is pure RDF/OWL and is effectively a re-expression of the <code>descriptorset</code> element in a POWDER document with full semantics. Lines 27 - 45 of example 2-3 are derived directly from <a href="#eg2-1">example 2-1</a> lines 10 - 15.</p>
|
|
|
|
<h3 id="olDR">2.3 Exclusive Description Resources</h3>
|
|
<p>As noted in <a href="#operational">Section 2.1</a>, a POWDER document may contain any number of DRs. These may offer
|
|
overlapping descriptions of the same resources. It is often the case though that a description of one set of
|
|
resources must not be applied to other resources on the same Web site.</p>
|
|
<p>A modified version of example 2-2 is shown below as example 2-4. Note that the property in line 19, part of the second DR, is now the same as that in line 10 which is part of the first DR — but with a different value. Taken together, the two DRs state that in the opinion of the person or entity described at <code>http://authority.example.org/company.rdf#me</code>, all resources on example.com are red, but that those on example.com where the path starts with /foo are BOTH red AND blue.</p>
|
|
<div class="example" id="eg2-4">
|
|
<p class="caption">Example 2-4: A POWDER Document Containing Conflicting Description Resources [<a href="example_2_4.xml">XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
1 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
xmlns:ex="http://example.org/vocab#">
|
|
|
|
2 <attribution>
|
|
3 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
4 </attribution>
|
|
|
|
5 <dr>
|
|
6 <iriset>
|
|
7 <includehosts>example.com</includehosts>
|
|
8 </iriset>
|
|
|
|
9 <descriptorset>
|
|
10 <ex:color>red</ex:color>
|
|
11 </descriptorset>
|
|
12 </dr>
|
|
|
|
13 <dr>
|
|
14 <iriset>
|
|
15 <includehosts>example.com</includehosts>
|
|
16 <includepathstartswith>/foo</includepathstartswith>
|
|
17 </iriset>
|
|
|
|
18 <descriptorset>
|
|
19 <ex:color>blue</ex:color>
|
|
20 </descriptorset>
|
|
21 </dr>
|
|
|
|
21 </powder></pre>
|
|
</div>
|
|
<p>One way to avoid this paradox would be to add an extra definition to the first IRI set that excluded IRIs beginning with /foo as shown in example 2-5, thus creating two DRs with scopes that are disjoint.</p>
|
|
<div class="example" id="eg2-5">
|
|
<p class="caption">Example 2-5: A POWDER Document Containing Disjoint Description Resources [<a href="example_2_5.xml">XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
1 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
xmlns:ex="http://example.org/vocab#">
|
|
|
|
2 <attribution>
|
|
3 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
4 </attribution>
|
|
|
|
5 <dr>
|
|
6 <iriset>
|
|
7 <includehosts>example.com</includehosts>
|
|
8 <excludepathstartswith>/foo</excludepathstartswith>
|
|
9 </iriset>
|
|
|
|
10 <descriptorset>
|
|
11 <ex:color>red</ex:color>
|
|
12 </descriptorset>
|
|
13 </dr>
|
|
|
|
14 <dr>
|
|
15 <iriset>
|
|
16 <includehosts>example.com</includehosts>
|
|
17 <includepathstartswith>/foo</includepathstartswith>
|
|
18 </iriset>
|
|
|
|
19 <descriptorset>
|
|
20 <ex:color>blue</ex:color>
|
|
21 </descriptorset>
|
|
22 </dr>
|
|
|
|
23 </powder></pre>
|
|
</div>
|
|
<p>POWDER supports this structure; however, in a commercial content production environment it can be impractical to keep track of which exclusions should be written into which IRI sets, even with the aid of tools. This is particularly so where content is being produced in multiple departments or bought in from multiple suppliers. In such situations, the more typical need, and the more natural way of working, is to create a description that applies to all content on a given Web site <em>except where indicated</em>.</p>
|
|
<p>For this reason, POWDER uses the concept of an ordered list to create a set of DRs, only one of which applies to a given IRI.</p>
|
|
<div class="example" id="eg2-6">
|
|
<p class="caption">Example 2-6: A POWDER Document Containing an Ordered List of Description Resources [<a href="dr-example_2_06.xml">XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
1 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
xmlns:ex="http://example.org/vocab#">
|
|
|
|
2 <attribution>
|
|
3 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
4 <issued>2007-12-14T00:00:00</issued>
|
|
5 <abouthosts>example.com</abouthosts>
|
|
6 </attribution>
|
|
|
|
7 <ol>
|
|
8 <dr>
|
|
9 <iriset>
|
|
10 <includehosts>example.com</includehosts>
|
|
11 <includepathstartswith>/foo</includepathstartswith>
|
|
12 </iriset>
|
|
|
|
13 <descriptorset>
|
|
14 <ex:color>blue</ex:color>
|
|
15 </descriptorset>
|
|
16 </dr>
|
|
|
|
17 <dr>
|
|
18 <iriset>
|
|
19 <includehosts>example.com</includehosts>
|
|
20 </iriset>
|
|
|
|
21 <descriptorset>
|
|
22 <ex:color>red</ex:color>
|
|
23 </descriptorset>
|
|
24 </dr>
|
|
25 </ol>
|
|
|
|
26 </powder></pre>
|
|
</div>
|
|
<p>In the POWDER namespace, the <a href="#ol"><code>ol</code></a> tag indicates an ordered list of Description Resources. If a given IRI is within the scope of the first DR in the list, then that DR applies; if not, move on to the second DR and see if the given IRI is within its scope, and so on, until either a match is made or the end of the list is reached. As such, it is important to place any exclusions before other DRs that include that resource in their scope, or else the exclusion will never be matched. An IRI can only be described by 0 or 1 DRs from an ordered list.</p>
|
|
<p>The first DR in the list in example 2-6 covers resources on example.com with a path starting with /foo and describes them as being blue. Any resource available from example.com that does not have a path starting with /foo is described as being red. Further DRs may be added to the list without the need to edit either of the existing DRs, although order may be important. This would be the case if, for instance, resources available from example.com with a path starting with /foo and a query string containing <code>material=natural</code> were green. Such a DR would need to go above the first one in the example.</p>
|
|
<p>It is noteworthy that if the content provider at example.com wishes to link to this document, he/she can arrange for <em>all</em> resources to include <em>exactly</em> the same pointer — the POWDER document contains all the necessary information to discover how the red and blue resources are arranged. Linkage is discussed in more detail in <a href="#assoc">Section 4</a>. Moreover, the disposition of content with different characteristics across a given Web site or set of Web sites can be discovered by processing the one document. If processed alongside a site map, for example, this becomes a powerful content discovery mechanism.</p>
|
|
<p>In order to minimize the processing of a sequence of DRs like this, we introduce the <a href="#abouthosts"><code>abouthosts</code></a> element in line 5. This takes a white space separated list of hosts and can be included in the attribution element of any POWDER document, whether it contains an ordered list of DRs or not. In this context, <code>abouthosts</code> provides a processing hint, quickly identifying whether a candidate resource <em>might</em> be described by the DRs in the document. The element also has a bigger role to play, which is discussed in <a href="#directDescript">Section 2.5</a>; for now we note that if the host component of a given IRI is included in the list given as the value for the <code>abouthosts</code> element, then the POWDER document may, but is not guaranteed to, contain a description of that IRI. If the host component of a given IRI is <strong>not</strong> included in the list given as the value for the <code>abouthosts</code> element, then the <a name="pp1" id="pp1">processor MUST assume that the POWDER document does not contain a description of that IRI</a>. From a discovery point of view, it provides an efficient method of hinting at where to find the resources that match the given description(s).</p>
|
|
<p id="abhostErr"><strong>N.B.</strong> IRI sets within a POWDER document do not inherit the value of <code>abouthosts</code> as part of their definition and SHOULD include elements such as <code>includehosts</code> to ensure that they are self-contained. Semantically, it is an error if an IRI set defines a set of resources that is inconsistent with an <code>abouthosts</code> element. In POWDER-S, this is captured by making <code>descriptorset</code>-derived classes of resources a subset of the <code>abouthosts</code>-derived class of resources. A logical inconsistency arises if a descriptor is applied to a resource that is not within the scope specified by <code>abouthosts</code>.</p>
|
|
<p>POWDER-S does not directly support ordered lists, but their semantics are captured by
|
|
creating classes that exclude defined <span id="newOL1">resources</span> in such a way as to create the necessary
|
|
semantics as shown in example 2-7 below.</p>
|
|
<div class="example" id="eg2-7">
|
|
<p class="caption">Example 2-7: The POWDER-S Document Derived From Example 2-6 [<a href="dr-example_2_06.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:ex="http://example.org/vocab#">
|
|
8
|
|
9 <owl:Ontology rdf:about="">
|
|
10 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
11 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
12 </owl:Ontology>
|
|
13
|
|
14 <owl:Class rdf:nodeID="aboutset"> <!-- from the abouthosts element -->
|
|
15 <owl:equivalentClass>
|
|
16 <owl:Class>
|
|
17 <owl:intersectionOf rdf:parseType="Collection">
|
|
18 <owl:Restriction>
|
|
19 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
20 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
21 </owl:Restriction>
|
|
22 </owl:intersectionOf>
|
|
23 </owl:Class>
|
|
24 </owl:equivalentClass>
|
|
25 </owl:Class>
|
|
26
|
|
27 <owl:Class rdf:nodeID="iriset_1">
|
|
28 <owl:equivalentClass>
|
|
29 <owl:Class>
|
|
30 <owl:intersectionOf rdf:parseType="Collection">
|
|
31 <owl:Restriction>
|
|
32 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
33 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
34 </owl:Restriction>
|
|
35 <owl:Restriction>
|
|
36 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
37 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]*)(\:([0-9]+))?(\/foo)</owl:hasValue>
|
|
38 </owl:Restriction>
|
|
39 </owl:intersectionOf>
|
|
40 </owl:Class>
|
|
41 </owl:equivalentClass>
|
|
42 </owl:Class>
|
|
43
|
|
44 <owl:Class rdf:nodeID="iriset_1_not">
|
|
45 <owl:equivalentClass>
|
|
46 <owl:Class>
|
|
47 <owl:unionOf rdf:parseType="Collection">
|
|
48 <owl:Restriction>
|
|
49 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#notmatchesregex" />
|
|
50 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
51 </owl:Restriction>
|
|
52 <owl:Restriction>
|
|
53 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#notmatchesregex" />
|
|
54 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]*)(\:([0-9]+))?(\/foo)</owl:hasValue>
|
|
55 </owl:Restriction>
|
|
56 </owl:unionOf>
|
|
57 </owl:Class>
|
|
58 </owl:equivalentClass>
|
|
59 </owl:Class>
|
|
60
|
|
61 <owl:Class rdf:nodeID="descriptorset_1">
|
|
62 <rdfs:subClassOf rdf:nodeID="aboutset"/>
|
|
63 <rdfs:subClassOf>
|
|
64 <owl:Class>
|
|
65 <owl:intersectionOf rdf:parseType="Collection">
|
|
66 <owl:Restriction>
|
|
67 <owl:onProperty rdf:resource="http://example.org/vocab#color" />
|
|
68 <owl:hasValue>blue</owl:hasValue>
|
|
69 </owl:Restriction>
|
|
70 </owl:intersectionOf>
|
|
71 </owl:Class>
|
|
72 </rdfs:subClassOf>
|
|
73 </owl:Class>
|
|
74
|
|
75 <rdf:Description rdf:nodeID="iriset_1">
|
|
76 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
77 </rdf:Description>
|
|
78
|
|
79 <owl:Class rdf:nodeID="iriset_2">
|
|
80 <owl:equivalentClass>
|
|
81 <owl:Class>
|
|
82 <owl:intersectionOf rdf:parseType="Collection">
|
|
83 <owl:Restriction>
|
|
84 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
85 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
86 </owl:Restriction>
|
|
87 <owl:Class rdf:nodeID="iriset_1_not" />
|
|
88 </owl:intersectionOf>
|
|
89 </owl:Class>
|
|
90 </owl:equivalentClass>
|
|
91 </owl:Class>
|
|
92
|
|
93 <owl:Class rdf:nodeID="descriptorset_2">
|
|
94 <rdfs:subClassOf rdf:nodeID="aboutset"/>
|
|
95 <rdfs:subClassOf>
|
|
96 <owl:Class>
|
|
97 <owl:intersectionOf rdf:parseType="Collection">
|
|
98 <owl:Restriction>
|
|
99 <owl:onProperty rdf:resource="http://example.org/vocab#color" />
|
|
100 <owl:hasValue>red</owl:hasValue>
|
|
101 </owl:Restriction>
|
|
102 </owl:intersectionOf>
|
|
103 </owl:Class>
|
|
104 </rdfs:subClassOf>
|
|
105 </owl:Class>
|
|
106
|
|
107 <rdf:Description rdf:nodeID="iriset_2">
|
|
108 <rdfs:subClassOf rdf:nodeID="descriptorset_2"/>
|
|
109 </rdf:Description>
|
|
110
|
|
111 </rdf:RDF>
|
|
</pre>
|
|
</div>
|
|
<p>The key feature of example 2-7 is the creation of the 'iriset_1_not' (lines 44-59). This differs from
|
|
the IRI set in lines 27-42 in that it is defined using the <code>notmatchesregex</code> property, and a union of property
|
|
restrictions, cf. their intersection. This allows the second IRI set to create a logical closed world for IRI
|
|
set 2 (line 87). A full example with a third DR in the list and generalized rules is provided in the
|
|
Formal Semantics document [<a href="#formal">FORMAL</a>].</p>
|
|
|
|
<p>Example 2-7 also shows that the <code>abouthosts</code> element from the original POWDER document (line 5 in <a href="#eg2-6">Example 2-6</a>) is
|
|
transformed into a class very similar to those for the IRI sets, this time with a node ID of 'aboutset'
|
|
(line 14 - 25). Both <code>descriptorset_1</code> and <code>descriptorset_2</code> are defined as the intersection of this set, and the various descriptive properties which ensures that the intended operational semantics of <code>abouthosts</code> are preserved. A logical inconsistency is detected if an IRI is asserted to be a sub class of a descriptor set that intersects with an about set of which it is not a member. The Formal Semantics document [<a href="#formal">FORMAL</a>] has further detail on the processing of <code>abouthosts</code>.</p>
|
|
<h3 id="multiIRIsets">2.4 DRs with Multiple IRI Sets</h3>
|
|
<p>As noted in <a href="#operational">Section 2.1</a>, the scope of a DR may be the union of multiple IRI sets. Example 2-8 below shows a DR for which the scope is all resources on example.com that have a path starting with /foo AND those on example.org that have a path starting with /bar. In POWDER-S, the sub-class relationship between each of the IRI sets and the descriptor set is asserted independently.</p>
|
|
<div class="example" id="eg2-8">
|
|
<p class="caption">Example 2-8: A DR for which the scope is the union of two IRI sets</p>
|
|
<p>POWDER [<a href="dr-example_2_08.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <attribution>
|
|
5 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
6 <issued>2007-12-14T00:00:00</issued>
|
|
7 </attribution>
|
|
|
|
8 <dr>
|
|
9 <iriset>
|
|
10 <includehosts>example.com</includehosts>
|
|
11 <includepathstartswith>/foo</includepathstartswith>
|
|
12 </iriset>
|
|
|
|
13 <iriset>
|
|
14 <includehosts>example.org</includehosts>
|
|
15 <includepathstartswith>/bar</includepathstartswith>
|
|
16 </iriset>
|
|
|
|
17 <descriptorset>
|
|
18 <ex:color>red</ex:color>
|
|
19 <ex:shape>square</ex:shape>
|
|
20 <displaytext>Everything on example.com/foo, and everything on example.org/bar, is red and square</displaytext>
|
|
21 <displayicon src="http://example.org/icon.png" />
|
|
22 </descriptorset>
|
|
23 </dr>
|
|
|
|
24 </powder>
|
|
</pre>
|
|
<p>POWDER-S [<a href="dr-example_2_08.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:dcterms="http://purl.org/dc/terms/"
|
|
8 xmlns:ex="http://example.org/vocab#">
|
|
9
|
|
10 <owl:Ontology rdf:about="">
|
|
11 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
12 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
13 </owl:Ontology>
|
|
14
|
|
15 <owl:Class rdf:nodeID="iriset_1">
|
|
16 <owl:equivalentClass>
|
|
17 <owl:Class>
|
|
18 <owl:intersectionOf rdf:parseType="Collection">
|
|
19 <owl:Restriction>
|
|
20 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
21 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
22 </owl:Restriction>
|
|
23 <owl:Restriction>
|
|
24 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
25 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]*)(\:([0-9]+))?(\/foo)</owl:hasValue>
|
|
26 </owl:Restriction>
|
|
27 </owl:intersectionOf>
|
|
28 </owl:Class>
|
|
29 </owl:equivalentClass>
|
|
30 </owl:Class>
|
|
31
|
|
32 <owl:Class rdf:nodeID="iriset_2">
|
|
33 <owl:equivalentClass>
|
|
34 <owl:Class>
|
|
35 <owl:intersectionOf rdf:parseType="Collection">
|
|
36 <owl:Restriction>
|
|
37 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
38 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.<span id="fix_28">org</span>)(\:([0-9]+))?\/</owl:hasValue>
|
|
39 </owl:Restriction>
|
|
40 <owl:Restriction>
|
|
41 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
42 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]*)(\:([0-9]+))?(\/bar)</owl:hasValue>
|
|
43 </owl:Restriction>
|
|
44 </owl:intersectionOf>
|
|
45 </owl:Class>
|
|
46 </owl:equivalentClass>
|
|
47 </owl:Class>
|
|
48
|
|
49 <owl:Class rdf:nodeID="descriptorset_1">
|
|
50 <wdrs:text>Everything on example.com/foo, and everything on example.org/bar, is red and square</wdrs:text>
|
|
51 <wdrs:logo rdf:resource="http://example.org/icon.png" />
|
|
52 <rdfs:subClassOf>
|
|
53 <owl:Class>
|
|
54 <owl:intersectionOf rdf:parseType="Collection">
|
|
55 <owl:Restriction>
|
|
56 <owl:onProperty rdf:resource="http://example.org/vocab#color" />
|
|
57 <owl:hasValue>red</owl:hasValue>
|
|
58 </owl:Restriction>
|
|
59 <owl:Restriction>
|
|
60 <owl:onProperty rdf:resource="http://example.org/vocab#shape" />
|
|
61 <owl:hasValue>square</owl:hasValue>
|
|
62 </owl:Restriction>
|
|
63 </owl:intersectionOf>
|
|
64 </owl:Class>
|
|
65 </rdfs:subClassOf>
|
|
66 </owl:Class>
|
|
67
|
|
68 <owl:Class rdf:nodeID="iriset_1">
|
|
69 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
70 </owl:Class>
|
|
71
|
|
72 <owl:Class rdf:nodeID="iriset_2">
|
|
73 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
74 </owl:Class>
|
|
75
|
|
76 </rdf:RDF>
|
|
</pre></div>
|
|
|
|
<h3 id="directDescript">2.5 Direct Resource Description</h3>
|
|
<p>POWDER is predicated on the concept of IRI sets — applying descriptions to more than one IRI at a time. This relies on there being some structure to the IRIs used. To a human reader, it would be fairly obvious that all resources with an IRI on composers.example.org that have a path starting with /Mahler would be about a different composer to those with a path starting with /Beethoven. IRI sets allow these relationships to become machine processable.</p>
|
|
<p>However, not all Web content is arranged in such clearly delineated fashion, and as a result it may be impossible to define a suitable IRI set. For example, a content management system may assign a simple numerical IRI to newly added content irrespective of the type or the subject matter of content available from that IRI. In such a situation, the usefulness of POWDER as a content discovery mechanism is reduced, but not eliminated.</p>
|
|
<p>The POWDER document in example 2-9 below contains two descriptions that can be applied to example.org and example.com (defined in the <code>abouthosts</code> element), but those descriptions are not tied to particular IRI sets within a Description Resource.</p>
|
|
<div class="example" id="eg2-9">
|
|
<p class="caption">Example 2-9: A POWDER Document With Descriptors That Can Be Referenced Externally, But With No DRs</p>
|
|
<p>POWDER [<a href="example_2_9_1.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <attribution>
|
|
5 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
6 <abouthosts>example.org example.com</abouthosts>
|
|
7 </attribution>
|
|
|
|
8 <descriptorset xml:id="red">
|
|
9 <ex:color>red</ex:color>
|
|
10 </descriptorset>
|
|
|
|
11 <descriptorset xml:id="blue">
|
|
12 <ex:color>blue</ex:color>
|
|
13 </descriptorset>
|
|
|
|
14 </powder>
|
|
</pre>
|
|
</div>
|
|
<p>From a discovery point of view, this tells us that there are red and blue resources available on example.org and example.com but can go no further. Associating a description set with a specific IRI can only be done by linking <em>from</em> a resource <em>to</em> a description, hence the inclusion of the identifiers on the descriptor set elements (which are preserved in POWDER-S). An HTML document at http://www.example.org/page.html might include a link element thus:</p>
|
|
<blockquote>
|
|
<p style="text-align:center"><code><link rel="describedby" href="/powder.xml#red" <span id="app1">type="application/powder+xml"</span> /></code></p>
|
|
</blockquote>
|
|
<p>Although example 2-9 does not contain any Description Resources, it does preserve two key elements of POWDER:</p>
|
|
<p>Firstly, the description is attributed and therefore an assessment of trust can be made in the same way as any other POWDER document.</p>
|
|
<p>Secondly, the attribution element includes an <code>abouthosts</code> element. This effectively limits the scope of the descriptions to the declared hosts, since if a resource is not available from a listed host, then, as noted in the discussion of <a href="#eg2-6">Example 2.6</a> above, the processor MUST NOT apply the data in the document to that resource.</p>
|
|
<p>This is an important point, since it would be possible to claim that <em>any</em> resource on the Web is 'red' by including the link element shown above. This may be what is required (see following section); however, the <code>abouthosts</code> element allows POWDER document authors to set an outer limit on where the descriptions can be applied. It is for this reason that we specify that if the <code>abouthosts</code> element is included in a POWDER document, then processors MUST NOT, rather than SHOULD NOT or MAY NOT, apply descriptions within the document to any host other than those listed. This has implications for the specification of a POWDER Processor. See <a href="#powderprocessor">Section 3</a> below.</p>
|
|
<p>It is emphasized that providing descriptions in this way is inferior to the preferred method of explicitly associating them with IRI sets within a DR. If a POWDER document is to describe all the resources on a given Web site in the same way, then authors should include a Description Resource with an IRI set defined using the appropriate value of the <code>includehosts</code> element. This is because the semantics are different in a subtle but important way:</p>
|
|
<div style="margin-left:2em">
|
|
<p>Within a Description Resource, all IRIs that are instances of an IRI set are described.</p>
|
|
<p>The <code>abouthosts</code> element within the attribution element of a POWDER document states that all resources that are described within that document are available from the given host(s); it does NOT guarantee that all resources on those hosts are described.</p>
|
|
</div>
|
|
<p>The first of these is clearly a better aid to content discovery.</p>
|
|
|
|
<!-- ###################################### Pre Defined Descriptors ######################################### -->
|
|
|
|
<h3 id="preDefinedDescriptors">2.6 Pre-Defined Descriptors</h3>
|
|
<p>As shown in the previous section, <code>descriptorset</code> elements can exist outside a DR. There are situations where defining descriptor sets independently of any DR but within the same POWDER document can be very convenient, and this is discussed in <a href="#multiDesc">Section 2.8</a>. This section is concerned with the definition of descriptor sets that can be referred to by DRs in other POWDER documents.</p>
|
|
<p>If a POWDER document does not include an <code>abouthosts</code> element in its attribution, then a descriptor set within it that has an identifier of its own may be used to describe <em>any</em> resource. However, this is the job that RDF vocabularies and OWL ontologies are designed for. Therefore, authors are <em>strongly advised</em> to create or use existing examples of either of those in preference to a POWDER document without any restriction on where the descriptions can be applied.</p>
|
|
<p>Bearing in mind that warning, some content providers and their suppliers may find it convenient to split Description Resources across several POWDER documents. In example 2-10 below, powder1.xml defines two types of book published by the organization described at http://education.example.org/company.rdf#me related to the UK National Curriculum. The publisher sells their books through two online outlets: books.example.com and archive.example.net and therefore restricts its descriptions to those hosts. powder2.xml describes one of those outlets (books.example.com), which brands its Key Stage 1 products as 'robin' and its Key Stage 2 products as 'starling.' By referring to powder1.xml, books.example.com is able to associate the publisher's relevant icon with the correct pages of its own e-commerce portal.</p>
|
|
<p>A <a href="#powderprocessor" id="pp2">POWDER processor</a> MUST take full account of the <code>abouthosts</code> element in powder1.xml when processing the DRs in powder2.xml.</p>
|
|
<div class="example" id="eg2-10">
|
|
<p class="caption">Example 2-10: Example of a Pre-Defined Descriptors Element and its Usage</p>
|
|
<p>powder1.xml [<a href="dr-example_2_10_1.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://education.example.org/vocab#">
|
|
|
|
4 <attribution>
|
|
5 <issuedby src="http://education.example.org/company.rdf#me" />
|
|
6 <abouthosts>books.example.com archive.example.net</abouthosts>
|
|
7 </attribution>
|
|
|
|
8 <descriptorset xml:id="ks1">
|
|
9 <displaytext>This material is suitable for UK National Curriculum Key Stage 1</displaytext>
|
|
10 <displayicon src="http://education.example.org/ks1.png" />
|
|
11 </descriptorset>
|
|
|
|
12 <descriptorset xml:id="ks2">
|
|
13 <displaytext>This material is suitable for UK National Curriculum Key Stage 2</displaytext>
|
|
14 <displayicon src="http://education.example.org/ks2.png" />
|
|
15 </descriptorset>
|
|
|
|
16 </powder>
|
|
</pre>
|
|
<p>powder2.xml [<a href="dr-example_2_10_2.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#">
|
|
|
|
3 <attribution>
|
|
4 <issuedby src="http://books.example.com/company.rdf#me" />
|
|
5 <issued>2008-03-03T00:00:00</issued>
|
|
6 </attribution>
|
|
|
|
7 <dr>
|
|
8 <iriset>
|
|
9 <includehosts>books.example.com</includehosts>
|
|
10 <includepathstartswith>/robin/</includepathstartswith>
|
|
11 </iriset>
|
|
12 <descriptorset src="http://education.example.org/powder1.xml#ks1" />
|
|
13 </dr>
|
|
|
|
14 <dr>
|
|
15 <iriset>
|
|
16 <includehosts>books.example.com</includehosts>
|
|
17 <includepathstartswith>/starling/</includepathstartswith>
|
|
18 </iriset>
|
|
19 <descriptorset src="http://education.example.org/powder1.xml#ks2" />
|
|
20 </dr>
|
|
|
|
21 </powder>
|
|
</pre>
|
|
</div>
|
|
<p id="paf3">Given powder2.xml, a <a name="pp3" id="pp3">POWDER Processor SHOULD</a> use the descriptor sets defined in powder1.xml (or report an error if it is not available, not valid etc.). The GRDDL transform uses the value of the <code>src</code> attribute in the sub class assertion such that the POWDER-S encoding of powder2.xml includes:</p>
|
|
<pre>
|
|
<owl:Class rdf:nodeID="iriset_1">
|
|
<rdfs:subClassOf rdf:resource="http://education.example.org/powder1.xml#ks1"/>
|
|
</owl:Class>
|
|
</pre>
|
|
<div class="example" id="eg2-11">
|
|
<p class="caption">Example 2-11: POWDER-S Version of Example 2-10</p>
|
|
<p>powder1.rdf [<a href="dr-example_2_10_1.rdf">RDF</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:dcterms="http://purl.org/dc/terms/"
|
|
7 xmlns:owl="http://www.w3.org/2002/07/owl#">
|
|
8
|
|
9 <owl:Ontology rdf:about="">
|
|
10 <wdrs:issuedby rdf:resource="http://books.example.com/company.rdf#me" />
|
|
11 <wdrs:issued>2008-03-03T00:00:00</wdrs:issued>
|
|
12 </owl:Ontology>
|
|
13
|
|
14 <owl:Class rdf:nodeID="aboutset">
|
|
15 <owl:equivalentClass>
|
|
16 <owl:Class>
|
|
17 <owl:intersectionOf rdf:parseType="Collection">
|
|
18 <owl:Restriction>
|
|
19 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
20 <owl:hasValue>\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(books\.example\.com|archive\.example\.net)(\:([0-9]+))?\/</owl:hasValue>
|
|
21 </owl:Restriction>
|
|
22 </owl:intersectionOf>
|
|
23 </owl:Class>
|
|
24 </owl:equivalentClass>
|
|
25 </owl:Class>
|
|
26
|
|
27 <owl:Class rdf:ID="ks_1">
|
|
28 <wdrs:text>This material is suitable for UK National Curriculum Key Stage 1</wdrs:text>
|
|
29 <wdrs:logo rdf:resource="http://education.example.org/ks1.png" />
|
|
30 <owl:equivalentClass>
|
|
31 <owl:Class>
|
|
32 <owl:intersectionOf rdf:parseType="Collection">
|
|
33 <owl:Class rdf:nodeID="aboutset"/>
|
|
34 </owl:intersectionOf>
|
|
35 </owl:Class>
|
|
36 </owl:equivalentClass>
|
|
37 </owl:Class>
|
|
38
|
|
39 <owl:Class rdf:ID="ks_2">
|
|
40 <wdrs:text>This material is suitable for UK National Curriculum Key Stage 2</wdrs:text>
|
|
41 <wdrs:logo rdf:resource="http://education.example.org/ks2.png" />
|
|
42 <owl:equivalentClass>
|
|
43 <owl:Class>
|
|
44 <owl:intersectionOf rdf:parseType="Collection">
|
|
45 <owl:Class rdf:nodeID="aboutset"/>
|
|
46 </owl:intersectionOf>
|
|
47 </owl:Class>
|
|
48 </owl:equivalentClass>
|
|
49 </owl:Class>
|
|
50
|
|
51 </rdf:RDF>
|
|
</pre>
|
|
<p>powder2.rdf [<a href="dr-example_2_10_2.rdf">RDF</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#">
|
|
7
|
|
8 <owl:Ontology rdf:about="">
|
|
9 <wdrs:issuedby rdf:resource="http://education.example.org/company.rdf#me" />
|
|
10 <wdrs:issued>2008-03-03T00:00:00</wdrs:issued>
|
|
11 </owl:Ontology>
|
|
12
|
|
13 <owl:Class rdf:nodeID="iriset_1">
|
|
14 <owl:equivalentClass>
|
|
15 <owl:Class>
|
|
16 <owl:intersectionOf rdf:parseType="Collection">
|
|
17 <owl:Restriction>
|
|
18 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
19 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(books\.example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
20 </owl:Restriction>
|
|
21 <owl:Restriction>
|
|
22 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
23 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/([^\:\/\?\#\@]+\.)*[^\:\/\?\#\@]+(\:([0-9]+))?(\/robin\/)</owl:hasValue>
|
|
24 </owl:Restriction>
|
|
25 </owl:intersectionOf>
|
|
26 </owl:Class>
|
|
27 </owl:equivalentClass>
|
|
28 </owl:Class>
|
|
29
|
|
30 <owl:Class rdf:nodeID="iriset_1">
|
|
31 <rdfs:subClassOf rdf:resource="http://education.example.org/powder1.rdf#ks_1"/>
|
|
32 </owl:Class>
|
|
33
|
|
34 <owl:Class rdf:nodeID="iriset_2">
|
|
35 <owl:equivalentClass>
|
|
36 <owl:Class>
|
|
37 <owl:intersectionOf rdf:parseType="Collection">
|
|
38 <owl:Restriction>
|
|
39 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
40 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(books\.example\.com)(\:([0-9]+))?\/</owl:hasValue>
|
|
41 </owl:Restriction>
|
|
42 <owl:Restriction>
|
|
43 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
44 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/([^\:\/\?\#\@]+\.)*[^\:\/\?\#\@]+(\:([0-9]+))?(\/starling\/)</owl:hasValue>
|
|
45 </owl:Restriction>
|
|
46 </owl:intersectionOf>
|
|
47 </owl:Class>
|
|
48 </owl:equivalentClass>
|
|
49 </owl:Class>
|
|
50
|
|
51 <owl:Class rdf:nodeID="iriset_2">
|
|
52 <rdfs:subClassOf rdf:resource="http://education.example.org/powder1.rdf#ks_2"/>
|
|
53 </owl:Class>
|
|
54
|
|
55 </rdf:RDF></pre>
|
|
</div>
|
|
<p id="useSparingly">Although <code>abouthosts</code> can provide a useful processing hint in a purely operational POWDER environment as shown in <a href="#eg2-6">Example 2-6</a>, taking account of it when checking that a particular descriptor set can be applied to a given resource can require significant processing, especially in POWDER-S. Furthermore, it <em>can</em> readily lead to mistakes. <strong>Use only when necessary.</strong></p>
|
|
|
|
<!-- ######################################################## Free Text Tags ################################################# -->
|
|
|
|
<h3 id="tags">2.7 Free Text Tags, Comments, Labels and "See Also"</h3>
|
|
<p>In the examples given so far, controlled vocabularies have been used to describe the resources. POWDER also supports free text 'tags' too — that is, key words or short phrases that describe the content — as shown in example 2-12 below.</p>
|
|
<div class="example" id="eg2-12">
|
|
<p class="caption">Example 2-12: Generic Example of a DR Containing a Tagset [<a href="example_2_12.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <attribution>
|
|
5 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
6 <issued>2007-12-14T00:00:00</issued>
|
|
7 </attribution>
|
|
|
|
8 <dr>
|
|
9 <iriset>
|
|
10 <includehosts>example.com</includehosts>
|
|
11 </iriset>
|
|
|
|
12 <tagset>
|
|
13 <tag>London</tag>
|
|
14 <tag>Swiss Re</tag>
|
|
15 <tag>gherkin</tag>
|
|
16 </tagset>
|
|
17 </dr>
|
|
18 </powder></pre>
|
|
</div>
|
|
<p>The DR in this example does not have a descriptor set; rather, it has a tag set (it could have both). Any number of tags may be included as elements within the tag set and these may contain any text (subject to usual XML data encoding rules).</p>
|
|
<p>A DR MUST contain at least one <code>tagset</code> or <code>descriptorset</code> element, or both.</p>
|
|
<p>The <a href="#tag"><code>tag</code></a> element can only be used within a <a href="#tagset"><code>tagset</code></a> and specifically MUST NOT be used within a <code>descriptorset</code>. This is because the descriptor set element is used to contain values for properties taken from controlled vocabularies expressed in RDF.</p>
|
|
<p>Tag sets and descriptor sets can also be associated with other descriptive or informative resources (not necessarily POWDER documents) through the use of the <a href="#seealso"><code>seealso</code></a> element. This has a <code>src</code> attribute that takes an IRI as shown in the example below. Associating tags with other resources in this way can help to disambiguate them. Each <code>seealso</code> in a <code>descriptorset</code> or <code>tagset</code> is transformed into an <code>rdfs:seeAlso</code> annotation on the relevant OWL class.</p>
|
|
<p>Two further <code>rdfs</code> annotation properties are accessible directly in POWDER: <a href="#label"><code>label</code></a> and <a href="#comment"><code>comment</code></a>. The usage and transformation from POWDER to POWDER-S of all these properties are shown in the following example.</p>
|
|
<div class="example" id="eg2-13">
|
|
<p class="caption">Example 2-13: Example of a DR Containing a Tagset that Links to Further Information that Puts the Tags in Context</p>
|
|
<p>POWDER [<a href="dr-example_2_13.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <attribution>
|
|
5 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
6 <issued>2007-12-14T00:00:00</issued>
|
|
7 </attribution>
|
|
|
|
8 <dr>
|
|
9 <iriset>
|
|
10 <includehosts>example.com</includehosts>
|
|
11 </iriset>
|
|
|
|
12 <tagset>
|
|
13 <label>Tags for the London landmark</label>
|
|
14 <tag>London</tag>
|
|
15 <tag>Swiss Re</tag>
|
|
16 <tag>gherkin</tag>
|
|
17 <seealso src="http://encyclopaedia.example.com/gherkin.html" />
|
|
18 <seealso src="http://photo.example.com/gherkin.jpg" />
|
|
19 <comment>Tags are linked to specific resources that contextualize them</comment>
|
|
20 </tagset>
|
|
21 </dr>
|
|
22 </powder></pre>
|
|
<p>POWDER-S [<a href="dr-example_2_13.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:foaf="http://xmlns.com/foaf/0.1/"
|
|
5 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
6 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
7 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
8 xmlns:dc="http://purl.org/dc/elements/1.1/"
|
|
9 xmlns:dcterms="http://purl.org/dc/terms/"
|
|
10 xmlns:ex="http://example.org/vocab#">
|
|
11
|
|
12 <owl:Ontology rdf:about="">
|
|
13 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
14 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
15 </owl:Ontology>
|
|
16
|
|
17 <owl:Class rdf:nodeID="iriset_1">
|
|
18 <owl:equivalentClass>
|
|
19 <owl:Class>
|
|
20 <owl:intersectionOf rdf:parseType="Collection">
|
|
21 <owl:Restriction>
|
|
22 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
23 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(:([0-9]+))?\/</owl:hasValue>
|
|
24 </owl:Restriction>
|
|
25 </owl:intersectionOf>
|
|
26 </owl:Class>
|
|
27 </owl:equivalentClass>
|
|
28 </owl:Class>
|
|
29
|
|
30 <owl:Class rdf:nodeID="tagset_1">
|
|
31 <rdfs:label>Tags for the London landmark</rdfs:label>
|
|
32 <rdfs:comment>Tags are linked to specific resources that contextualize them</rdfs:comment>
|
|
33 <rdfs:seeAlso rdf:resource="http://encyclopaedia.example.com/gherkin.html" />
|
|
34 <rdfs:seeAlso rdf:resource="http://photo.example.com/gherkin.jpg" />
|
|
35 <rdfs:subClassOf>
|
|
36 <owl:Class>
|
|
37 <owl:intersectionOf rdf:parseType="Collection">
|
|
38 <owl:Restriction>
|
|
39 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#tag" />
|
|
40 <owl:hasValue>London</owl:hasValue>
|
|
41 </owl:Restriction>
|
|
42 <owl:Restriction>
|
|
43 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#tag" />
|
|
44 <owl:hasValue>Swiss Re</owl:hasValue>
|
|
45 </owl:Restriction>
|
|
46 <owl:Restriction>
|
|
47 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#tag" />
|
|
48 <owl:hasValue>gherkin</owl:hasValue>
|
|
49 </owl:Restriction>
|
|
50 </owl:intersectionOf>
|
|
51 </owl:Class>
|
|
52 </rdfs:subClassOf>
|
|
53 </owl:Class>
|
|
54
|
|
55 <owl:Class rdf:nodeID="iriset_1">
|
|
56 <rdfs:subClassOf rdf:nodeID="tagset_1"/>
|
|
57 </owl:Class>
|
|
58
|
|
59 </rdf:RDF>
|
|
</pre></div>
|
|
<p id="seealsoequiv">The <code>seealso</code>, <code>label</code> and <code>comment</code> elements are provided simply as shortcuts to avoid having to declare the <code>rdfs</code> namespace in a POWDER document. The relevant <code>rdfs</code> properties MAY be used directly within a tag set or descriptor set and these receive exactly the same semantics in the GRDDL transformation. For clarity, the following two statements are semantically equivalent in a POWDER document:</p>
|
|
<pre>
|
|
<tagset>
|
|
<seealso src="http://encyclopaedia.example.com/gherkin.html" />
|
|
<tagset>
|
|
|
|
<tagset>
|
|
<rdfs:seeAlso rdf:resource="http://encyclopaedia.example.com/gherkin.html" />
|
|
<tagset>
|
|
</pre>
|
|
|
|
<p id="xmllang2"><code>xml:lang</code> attributes are retained by the GRDDL transformation for the <code>label</code> and <code>comment</code> elements.</p>
|
|
|
|
<h3 id="flexibility">2.8 POWDER Flexibility</h3>
|
|
<h4 id="multiDesc">2.8.1 Multiple Descriptor Sets</h4>
|
|
<p>In much the same way that a Description Resource may contain <a href="#multiIRIsets">multiple IRI sets</a>, it may also contain multiple descriptor sets. This is particularly useful where two distinct and independent types of description are applied to different sections of a single Web site. For instance, an editorial policy or trustmark might apply to a whole Web site, whereas a description of the content's suitability for children might vary in different sections, as the following example shows. Here the whole of movie.example.com is covered by the same trustmark with resources that have IRIs with a path beginning with /after9pm identified as only being suitable for adults. By defining descriptor sets separately within the POWDER document, these can be referenced as needed within the DRs without duplicating data. Separately from the ordered list, the entity described at http://authority.example.org/company.rdf#me has tagged the /latest section with the phrases <em>New Releases</em> and <em>What's Hot</em>.</p>
|
|
<p>This example introduces some new elements and attributes, which are detailed below.</p>
|
|
<div class="example" id="eg2-14">
|
|
<p class="caption">Example 2-14: An Ordered List of DRs, each with Multiple Descriptor Sets</p>
|
|
<p>POWDER [<a href="dr-example_2_14.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <attribution>
|
|
5 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
6 <issued>2007-12-14T00:00:00</issued>
|
|
7 </attribution>
|
|
|
|
8 <ol>
|
|
9 <dr>
|
|
10 <iriset>
|
|
11 <includehosts>movie.example.com</includehosts>
|
|
12 <includepathstartswith>/after9pm</includepathstartswith>
|
|
13 </iriset>
|
|
|
|
14 <descriptorset include="adult" />
|
|
15 <descriptorset include="trustmark" />
|
|
16 </dr>
|
|
|
|
17 <dr>
|
|
18 <iriset>
|
|
19 <includehosts>movie.example.com</includehosts>
|
|
20 </iriset>
|
|
|
|
21 <descriptorset include="allages" />
|
|
22 <descriptorset include="trustmark" />
|
|
23 </dr>
|
|
24 </ol>
|
|
|
|
25 <descriptorset node="adult">
|
|
26 <ex:agemin>18</ex:agemin>
|
|
27 <displaytext>Adults Only</displaytext>
|
|
28 <displayicon src="http://authority.example.org/adult.png" />
|
|
29 </descriptorset>
|
|
|
|
30 <descriptorset node="allages">
|
|
31 <ex:agemin>0</ex:agemin>
|
|
32 <displaytext>All Ages</displaytext>
|
|
33 <displayicon src="http://authority.example.org/all.png" />
|
|
34 </descriptorset>
|
|
|
|
35 <descriptorset node="trustmark">
|
|
36 <typeof src="http://trust.example.org/vocab#trustedsite" />
|
|
37 </descriptorset>
|
|
|
|
38 <dr>
|
|
39 <iriset>
|
|
40 <includehosts>movie.example.com</includehosts>
|
|
41 <includepathstartswith>/latest</includepathstartswith>
|
|
42 </iriset>
|
|
|
|
43 <tagset>
|
|
44 <tag>New Releases</tag>
|
|
45 <tag>What's Hot</tag>
|
|
46 <seealso src="http://cinema.example.com/nowplaying/" />
|
|
47 </tagset>
|
|
48 </dr>
|
|
49 </powder>
|
|
</pre>
|
|
<p>POWDER-S [<a href="dr-example_2_14.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:ex="http://example.org/vocab#">
|
|
8
|
|
9 <owl:Ontology rdf:about="">
|
|
10 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
11 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
12 </owl:Ontology>
|
|
13
|
|
14 <owl:Class rdf:nodeID="adult">
|
|
15 <wdrs:text>Adults Only</wdrs:text>
|
|
16 <wdrs:logo rdf:resource="http://authority.example.org/adult.png" />
|
|
17 <rdfs:subClassOf>
|
|
18 <owl:Class>
|
|
19 <owl:intersectionOf rdf:parseType="Collection">
|
|
20 <owl:Restriction>
|
|
21 <owl:onProperty rdf:resource="http://example.org/vocab#agemin" />
|
|
22 <owl:hasValue>18</owl:hasValue>
|
|
23 </owl:Restriction>
|
|
24 </owl:intersectionOf>
|
|
25 </owl:Class>
|
|
26 </rdfs:subClassOf>
|
|
27 </owl:Class>
|
|
28
|
|
29 <owl:Class rdf:nodeID="allages">
|
|
30 <wdrs:text>All Ages</wdrs:text>
|
|
31 <wdrs:logo rdf:resource="http://authority.example.org/all.png" />
|
|
32 <rdfs:subClassOf>
|
|
33 <owl:Class>
|
|
34 <owl:intersectionOf rdf:parseType="Collection">
|
|
35 <owl:Restriction>
|
|
36 <owl:onProperty rdf:resource="http://example.org/vocab#agemin" />
|
|
37 <owl:hasValue>0</owl:hasValue>
|
|
38 </owl:Restriction>
|
|
39 </owl:intersectionOf>
|
|
40 </owl:Class>
|
|
41 </rdfs:subClassOf>
|
|
42 </owl:Class>
|
|
43
|
|
44 <owl:Class rdf:nodeID="trustmark">
|
|
45 <rdfs:subClassOf>
|
|
46 <owl:Class>
|
|
47 <owl:intersectionOf rdf:parseType="Collection">
|
|
48 <owl:Class rdf:about="http://trust.example.org/vocab#trustedsite" />
|
|
49 </owl:intersectionOf>
|
|
50 </owl:Class>
|
|
51 </rdfs:subClassOf>
|
|
52 </owl:Class>
|
|
53
|
|
54 <owl:Class rdf:nodeID="iriset_1">
|
|
55 <owl:equivalentClass>
|
|
56 <owl:Class>
|
|
57 <owl:intersectionOf rdf:parseType="Collection">
|
|
58 <owl:Restriction>
|
|
59 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
60 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]+\.)?(movie\.example\.com)(([0-9]+))?\/</owl:hasValue>
|
|
61 </owl:Restriction>
|
|
62 <owl:Restriction>
|
|
63 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
64 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]*)(\([0-9]+))?(\/after9pm)</owl:hasValue>
|
|
65 </owl:Restriction>
|
|
66 </owl:intersectionOf>
|
|
67 </owl:Class>
|
|
68 </owl:equivalentClass>
|
|
69 </owl:Class>
|
|
70
|
|
71 <owl:Class rdf:nodeID="iriset_1_not">
|
|
72 <owl:equivalentClass>
|
|
73 <owl:Class>
|
|
74 <owl:unionOf rdf:parseType="Collection">
|
|
75 <owl:Restriction>
|
|
76 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#notmatchesregex" />
|
|
77 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]+\.)?(movie\.example\.com)(([0-9]+))?\/</owl:hasValue>
|
|
78 </owl:Restriction>
|
|
79 <owl:Restriction>
|
|
80 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#notmatchesregex" />
|
|
81 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]*)(\([0-9]+))?(\/after9pm)</owl:hasValue>
|
|
82 </owl:Restriction>
|
|
83 </owl:unionOf>
|
|
84 </owl:Class>
|
|
85 </owl:equivalentClass>
|
|
86 </owl:Class>
|
|
87
|
|
88 <rdf:Description rdf:nodeID="iriset_1">
|
|
89 <rdfs:subClassOf rdf:nodeID="adult"/>
|
|
90 <rdfs:subClassOf rdf:nodeID"trustmark"/>
|
|
91 </rdf:Description>
|
|
92
|
|
93 <owl:Class rdf:nodeID="iriset_2">
|
|
94 <owl:equivalentClass>
|
|
95 <owl:Class>
|
|
96 <owl:intersectionOf rdf:parseType="Collection">
|
|
97 <owl:Restriction>
|
|
98 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
99 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]+\.)?(movie\.example\.com)(([0-9]+))?\/</owl:hasValue>
|
|
100 </owl:Restriction>
|
|
101 <owl:Class rdf:nodeID="iriset_1_not" />
|
|
102 </owl:intersectionOf>
|
|
103 </owl:Class>
|
|
104 </owl:equivalentClass>
|
|
105 </owl:Class>
|
|
106
|
|
107 <rdf:Description rdf:nodeID="iriset_2">
|
|
108 <rdfs:subClassOf rdf:nodeID="allages"/>
|
|
109 <rdfs:subClassOf rdf:nodeID="trustmark"/>
|
|
110 </rdf:Description>
|
|
111
|
|
112 <owl:Class rdf:nodeID="iriset_3">
|
|
113 <owl:equivalentClass>
|
|
114 <owl:Class>
|
|
115 <owl:intersectionOf rdf:parseType="Collection">
|
|
116 <owl:Restriction>
|
|
117 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
118 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]+\.)?(movie\.example\.com)(([0-9]+))?\/</owl:hasValue>
|
|
119 </owl:Restriction>
|
|
120 <owl:Restriction>
|
|
121 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
122 <owl:hasValue rdfdatatype="http://www.w3.org/2001/XMLSchema#string">\\/\/(([^\/\?\#]*)\@)?([^\\/\?\#\@]*)(\([0-9]+))?(\/latest)</owl:hasValue>
|
|
123 </owl:Restriction>
|
|
124 </owl:intersectionOf>
|
|
125 </owl:Class>
|
|
126 </owl:equivalentClass>
|
|
127 </owl:Class>
|
|
128
|
|
129 <owl:Class rdf:nodeID="tagset_1">
|
|
130 <rdf:seeAlso rdf:resource="http://cinema.example.com/nowplaying/" />
|
|
131 <rdfs:subClassOf>
|
|
132 <owl:Class>
|
|
133 <owl:intersectionOf rdf:parseType="Collection">
|
|
134 <owl:Restriction>
|
|
135 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#tag" />
|
|
136 <owl:hasValue>New Releases</owl:hasValue>
|
|
137 </owl:Restriction>
|
|
138 <owl:Restriction>
|
|
139 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#tag" />
|
|
140 <owl:hasValue>What's Hot</owl:hasValue>
|
|
141 </owl:Restriction>
|
|
142 </owl:intersectionOf>
|
|
143 </owl:Class>
|
|
144 </rdfs:subClassOf>
|
|
145 </owl:Class>
|
|
146
|
|
147 <rdf:Description rdf:nodeID="iriset_3">
|
|
148 <rdfs:subClassOf rdf:nodeID="tagset_1"/>
|
|
149 </rdf:Description>
|
|
150
|
|
151 </rdf:RDF>
|
|
</pre>
|
|
</div>
|
|
<p>As was shown in <a href="#eg2-10">Example 2-10</a> above, if the <code>src</code> attribute is set
|
|
on a <code>descriptorset</code> element in a POWDER document, then the IRI given <span id="paf5">becomes the
|
|
</span> subject of the sub-class assertion. Example 2-14 presents a different situation where the POWDER author has created some descriptor sets and then included them in the DRs. Hence the <a href="#include"><code>include</code></a> attribute is set in lines 14, 15, 21 and 22 of the POWDER document.</p>
|
|
<p>Notice also that, rather than using <code>xml:id</code> to identify the descriptor sets, the <a href="#node"><code>node</code></a> attribute is used (lines 25, 28 and 31). The transformation uses these attributes to create <code>rdf:nodeID</code> identifiers for the respective descriptor classes, as is the usual case with POWDER-S documents, so that they can only be referenced (and influenced) within the POWDER document and not from outside.</p>
|
|
<p>Line 32 of the POWDER document introduces the <a href="#typeof"><code>typeof</code></a> element. This is POWDER's method for asserting that all the resources identified in the IRI set are instances of a particular class - i.e. asserting the <code>rdf:type</code> property. In POWDER-S this is effected by asserting a sub-class relationship between the descriptor class and the referred-to class (line 45-51). In common with the <code>seealso</code>, <code>label</code> and <code>comment</code> elements, <code>typeof</code> is provided as a shortcut. Writing <code>rdf:type</code> directly in a descriptor set has exactly the same semantics.</p>
|
|
|
|
<h4 id="xmldata">2.8.2 XML Data in POWDER</h4>
|
|
<p>We noted in <a href="#lines10-15">Section 2.1</a> that the value of a descriptor may be an XML Literal. By embedding XML data directly in a
|
|
DR, it is associated with all the resources in the IRI set as shown in the following example. Note the use of
|
|
the <code>rdf:parseType="Literal"</code> attribute in line 15 of the POWDER instance and line 36 of the POWDER-S instance.</p>
|
|
<div class="example" id="eg2-15">
|
|
<p class="caption">Example 2-15: A DR that includes an XML Literal</p>
|
|
<p>POWDER [<a href="dr-example_2_15.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
|
|
2 <powder xmlns:ex="http://example.org/vocab#"
|
|
3 xmlns:ex2="http://example.org/palette#"
|
|
4 xmlns="http://www.w3.org/2007/05/powder#"
|
|
5 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
|
|
|
|
6 <attribution>
|
|
7 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
8 <issued>2007-12-14T00:00:00</issued>
|
|
9 </attribution>
|
|
|
|
10 <dr>
|
|
11 <iriset>
|
|
12 <includehosts>example.com</includehosts>
|
|
13 </iriset>
|
|
|
|
14 <descriptorset>
|
|
15 <ex:color rdf:parseType="Literal">
|
|
16 <ex2:hex>ff0000</ex2:hex>
|
|
17 <ex2:red>255</ex2:red>
|
|
18 <ex2:green>0</ex2:green>
|
|
19 <ex2:blue>0</ex2:blue>
|
|
20 </ex:color>
|
|
21 <displaytext>Everything on example.org is red</displaytext>
|
|
22 <displayicon src="http://example.org/icon.png" />
|
|
23 </descriptorset>
|
|
24 </dr>
|
|
|
|
25 </powder></pre>
|
|
|
|
<p>POWDER-S [<a href="dr-example_2_15.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:ex="http://example.org/vocab#"
|
|
8 xmlns:ex2="http://example.org/palette#">
|
|
9
|
|
10 <owl:Ontology rdf:about="">
|
|
11 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
12 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
13 </owl:Ontology>
|
|
14
|
|
15 <owl:Class rdf:nodeID="iriset_1">
|
|
16 <owl:equivalentClass>
|
|
17 <owl:Class>
|
|
18 <owl:intersectionOf rdf:parseType="Collection">
|
|
19 <owl:Restriction>
|
|
20 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
21 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(:([0-9]+))?\/</owl:hasValue>
|
|
22 </owl:Restriction>
|
|
23 </owl:intersectionOf>
|
|
24 </owl:Class>
|
|
25 </owl:equivalentClass>
|
|
26 </owl:Class>
|
|
27
|
|
28 <owl:Class rdf:nodeID="descriptorset_1">
|
|
29 <wdrs:text>Everything on example.com is red</wdrs:text>
|
|
30 <wdrs:logo rdf:resource="http://example.org/icon.png" />
|
|
31 <owl:equivalentClass>
|
|
32 <owl:Class>
|
|
33 <owl:intersectionOf rdf:parseType="Collection">
|
|
34 <owl:Restriction>
|
|
35 <owl:onProperty rdf:resource="http://example.org/vocab#color" />
|
|
36 <owl:hasValue rdf:parseType="Literal">
|
|
37 <ex2:hex>ff0000</ex2:hex>
|
|
38 <ex2:red>255</ex2:red>
|
|
39 <ex2:green>0</ex2:green>
|
|
40 <ex2:blue>0</ex2:blue>
|
|
41 </owl:hasValue>
|
|
42 </owl:Restriction>
|
|
43 </owl:intersectionOf>
|
|
44 </owl:Class>
|
|
45 </owl:equivalentClass>
|
|
46 </owl:Class>
|
|
47
|
|
48 <owl:Class rdf:nodeID="iriset_1">
|
|
49 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
50 </owl:Class>
|
|
51
|
|
52 </rdf:RDF>
|
|
</pre>
|
|
</div>
|
|
|
|
<h4 id="extensibility">2.8.3 Extensibility</h4>
|
|
<p>As the previous two sub sections aim to demonstrate, POWDER is designed to be flexible,
|
|
imposing as few constraints as possible on its structure to allow easy integration into a
|
|
variety of workflows. However, where constraints do exist, for example in only allowing literal
|
|
values for RDF properties in the descriptor set, they do so to allow at least the functional
|
|
processing of POWDER documents without an RDF toolkit. Hence, although DRs are highly flexible,
|
|
they are not extensible. The Grouping document [<a href="#group">GROUP</a>] does define a
|
|
mechanism for extending that aspect of DRs however.</p>
|
|
|
|
<h4 id="localization">2.8.4 Localization</h4>
|
|
<p>Textual content of POWDER documents may be subject to linguistic-related processes, such as translation, spell-checking, etc.
|
|
The <code>xml:lang</code> attribute can be added to any textual POWDER element within a valid document. However; its use
|
|
is only recommended for the <code>displaytext</code>, <code>comment</code>, and <code>label</code> elements.
|
|
The use of <code>xml:lang</code> on <code>tag</code> elements is not recommended since there is no way to
|
|
identify different tags as being linked. For example:</p>
|
|
|
|
<pre>
|
|
<tag xml:lang="fr">bleu</tag>
|
|
<tag xml:lang="en">square</tag>
|
|
</pre>
|
|
|
|
<p>are both valid tags for something that is square and blue but the two
|
|
are not alternative linguistic realizations of the same concept. This
|
|
becomes even more apparent when POWDER is transformed into POWDER-S.</p>
|
|
|
|
<p>The W3C Internationalization Tag Set [<a href="#its">ITS</a>] provides a convenient method to
|
|
define which parts of a document have textual content, using a rules document. POWDER's ITS Rules Document
|
|
[<a href="#itsrules">ITS-RULES</a>] declares that the <code>displaytext</code>, <code>tag</code>, <code>comment</code>,
|
|
and <code>label</code> elements contain text that may be subject to linguistic-related processes. However, such
|
|
processing is not part of POWDER and the ITS attributes are not expressed within the POWDER data model/semantics.
|
|
The ITS information is necessarily lost when performing the GRDDL transformation to POWDER-S.</p>
|
|
|
|
|
|
|
|
<h3 id="powderconformance">2.9 Conformance Statement: POWDER and POWDER-S Documents</h3>
|
|
<p>A conformant POWDER document complies with the requirements set out in sections 2.1 - 2.8 plus sections 5.2 and 5.3 of this document.</p>
|
|
<p>This document does not set any conformance criteria for POWDER-S which is encoded using OWL plus the semantic extension that is defined in the Formal Semantics document [<a href="#formal">FORMAL</a>].</p>
|
|
|
|
<!-- ############################################# POWDER PROCESSOR ################################################################-->
|
|
|
|
<h2 id="powderprocessor">3 The POWDER Processor</h2>
|
|
<p>The Protocol for Web Description Resources is designed first and foremost as a simple and efficient method of publishing metadata. A POWDER document contains sufficient information to yield a description of any resource that is within the scope of the DR(s) to which it has access. A key function of a POWDER Processor is therefore to return RDF triples that describe candidate resources.</p>
|
|
<p>If <var>u</var> is the URI or IRI of a resource, then as a minimum, a POWDER Processor MUST support the function <code>describe(<var>u</var>)</code> by returning RDF triples that describe <var>u</var>.</p>
|
|
<p>A minimal set of formal constraints are placed on how a POWDER Processor must be realized. It may be a component in a user agent or some other application that is able to process the descriptions it returns or a standalone online service. It may use HTTP to collect POWDER documents from the Web or it may act as a gateway to a repository of Description Resources. <span id="needRDF">It will be able to process XML and <span id="paf6">probably</span> RDF, and it is</span> highly likely that a real application will support a variety of different functions and options, in particular, one or more of those related to trust as discussed in <a href="#trust">Section 5</a>; however, a conformant POWDER Processor will support the key <code>describe(<var>u</var>)</code> function.</p>
|
|
<p>As an example, imagine a POWDER Processor that has access to the document shown in <a href="#eg2-1">Example 2-1</a>. The function call <code>describe('http://www.example.com/')</code> would return:</p>
|
|
<pre>
|
|
<rdf:Description rdf:about="http://www.example.com/">
|
|
<ex:color>red</ex:color>
|
|
<ex:shape>square</ex:shape>
|
|
<wdrs:describedby rdf:resource="http://...example2-1.xml" />
|
|
</rdf:Description></pre>
|
|
<p>Notice that the description includes a link to the POWDER document from which the data was derived (this is optional). The <code>wdrs:describedby</code> property is discussed further in <a href="#semlink">Section 4.1.3</a> below.</p>
|
|
<p>Where a POWDER Processor has a Web interface, <code>describe(<var>u</var>)</code> SHOULD be the default function available by sending an HTTP GET request to its IRI and including the candidate resource as the value for the parameter <var>u</var> in the query string. The query string should be URL-encoded as defined by XForms 1.0 [<a href="#xf">XF</a>] such that, if <var>ipp</var> is the IRI of the POWDER Processor, then the above request for a description of http://www.example.com/ would be made by dereferencing the following IRI:</p>
|
|
<p><code><var>ipp</var>?u=http%3A%2F%2Fwww.example.com%2F</code></p>
|
|
<p>which would return the RDF/XML document shown below</p>
|
|
<div class="example" id="eg3-1">
|
|
<p class="caption">Example 3-1: Example Result from a POWDER Processor [<a href="example_3_1.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
<rdf:RDF
|
|
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
xmlns:ex="http://example.org/vocab#"
|
|
xmlns:wdrs="http://www.w3.org/2007/05/powder-s#">
|
|
|
|
<rdf:Description rdf:about="http://www.example.com/">
|
|
<ex:color>red</ex:color>
|
|
<ex:shape>square</ex:shape>
|
|
<wdrs:describedby rdf:resource="http://...example2-1.xml" />
|
|
</rdf:Description>
|
|
|
|
</rdf:RDF></pre></div>
|
|
<p>If the processor can find no information about the candidate resource within the data available at the time of the request, then it uses the <a href="#notknownto"><code>wdrs:notknownto</code></a> property to return the 'not known' message shown below.</p>
|
|
<div class="example" id="eg3-2">
|
|
<p class="caption">Example 3-2: Example 'Not Known Result' from a POWDER Processor [<a href="example_3_2.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0"?>
|
|
<rdf:RDF
|
|
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
xmlns:wdrs="http://www.w3.org/2007/05/powder-s#">
|
|
|
|
<rdf:Description rdf:about="http://www.example.com/">
|
|
<wdrs:notknownto rdf:resource="<var>ipp</var>" />
|
|
</rdf:Description>
|
|
|
|
</rdf:RDF></pre></div>
|
|
<p>The range of <code>wdrs:notknownto</code> is the class <a href="#Processor"><code>wdrd:Processor</code></a>, defined as the class of POWDER Processors.</p>
|
|
<p>The value for <var>u</var> may be replaced by the word 'referer', in which case the POWDER Processor SHOULD return a description of the IRI given in the HTTP REFERER field (or the not known response). This allows a POWDER Processor to return descriptions of resources that point to it. For example, an XHTML document published at http://www.example.com/ might include the following link element:</p>
|
|
<p><code><link rel="meta" href="<var>ipp</var>?u=referer" type="application/rdf+xml" /></code></p>
|
|
<p>User agents following that link would receive the response shown in <a href="#eg3-1">Example 3-1</a>. (N.B. Only the behavior of the POWDER processor is specified here; the relationship type of meta is non-normative in this context).</p>
|
|
<p>The <code>describe(<var>u</var>)</code> function SHOULD also support an additional optional parameter, <var>d</var>. This is the IRI of a POWDER document and may include a fragment identifier as discussed in <a href="#directDescript">Section 2.5</a>. Referring to <a href="#eg2-9">Example 2-9</a> we can envisage a document at http://www.example.com/page.html that includes a link element pointing to /powder.xml#red and construct the function call:</p>
|
|
<p><code>describe(<var>http://www.example.com/page.html</var>, <var>http://www.example.com/powder.xml#red</var>)</code></p>
|
|
<p>or over HTTP as</p>
|
|
<p><code><var>ipp</var>?u=http%3A%2F%2Fwww.example.com%2F&d=http%3A%2F%2Fwww.example.com%2Fpowder.xml%23red</code></p>
|
|
<p>Alternatively, the document at http://www.example.com/page.html might simply point directly to the POWDER processor with the following link:</p>
|
|
<p><code><link rel="meta" href="<var>ipp</var>?u=referer&d=http%3A%2F%2Fwww.example.com%2Fpowder.xml%23red" type="application/rdf+xml" /></code></p>
|
|
<p>Dereferencing that IRI returns RDF triples about that specific document.</p>
|
|
|
|
<h3 id="ppErrorhandling">3.1 Error Handling</h3>
|
|
<p>In addition to the descriptive or 'not known' responses, a POWDER Processor SHOULD also report errors of which there are two distinct types: data errors and processing errors. We reserve the generic error codes 100 and 200 respectively for these two types of error, with implementers free to define appropriate codes in the range 1xx and 2xx. A client will therefore always be able to determine which type of error has been reported even if it cannot understand the precise nature of that error.</p>
|
|
<p>Only one specific error is defined for all conformant POWDER processors: error 101 is raised when a candidate resource is within the scope of a DR that refers to a descriptor set that, through an <a href="#abouthosts"><code>abouthosts</code></a> restriction, cannot apply. This can happen, for example, where the descriptor set and DR are defined separately as shown in <a href="#preDefinedDescriptors">Section 2.6</a>.</p>
|
|
<p>Errors are reported using the <a href="#data_error"><code>wdrs:data_error</code></a>, <a href="#proc_error"><code>wdrs:proc_error</code></a> and <a href="#err_code"><code>wdrs:err_code</code></a> properties. If <var>data</var> is the IRI of the POWDER document containing the erroneous data, then the processor should return:</p>
|
|
<pre>
|
|
<rdf:Description rdf:about="<var>data</var>">
|
|
<wdrs:err_code>101</wdrs:err_code>
|
|
<wdrs:data_error>Description Resource refers to a descriptor set that is out of scope</wdrs:data_error>
|
|
</rdf:Description>
|
|
</pre>
|
|
<p>In similar fashion, if <var>ipp</var> is the identifier for the processor itself, then an internal error might be reported thus:</p>
|
|
<pre>
|
|
<rdf:Description rdf:about="<var>ipp</var>">
|
|
<wdrs:err_code>214</wdrs:err_code>
|
|
<wdrs:proc_error>Error in subroutine foo at line x</wdrs:proc_error>
|
|
<rdf:Description>
|
|
</pre>
|
|
|
|
<h3 id="conformance">3.2 POWDER Processor Conformance Statement</h3>
|
|
<p>A conformant POWDER Processor will support the <code>describe(<var>u</var>)</code> function in accordance with the specifications set out in this document and those to which it refers as follows. The POWDER processor:</p>
|
|
<div class="semext">
|
|
<ul>
|
|
<li>MUST include the ability to process POWDER-BASE documents;</li>
|
|
<li>SHOULD include the ability to process POWDER documents;</li>
|
|
<li>SHOULD return an informative message if passed a POWDER or POWDER-S document if these are not supported;</li>
|
|
</ul>
|
|
<p>For the purposes of the remaining conformance statements, the term POWDER document should be taken to mean both POWDER and POWDER-BASE documents. Similarly, the references to <code>abouthosts</code> apply equally to <code>aboutregex</code> in POWDER-BASE.</p>
|
|
<ul>
|
|
<li>SHOULD be able to retrieve POWDER documents from the Web using HTTP; [<a href="#pp3">Section 2.6</a>]</li>
|
|
<li>MAY include the ability to process POWDER-S documents;</li>
|
|
<li>MUST check all POWDER documents used in returning a description of <var>u</var> for the presence of the abouthosts element; [<a href="#pp1">Section 2.3</a>, <a href="#pp2">Section 2.6</a>]</li>
|
|
<li>MUST ignore all POWDER documents where abouthosts is present and the host component of <var>u</var> is not the same as, or is not a subdomain of, at least one of the hosts listed in <code>abouthosts</code>;</li>
|
|
<li>SHOULD return an error if, after this filtering, a DR in an available document refers to a descriptor set defined in one that is not available;</li>
|
|
<li>If available through a Web interface, the parameter names <var>u</var> and <var>d</var> MUST be used for the IRI of the resource to be described, and the data source from which the description is to be extracted, respectively;</li>
|
|
<li>MAY use one or more instances of the <code>wdrs:describedby</code> property to point to the POWDER document(s) from which the description was obtained;</li>
|
|
<li>SHOULD return other error messages, such as detecting that a POWDER document is invalid, unavailable over the network, etc.;</li>
|
|
<li>SHOULD NOT, where <var>IRI<sub>1</sub></var> is in scope of a given DR and dereferencing it redirects to <var>IRI<sub>2</sub></var>, automatically treat <var>IRI<sub>2</sub></var> as also being in scope of that DR.</li>
|
|
</ul>
|
|
</div>
|
|
<p>(see the <a href="#formal">Formal Semantics</a> document for details of each POWDER format).</p>
|
|
<p>The distinctions between how the different encodings of Description Resources arise because all POWDER documents can be transformed into POWDER-BASE. As the name suggests, this is the fundamental format. However, IRI sets are much more easily defined by humans using POWDER, and it is anticipated that it will be the predominant format. Where the processor is associated with a data source that does not make use of POWDER, perhaps using a different transform to create POWDER-BASE from a proprietary format and, due to its application environment, it is known with a high degree of certainty that it will never have to process POWDER documents from other sources, then it clearly will not have to support it (or POWDER-S).</p>
|
|
<p>POWDER-S is defined to allow Description Resources to be processed as part of the more general Semantic Web. The application context must therefore determine whether a POWDER processor should support it.</p>
|
|
<p>There is no requirement for a processor to use the <span id="f-norm">XSLTs provided by the Working Group to effect the transforms associated with the POWDER namespaces. The Formal Semantics document [<a href="#formal">FORMAL</a>] is normative, not the XSLTs.</span></p>
|
|
<p>As noted, there are no other formal conformance criteria for a POWDER Processor; however, good implementations will go significantly further. For example, they may:</p>
|
|
<ul id="newExtras">
|
|
<li>return results as RDF in alternative serializations or as HTML;</li>
|
|
<li>support lists of POWDER documents as a data source;</li>
|
|
<li>implement a variety of policies to take account of the attribution data when responding to requests;</li>
|
|
<li>return richer results detailing the processing that has been carried out;</li>
|
|
<li>provide an option to include IRIs discovered when one that is in the scope of a DR redirects to one that is not.</li>
|
|
</ul>
|
|
<p>The inverse of the <code>describe(<var>u</var>)</code> function — 'find resources with these properties' — would be very useful in several of the scenarios set out in the POWDER <a href="#usecases">use cases</a>. Where the processor is acting as a gateway to a specific repository it is likely to be possible to specify a simple syntax for queries that would return DRs or IRI sets that include descriptor sets matching given properties. Since a descriptor set may contain RDF/XML with few constraints, a fully flexible function of this type could only be provided by supporting <a href="#sparql">SPARQL</a> queries against POWDER-S documents, noting that this requires an implementation of the POWDER semantic extension by the requesting agent.</p>
|
|
|
|
<!-- ######################################################################### LINKAGE ############################################## -->
|
|
<h2 id="assoc">4 Associating Resources and DRs</h2>
|
|
<h3 id="assoc-linking">4.1 Linking a Resource to a POWDER Document: Relationship and Media types</h3>
|
|
<p>A given resource (hereafter known as the <em>described resource</em>) may relate itself to a POWDER document. There
|
|
are several methods to define such a relationship, detailed in the following sub-sections. To facilitate linking
|
|
between a described resource and a POWDER document we define a relationship type of <strong>describedby</strong> for
|
|
use in (X)HTML <code>link</code> elements<span id="atom1">, HTTP Link Headers and ATOM feeds; and a textually
|
|
identical term as part of the POWDER-S vocabulary. This is a generic relationship type that does not of itself imply
|
|
that the link points to a POWDER document — that is done by the specific <a href="#mime">Media</a> type.
|
|
The formal definition of describedby is given in <a href="#appD">Appendix D</a>.</span></p>
|
|
<p>We define the following Media types for POWDER and POWDER-BASE documents:</p>
|
|
<p style="margin-left:2em"><code id="app2">application/powder+xml</code> [<a href="#appB">Appendix B</a>]</p>
|
|
<p>and for POWDER-S documents:</p>
|
|
<p style="margin-left:2em"><code>application/powder-s+xml</code> [<a href="#appC">Appendix C</a>]</p>
|
|
|
|
<h4 id="assoc-markup">4.1.1 (X)HTML <code>link</code> Elements</h4>
|
|
<p>In HTML and XHTML documents, the <code>link</code> element can be used to point to a POWDER document with the relationship type of 'describedby' as shown in Example.4-1 below. The relationship type is defined in the <a href="http://www.w3.org/2007/11/powder-profile">POWDER profile</a> document, which should therefore be referenced in the <code>head</code> tag when using a version of HTML that supports it.</p>
|
|
<p>Documents MAY also include any of the attribution data from the POWDER document in meta tags. In particular, the <code>issuedby</code> field is likely to be useful to user agents deciding whether or not to fetch the full POWDER document. Any attribution data encoded in meta tags within an HTML document should be the same as that in the POWDER document. In case of discrepancy, the POWDER document should be taken as more authoritative.</p>
|
|
<p>N.B. the value of the <code>rel</code> attribute is a white space separated list so other relationship types may be included too. For example, it may be desirable to give processors a clue as to which descriptive vocabulary or vocabularies is/are used in the DR(s) in the POWDER document. Again, such relationship types may need to be defined in a profile document.</p>
|
|
<div class="example" id="eg4-1">
|
|
<p class="caption">Example 4-1: using the <code>link</code> element to relate an XHTML document to a DR [<a href="example_4_1.html">HTML</a>]</p>
|
|
<pre>
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head profile="http://www.w3.org/2007/11/powder-profile">
|
|
<meta name="wdr.issuedby" content="http://authority.example.org/company.rdf#me"/>
|
|
<link rel="describedby" href="powder.xml" <span id="app3">type="application/powder+xml"</span>/>
|
|
<title>Welcome to example.com </title>
|
|
</head>
|
|
<body>
|
|
<p>Today's content is …</p>
|
|
</body>
|
|
</html>
|
|
</pre></div>
|
|
<p>This approach requires the described resource to be requested and parsed in order to find the relevant POWDER document's location. This may be acceptable for data warehousing, for example retrieving DRs asynchronously to a user request, so that the metadata about the described resource can be inspected and usage trends compiled. However a more efficient method of associating resources with a POWDER document is to use the HTTP Link Header.</p>
|
|
|
|
<!-- ######################## ATOM ######################## -->
|
|
|
|
<h4 id="atom">4.1.2 ATOM <code>link</code> Elements</h4>
|
|
<p>POWDER may provide useful annotations in ATOM syndication feeds, again with the <code>describedby</code> property providing
|
|
the link's relationship type. Example 4-2 shows such an annotated ATOM feed.</p>
|
|
|
|
<p>In accordance with the ATOM specification [<a href="#rfc4287">RFC4287</a>], the describedby relationship is a relative URI, the base of which is
|
|
http://www.iana.org/assignments/relation/ - i.e. the full URI of describedby is http://www.iana.org/assignments/relation/describedby - and this is
|
|
included in the ATOM registry [<a href="#areg">AREG</a>].</p>
|
|
<div class="example" id="eg4-2">
|
|
<p class="caption">Example 4-2: ATOM feed with links to POWDER documents [<a href="example_4_2.xml">XML</a>]</p>
|
|
<pre>
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|
<feed
|
|
xmlns="http://www.w3.org/2005/Atom">
|
|
<strong><link rel="describedby" href="http://ecw.example.org/powder1.xml" /></strong>
|
|
<title>The English Civil War</title>
|
|
<link href="http://ecw.example.org/"/>
|
|
<updated>2007-10-30T15:00:00Z</updated>
|
|
<author>
|
|
<name>John Doe</name>
|
|
</author>
|
|
<id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
|
|
|
|
<entry>
|
|
<title>Charles I</title>
|
|
<link href="http://ecw.example.org/charles1.html"/>
|
|
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
|
|
<updated>2007-06-04T09:39:21Z</updated>
|
|
<summary>Charles I came to the throne believing in his Divine Right to rule...</summary>
|
|
</entry>
|
|
|
|
<entry>
|
|
<strong><link rel="describedby" href="http://monarchy.example.org/powder2.xml" /></strong>
|
|
<title>Divine Right</title>
|
|
<link href="http://monarchy.example.org/divine_right.html"/>
|
|
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6b</id>
|
|
<updated>2007-06-06T13:43:54Z</updated>
|
|
<summary>Divine Right was claimed by several English monarchs, notably Charles I...</summary>
|
|
</entry>
|
|
|
|
</feed>
|
|
</pre>
|
|
</div>
|
|
<p>The feed element is linked to powder1.xml which is a hint, not a guarantee, that it describes many or all of the items in the feed. The second item in the feed is described by a different POWDER document.</p>
|
|
<p>It is worth noting that the structure of the ATOM feed plays no part in determining what is described by the POWDER documents — this is only defined in the IRI sets within the DRs they contain. For the avoidance of doubt, powder1.xml does not fulfil the role of 'default' description that is then overridden by powder2.xml.</p>
|
|
|
|
|
|
|
|
<!-- ########################################### HTTP Link ################################### -->
|
|
<h4 id="httplink">4.1.3 HTTP Link Headers (Informative)</h4>
|
|
<p>This sub-section is marked informative (cf. normative) in recognition that, at the time of
|
|
writing, <em>Link Relations and HTTP Header Linking</em> [<a href="#hlink">HLINK</a>] is an Internet Draft. It is anticipated
|
|
that, following further review, it will become an RFC.</p>
|
|
<p>The HTTP Link Header [<a href="#hlink">HLINK</a>] is an alternative to the HTML <code>link</code> element and has very similar
|
|
semantics such that the HTML <code>link</code> shown in Example 4-1 above can be expressed as follows:</p>
|
|
<p><code>Link: <powder.xml>; rel="describedby" <span id="app4">type="application/powder+xml"</span>;</code></p>
|
|
|
|
<p>User agents may discover the location of the POWDER document by inspecting the HTTP Response headers and passing it to a POWDER processor without having to parse the resource itself. This has several distinct advantages:</p>
|
|
<ul>
|
|
<li>A HEAD request would reveal the location of the POWDER document, which could then be processed before deciding whether to fetch the described resource itself. This has particular applicability to access control and content personalization.</li>
|
|
<li>The POWDER document may be fetched asynchronously by the user agent before the described resource has been processed, maximizing processing efficiency where this is important.</li>
|
|
<li>The HTTP Link header can be applied to any type of resource, not just formats that support a link element of their own such as (X)HTML.</li>
|
|
<li>Server configuration is often a very efficient way to link all resources on a Web site to a central resource (including stylesheets and script libraries as well as POWDER documents).</li>
|
|
</ul>
|
|
|
|
|
|
<!-- ######################################## describedby ############################################### -->
|
|
|
|
<h4 id="semlink">4.1.4 Semantic Linkage Using the <code>describedby</code> Property</h4>
|
|
<p>We define the RDF property <a href="#describedby"><code>wdrs:describedby</code></a> with a domain of
|
|
rdf:Resource and a range of <code><a href="#Document">wdrs:Document</a></code>. This is the class of POWDER documents and is a sub class of <span id="paf7"><code>owl:Ontology</code></span>.
|
|
<span>The meaning of <code>wdrs:describedby</code> is identical to the <code>describedby</code> relationship type defined above so that:</span></p>
|
|
|
|
<div id="atom2">
|
|
<p><code> http://www.w3.org/2007/05/powder-s#describedby</code></p>
|
|
<p>and</p>
|
|
<p><code>http://www.iana.org/assignments/relation/describedby</code></p>
|
|
<p>have the same meaning and could be used interchangeably although the context in which they are used will usually determine which is the more appropriate.
|
|
|
|
For example, in formats that support RDF properties directly it is appropriate to link a resource to a POWDER document that
|
|
describes it through the <code>wdrs:describedby</code> predicate rather than the <code>describedby</code> relationship type.
|
|
A document might be part of a collection about a particular topic described in a DR. Such a document might be annotated using
|
|
<a href="#rdfa">RDFa</a> as shown in example 4-3 below.</p>
|
|
</div>
|
|
<div class="example" id="eg4-3">
|
|
<p class="caption">Example 4-3: RDFa snippet using <code>wdrs:describedby</code> [<a href="example_4_3.html">HTML</a>]</p>
|
|
<pre>
|
|
1 <html
|
|
2 xmlns="http://www.w3.org/1999/xhtml" version="XHTML+RDFa 1.0"
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#">
|
|
4 <head>
|
|
5 <title>The English Civil War</title>
|
|
6 <link rel="wdrs:describedby" href="http://ecw.example.org/powder1.xml" <span id="app5">type="application/powder+xml"</span> />
|
|
7 </head>
|
|
8 <body>
|
|
9 …
|
|
10 <p>Charles I came to the throne believing in his
|
|
11 <a href="http://monarchy.example.org/divine_right.html">Divine Right</a> to rule…
|
|
12 …
|
|
13 </body>
|
|
14 </html>
|
|
</pre>
|
|
</div>
|
|
<p>Here the active document is linked to a description through the <code>link</code> element in the <code>head</code> with the relationship type defined using the <code>wdrs:describedby</code> property (line 6). The POWDER document (powder1.xml) SHOULD describe the active document and may or may not provide a description of other resources linked from it. For the purposes of this example we'll assume that powder1.xml describes the whole of the Web site that includes this document as being a source of information that is recommended for school study of the English Civil War.</p>
|
|
<p>Notice that the text in example 4-3 includes a link to another document on another host in line 11 (divine_right.html). Suppose that document, and others on the monarchy.example.org Web site, are described by a different POWDER document. It is possible to use RDFa to link to a POWDER document describing divine_right.html as shown in lines 11-13 in example 4-4 below.</p>
|
|
<div class="example" id="eg4-4">
|
|
<p class="caption">Example 4-4: RDFa snippet using two <code>wdrs:describedby</code> properties [<a href="example_4_4.html">HTML</a>]</p>
|
|
<pre>
|
|
1 <html
|
|
2 xmlns="http://www.w3.org/1999/xhtml" version="XHTML+RDFa 1.0"
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#">
|
|
4 <head>
|
|
5 <title>The English Civil War</title>
|
|
6 <link rel="wdrs:describedby" href="http://ecw.example.org/powder1.xml" />
|
|
7 </head>
|
|
8 <body>
|
|
9 …
|
|
10 <p>Charles I came to the throne believing in his
|
|
11 <a about="http://monarchy.example.org/powder2.xml"
|
|
12 rev="wdrs:describedby"
|
|
13 href="http://monarchy.example.org/divine_right.html">Divine Right</a> to rule...
|
|
14 …
|
|
15 </body>
|
|
16 </html>
|
|
</pre>
|
|
</div>
|
|
<p>Note the use of the <code>rev</code> relationship type in line 12 which effectively switches round the subject and object of the triple. An RDFa processor will extract the following two triples from this snippet:</p>
|
|
<pre>
|
|
<> wdr<span id="typo_24_1">s</span>:describedby <http://ecw.example.org/powder1.xml>
|
|
<http://monarchy.example.org/divine_right.html> wdr<span id="typo_24_2">s</span>:describedby <http://monarchy.example.org/powder2.xml></pre>
|
|
<p>A POWDER-aware Web browser may use the description provided in powder2.xml to decide to render the hyperlink in different ways. For example, if the document about Divine Right is not suitable for display on mobile devices, the browser may not include the hyperlink at all when the primary document is viewed on a handheld device but would do so on a desktop device.</p>
|
|
|
|
<h3 id="linktopp">4.2 Linking a Resource to a POWDER Processor to Acquire RDF</h3>
|
|
<p>As described in <a href="#powderprocessor">Section 3</a>, a POWDER processor may be set up as an online service through which RDF triples about a particular resource may be obtained. The simplest way to achieve this is to append the IRI of the POWDER processor with <code>?u=referer</code>, adding the IRI of a POWDER data source if necessary, and include it in either an HTML or HTTP Link.</p>
|
|
<p>RDF-aware user agents, including those without any POWDER implementation, will be able to process the data received.</p>
|
|
|
|
<h3 id="linkingDRdocs">4.3 Linking POWDER documents</h3>
|
|
<p>POWDER documents may refer to each other to facilitate easier discovery by user agents. The <a href="#more"><code>more</code></a> element is a child element of the root element, may appear any number of times, and uses the <code>src</code> attribute to point to external POWDER documents. The data is retained in POWDER-S where it becomes an <code>rdfs:seeAlso</code> property with the POWDER-S document as its subject, as shown in Example 4-5 below.</p>
|
|
<div class="example" id="eg4-5">
|
|
<p class="caption">Example 4-5: A POWDER Document Linking to Another</p>
|
|
<p>POWDER [<a href="dr-example_4_5.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#"
|
|
3 xmlns:ex="http://example.org/vocab#">
|
|
|
|
4 <strong><more src="http://another.example.com/powder2.xml" /></strong>
|
|
|
|
5 <attribution>
|
|
6 <issuedby <span id="typo1">src</span>="http://authority.example.org/company.rdf#me" />
|
|
7 <issued>2007-12-14T00:00:00</issued>
|
|
8 </attribution>
|
|
|
|
9 <dr>
|
|
10 <iriset>
|
|
11 <includehosts>example.com</includehosts>
|
|
12 </iriset>
|
|
|
|
13 <descriptorset>
|
|
14 <ex:color>red</ex:color>
|
|
15 <ex:shape>square</ex:shape>
|
|
16 <displaytext>Everything on example.org is red and square</displaytext>
|
|
17 <displayicon src="http://example.org/icon.png" />
|
|
18 </descriptorset>
|
|
19 </dr>
|
|
|
|
20 </powder>
|
|
</pre>
|
|
<p>POWDER-S [<a href="dr-example_4_5.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:ex="http://example.org/vocab#">
|
|
8
|
|
9 <owl:Ontology rdf:about="">
|
|
10 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
11 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
12 <strong><rdfs:seeAlso rdf:resource="http://another.example.com/powder2.xml" /></strong>
|
|
13 </owl:Ontology>
|
|
14
|
|
15 <owl:Class rdf:nodeID="iriset_1">
|
|
16 <owl:equivalentClass>
|
|
17 <owl:Class>
|
|
18 <owl:intersectionOf rdf:parseType="Collection">
|
|
19 <owl:Restriction>
|
|
20 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
21 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(:([0-9]+))?\/</owl:hasValue>
|
|
22 </owl:Restriction>
|
|
23 </owl:intersectionOf>
|
|
24 </owl:Class>
|
|
25 </owl:equivalentClass>
|
|
26 </owl:Class>
|
|
27
|
|
28 <owl:Class rdf:nodeID="descriptorset_1">
|
|
29 <wdrs:text>Everything on example.com is red and square</wdrs:text>
|
|
30 <wdrs:logo rdf:resource="http://example.org/icon.png" />
|
|
31 <rdfs:subClassOf>
|
|
32 <owl:Class>
|
|
33 <owl:intersectionOf rdf:parseType="Collection">
|
|
34 <owl:Restriction>
|
|
35 <owl:onProperty rdf:resource="http://example.org/vocab#color" />
|
|
36 <owl:hasValue>red</owl:hasValue>
|
|
37 </owl:Restriction>
|
|
38 <owl:Restriction>
|
|
39 <owl:onProperty rdf:resource="http://example.org/vocab#shape" />
|
|
40 <owl:hasValue>square</owl:hasValue>
|
|
41 </owl:Restriction>
|
|
42 </owl:intersectionOf>
|
|
43 </owl:Class>
|
|
44 </rdfs:subClassOf>
|
|
45 </owl:Class>
|
|
46
|
|
47 <owl:Class rdf:nodeID="iriset_1">
|
|
48 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
49 </owl:Class>
|
|
50
|
|
51 </rdf:RDF>
|
|
</pre>
|
|
</div>
|
|
<p>Example 4-5 is a repeat of Examples <a href="#eg2-1">2-1</a> and <a href="#eg2-3">2-3</a> to show the <code>more</code> element.</p>
|
|
|
|
|
|
|
|
<!-- #################################################### DR froma Repository ############################# -->
|
|
|
|
|
|
<h3 id="DRfromRepository">4.4 Requesting a DR from a Repository</h3>
|
|
<p>There are no normative rules on how to publish large numbers of Description Resources. However, individuals or organizations that create DRs are encouraged to make them available both as POWDER and POWDER-S documents. The latter would best be exposed through a <a href="#sparql">SPARQL</a> endpoint. It is noteworthy that if a POWDER document is edited, it SHOULD be made available at a new IRI. As a practical step, that IRI is generally best discovered through an HTTP 302 redirect from an IRI published as the 'latest location.'</p>
|
|
<p>The publisher is, of course, free to set up whatever system they feel appropriate, but as there are no normative rules it is essential to provide adequate documentation, perhaps including sample queries that yield results that can be processed efficiently.</p>
|
|
<p>Examples are provided in the <a href="#primer">Primer</a>.</p>
|
|
|
|
<!-- ################################################ TRUST ############################# -->
|
|
<!-- #################################################################################### -->
|
|
|
|
<h2 id="trust">5 Trust</h2>
|
|
<p>Trust is a critical aspect of Description Resources; however, trust is very much a matter of opinion. The level of trust demanded of a given DR will depend on what the description says and to what use it will be put. For example, an individual user finding a DR that declares a Web site to offer children's birthday party ideas can make his/her own assessment of its quality and usefulness. In contrast, a multi-million dollar business will need very strong assurance that a DR declaring a Web site to be medically accurate and freely available is trustworthy before including it in a portal of high quality license-free, healthcare materials. For this reason, we do not define a single trust mechanism that must be used. Rather, the following sections describe a variety of different methods of adding trust to DRs, some of which may be used in combination. Where applicable, we define vocabulary terms designed to aid the building of trust.</p>
|
|
<p>These measures add to POWDER's inherent trust model, namely:</p>
|
|
<ul>
|
|
<li>All (valid) POWDER documents are attributed so that it is always clear who one should ask 'did you really say that?'</li>
|
|
<li>The document structure, whether in POWDER or POWDER-S, does not allow for the semantics to be amended or expanded upon by publishing other data elsewhere on the Web (unless the author specifically wants to make his/her descriptions available for use by others). </li>
|
|
</ul>
|
|
|
|
<h3 id="discover">5.1 Discovering the Trust Mechanism: the <code>authenticate</code> Property</h3>
|
|
<p>Any method provided by a DR author for adding trust to their descriptions needs to be discoverable. To this end, we define
|
|
the <a href="#authenticate"><code>authenticate</code></a> property with a domain of <code>dcterms:Agent</code> and <code>foaf:Agent</code>.
|
|
That is, it's part of the description of an entity that creates POWDER documents, not of the POWDER documents themselves.
|
|
The range of <code>authenticate</code> is simply rdfs:Resource and so its value can be machine-processable, such as a <a href="#wsdl">WSDL</a> document, or a human-readable document describing any authentication services that the DR author offers or steps he/she recommends. The following snippet <span id="noInlineFOAF5">of RDF shows a <code>foaf:Organization</code> class (a subclass of <code>foaf:Agent</code>) such as might be pointed to by the <code>src</code> attribute of an <code>issuedby</code> element</span>. It includes a pointer to a document that describes how to authenticate the Exemplary Description Authority's POWDER documents.</p>
|
|
<pre style="overflow:auto">
|
|
<foaf:Organization rdf:ID="me">
|
|
<foaf:homepage rdf:resource="http://authority.example.org/" />
|
|
<foaf:name>The Exemplary Description Authority</foaf:name>
|
|
<foaf:nick>EDA</foaf:nick>
|
|
<strong><authenticate rdf:resource="http://authority.example.org/how_to_authenticate.html" /></strong>
|
|
</foaf:Organization>
|
|
</pre>
|
|
|
|
<h3 id="certification">5.2 Certification using POWDER</h3>
|
|
<p>Trust in Description Resources may readily be enhanced through third-party certification. That is, an entity can publish data that is identifiable through its origin and/or a digital signature that states that the named entity certifies that the claims and assertions made in an identified POWDER document are correct. The level of trust that can be placed in the data then becomes equivalent to the level of trust held in the certification body. Such certificates may themselves by expressed in a DR as exemplified below.</p>
|
|
<div class="example" id="eg5-1">
|
|
<p class="caption">Example 5-1: Example of a Certificate, expressed as a DR [<a href="dr-example_5_1.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#">
|
|
|
|
3 <attribution>
|
|
4 <issuedby src="http://authority.example.org/company.rdf#me" />
|
|
5 <issued>2007-12-14T00:00:00</issued>
|
|
6 <validfrom>2008-01-01T00:00:00</validfrom>
|
|
7 <validuntil>2008-12-31T23:59:59</validuntil>
|
|
8 </attribution>
|
|
|
|
9 <dr>
|
|
10 <iriset>
|
|
11 <includeresources>http://www.example.com/powder.xml</includeresources>
|
|
12 </iriset>
|
|
|
|
13 <descriptorset>
|
|
14 <sha1sum>j6lwx3rvEPO0vKtMup4NbeVu8nk=</sha1sum>
|
|
15 <certified>true</certified>
|
|
16 <displaytext>authority.example.org certifies that claims made by example.com are true. Valid throughout 2008.</displaytext>
|
|
17 <displayicon src="http://authority.example.org/icon.png" />
|
|
18 </descriptorset>
|
|
19 </dr>
|
|
10 </powder></pre></div>
|
|
<p>This example introduces a number of features.</p>
|
|
<p>It is the nature of certificates that they have a period of validity. Trustmarks are typically awarded for a period of a year, for example. To support this, POWDER defines two elements: <a href="#validfrom"><code>validfrom</code></a> and <a href="#validuntil"><code>validuntil</code></a> in lines 6 and 7. These elements are of type xsd:date and have the following operational semantics:</p>
|
|
<p>A POWDER document is temporally valid unless:</p>
|
|
<ul>
|
|
<li>there is a <code>validfrom</code> element present and today's date precedes it</li>
|
|
<li>there is a <code>validuntil</code> date and today's date is after the date given.</li>
|
|
</ul>
|
|
<p>Temporal validity is independent of trust; that is, a POWDER document that is temporally invalid may be trusted by a user (or user agent). Similarly, a temporally valid document may not be trusted. However, from a policy perspective, the publisher of any Description Resource should be prepared to stand by their claims for the entirety of any stated validity period.</p>
|
|
<p>If an HTTP cache header is set, the valid until dates are only applicable within the expiry period. Thus a processor MAY NOT continue to use the DR beyond its cache period until a fresh copy of the DR has been retrieved.</p>
|
|
<p>There are no formal semantics associated with <code>validfrom</code> and <code>validuntil</code>.</p>
|
|
<p>There are two further features shown in Example 5-1 that have not been discussed in this document previously.</p>
|
|
<p>In line 14, the descriptor set includes the <a href="#sha"><code>sha1sum</code></a> element which contains a SHA-1 Sum of the (one) described resource. Although not formalized in the semantics of POWDER, this element provides processors with an integrity checking mechanism. The publisher of Example 5-1 is providing a very precise description of the document at http://www.example.com/powder.xml. User agents are therefore empowered to calculate a SHA-1 hash of the described resource and use that to decide whether or not to trust the data. The <code>sha1sum</code> descriptor takes a single hash as its value and may only appear once in a descriptor set. It is therefore only useful when describing a single resource, as is the case in Example 5-1.</p>
|
|
<p>Since the expression of certificates in this way is at the heart of several POWDER use cases [<a href="#usecases">USECASES</a>], we also define the <a href="#certified"><code>certified</code></a> element which has a data type of xsd:boolean.</p>
|
|
<p id="err4">The inverse relationship is also supported by the <a href="#certifiedby"><code>certifiedby</code></a> element. That is, the <code>attribution</code> element in http://www.example.com/powder.xml may include a pointer to this certificate by giving its IRI as the value of the <code>src</code> attribute of the <code>certifiedby</code> element. Only complete POWDER documents may be certified, not individual DRs.</p>
|
|
<p>Example 5-1 is shown in its Semantic POWDER form below.</p>
|
|
<div class="example" id="eg5-2">
|
|
<p class="caption">Example 5-2: Example of the certificate in Example 5-1, expressed in POWDER-S [<a href="dr-example_5_1.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:ex="http://example.org/vocab#">
|
|
8
|
|
9 <owl:Ontology rdf:about="">
|
|
10 <wdrs:issuedby rdf:resource="http://authority.example.org/company.rdf#me" />
|
|
11 <wdrs:issued>2007-12-14T00:00:00</wdrs:issued>
|
|
12 <wdrs:validfrom>2008-01-01T00:00:00</wdrs:validfrom>
|
|
13 <wdrs:validuntil>2008-12-31T23:59:59</wdrs:validuntil>
|
|
14 </owl:Ontology>
|
|
15
|
|
16 <owl:Class rdf:nodeID="iriset_1">
|
|
17 <owl:equivalentClass>
|
|
18 <owl:Class>
|
|
19 <owl:intersectionOf rdf:parseType="Collection">
|
|
20 <owl:Restriction>
|
|
21 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
22 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">^(http\:\/\/www\.example\.com\/powder\.xml)$</owl:hasValue>
|
|
23 </owl:Restriction>
|
|
24 </owl:intersectionOf>
|
|
25 </owl:Class>
|
|
26 </owl:equivalentClass>
|
|
27 </owl:Class>
|
|
28
|
|
29 <owl:Class rdf:nodeID="descriptorset_1">
|
|
30 <wdrs:text>authority.example.org certifies that claims made by example.com are true. Valid throughout 2008.</wdrs:text>
|
|
31 <wdrs:logo rdf:resource="http://authority.example.org/icon.png" />
|
|
32 <rdfs:subClassOf>
|
|
33 <owl:Class>
|
|
34 <owl:intersectionOf rdf:parseType="Collection">
|
|
35 <owl:Restriction>
|
|
36 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#certified" />
|
|
37 <owl:hasValue>true</owl:hasValue>
|
|
38 </owl:Restriction>
|
|
39 <owl:Restriction>
|
|
40 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#sha1sum" />
|
|
41 <owl:hasValue>j6lwx3rvEPO0vKtMup4NbeVu8nk=</owl:hasValue>
|
|
42 </owl:Restriction>
|
|
43 </owl:intersectionOf>
|
|
44 </owl:Class>
|
|
45 </rdfs:subClassOf>
|
|
46 </owl:Class>
|
|
47
|
|
48 <owl:Class rdf:nodeID="iriset_1">
|
|
49 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
50 </owl:Class>
|
|
51
|
|
52 </rdf:RDF></pre>
|
|
</div>
|
|
|
|
<h4 id="interpretCert">5.2.1 Full Interpretation of Example 5-1</h4>
|
|
<p>Example 5-1 is a POWDER document that contains a single DR that describes a single resource - another POWDER document at http://www.example.com/powder.xml. The same resource could be described using core Semantic Web technologies, but POWDER offers a number of additional features so that, in effect, Example 5-1 can certify that http://www.example.com/powder.xml is true.</p>
|
|
<p>First of all, like all POWDER documents, Example 5-1 is attributed to an identified entity. That entity's description is likely to include the <code>authenticate</code> property described in <a href="#discover">Section 5.1</a>, giving information on how its DRs may be authenticated.</p>
|
|
<p>Secondly, POWDER supports time-limited assertions (albeit through informal semantics). Operationally, Example 5-1 is only valid for the 2008 calendar year.</p>
|
|
<p>Thirdly, the DR includes text and graphics that can be displayed to the end user, providing a readily accessible human-readable representation of the machine-processable data.</p>
|
|
<p>Fourthly, by providing a SHA1 hash of the described resource, the publisher of the certificate is making it clear exactly what it is certifying and that if the described document is tampered with (and therefore leads to a different hash) the description will no longer be accurate and should probably be disregarded.</p>
|
|
|
|
<h3 id="evidence">5.3 Supporting Evidence: The <code>supportedby</code> Property</h3>
|
|
<p>The certification mechanism detailed in the previous section entails a direct relationship between the content provider (or at least the DR author) and a certification body. The <a href="#supportedBy"><code>supportedby</code></a> property is similar in that it points to a third party from which data is available that will confirm the claims and assertions made in the DR; however, there need not be a direct relationship between the parties concerned. The DR author may discover independently that a third party shares their view and wishes to adduce further evidence to support their own description by pointing to the external body. One scenario in which this might obtain is described in section 2.1.7 of the Use Cases document [<a href="#usecases">USECASES</a>]. There, a DR is used to declare a Web site to be suitable for children with external support for the claim coming from a company that offers a Web site classification service.</p>
|
|
<p>In common with <code>authenticate</code> and <code>certifiedby</code>,
|
|
<code>supportedby</code> has a range of rdfs:Resource, and this may be either a machine-processable
|
|
or human-readable document. <code>supportedby</code> can be an element within the attribution
|
|
element or an individual DR. In the latter case, <code>supportedby</code> is specified as a child
|
|
of element <code>descriptorset</code>.</p>
|
|
<p>As an example, the <a href="#mok">mobileOK</a> scheme allows content providers to claim conformance to a set of Best Practices designed to ensure at least a functional experience on mobile devices. Such a claim may be supported by reference to the <a href="#mokcheck">mobileOK checker</a>. In the example below, the owners of example.com are making a claim that all the resources on their Web site conform to mobileOK Basic. As supporting evidence, users are welcome to put any resource through the W3C mobileOK checker.</p>
|
|
<div class="example" id="eg5-3">
|
|
<p class="caption">Example 5-3: A DR Claiming Conformance to mobileOK, Supported by the mobileOK Basic Checker [<a href="dr-example_5_3.xml">XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <powder xmlns="http://www.w3.org/2007/05/powder#">
|
|
|
|
3 <attribution>
|
|
4 <issuedby src="http://www.example.com/company.rdf#me" />
|
|
5 <issued>2008-06-25T00:00:00</issued>
|
|
6 <supportedby src="http://validator.w3.org/mobile/" />
|
|
7 </attribution>
|
|
|
|
8 <dr>
|
|
9 <iriset>
|
|
10 <includehosts>example.com</includehosts>
|
|
11 </iriset>
|
|
|
|
12 <descriptorset>
|
|
13 <typeof src="http://www.w3.org/2008/06/mobileOK#conformant" />
|
|
14 <displaytext>The example.com Web site conforms to mobileOK</displaytext>
|
|
15 <span id="paf4"><displayicon src="http://www.w3.org/2005/11/MWI-Icons/mobileOK.png" /></span>
|
|
16 </descriptorset>
|
|
17 </dr>
|
|
|
|
18 </powder></pre>
|
|
|
|
<p>POWDER-S [<a href="dr-example_5_3.rdf">RDF/XML</a>]</p>
|
|
<pre>
|
|
1 <?xml version="1.0"?>
|
|
2 <rdf:RDF
|
|
3 xmlns:wdrs="http://www.w3.org/2007/05/powder-s#"
|
|
4 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
|
5 xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
|
6 xmlns:owl="http://www.w3.org/2002/07/owl#"
|
|
7 xmlns:dcterms="http://purl.org/dc/terms/"
|
|
8 xmlns:foaf="http://xmlns.com/foaf/0.1/"
|
|
9 xmlns:ex="http://example.org/vocab#">
|
|
|
|
10 <owl:Ontology rdf:about="">
|
|
11 <wdrs:issuedby rdf:resource="http://www.example.com/company.rdf#me" />
|
|
12 <wdrs:issued>2008-06-25T00:00:00</wdrs:issued>
|
|
13 <wdrs:supportedby rdf:resource="http://validator.w3.org/mobile/" />
|
|
14 </owl:Ontology>
|
|
|
|
15 <owl:Class rdf:nodeID="iriset_1">
|
|
16 <owl:equivalentClass>
|
|
17 <owl:Class>
|
|
18 <owl:intersectionOf rdf:parseType="Collection">
|
|
19 <owl:Restriction>
|
|
20 <owl:onProperty rdf:resource="http://www.w3.org/2007/05/powder-s#matchesregex" />
|
|
21 <owl:hasValue rdf:datatype="http://www.w3.org/2001/XMLSchema#string">\:\/\/(([^\/\?\#]*)\@)?([^\:\/\?\#\@]+\.)?(example\.com)(:([0-9]+))?\/</owl:hasValue>
|
|
22 </owl:Restriction>
|
|
23 </owl:intersectionOf>
|
|
24 </owl:Class>
|
|
25 </owl:equivalentClass>
|
|
26 </owl:Class>
|
|
|
|
27 <owl:Class rdf:nodeID="descriptorset_1">
|
|
28 <wdrs:text>The example.com Web site conforms to mobileOK</wdrs:text>
|
|
29 <wdrs:logo rdf:resource="http://www.w3.org/2005/11/MWI-Icons/mobileOK.png" />
|
|
30 <rdfs:subClassOf>
|
|
31 <owl:Class>
|
|
32 <owl:intersectionOf rdf:parseType="Collection">
|
|
33 </owl:intersectionOf>
|
|
34 </owl:Class>
|
|
35 </rdfs:subClassOf>
|
|
36 <rdfs:subClassOf rdf:resource="http://www.w3.org/2008/06/mobileOK#conformant" />
|
|
37 </owl:Class>
|
|
|
|
38 <owl:Class rdf:nodeID="iriset_1">
|
|
39 <rdfs:subClassOf rdf:nodeID="descriptorset_1"/>
|
|
40 </owl:Class>
|
|
|
|
41 </rdf:RDF></pre>
|
|
</div>
|
|
<h3 id="trustedHost">5.4 Trusted Source</h3>
|
|
<p>Description Resources exist independently of the content they describe and are dereferenced from an IRI of their own. This is usually discovered by following a link from the described content. If the Description Resource is hosted on a trusted server, typically one operated by a trustmark scheme or certification body, then the trustworthiness of the DR is equal to the trustworthiness of the server and its operator.</p>
|
|
<p>Imagine good.example.com has a commercial relationship with powder.example.org. The operators of good.example.com go through a review process run by powder.example.org and are then entitled to include a tag like the one below in the code of their Web pages.</p>
|
|
<p><code><link rel="describedby" href="http://powder.example.org/dr46" <span id="app6">type="application/powder+xml"</span> /></code></p>
|
|
<p>The document at powder.example.org remains entirely under the control of the reviewer, who is free to change or remove it at any time.</p>
|
|
<p><strong>N.B.</strong> Any such change must take account of any valid until date given in the document and the fact that a POWDER-aware user agent may cache DRs until that date occurs. The <a href="#primer">Primer</a> has more to say about this.</p>
|
|
|
|
<h3 id="machineLearn">5.5 Machine Learning</h3>
|
|
<p>It is a fundamental aspect of RDF that descriptive terms are explicitly defined by IRI. Therefore if a particular descriptive vocabulary becomes widely used, it will mean the same thing wherever it is found. This is important when deploying content analysis software that uses machine-learning techniques. Once the software has been trained to recognize content matching descriptions made using a particular vocabulary, where DRs are encountered using that same vocabulary, the newly discovered content can be analyzed and a probability of its accuracy be calculated.</p>
|
|
|
|
<h3 id="trustsummary">5.6 Trust Summary</h3>
|
|
<p>The methods cited here do not comprise an exhaustive list. Other techniques, such as XML Signature [<a href="#xmlsig">XMLSIG</a>] and Web of Trust [<a href="#wot">WOT</a>], may be equally applicable. As noted in the introduction, trust is a human judgment that can only be made by weighing the likelihood that the data is true against the consequences of it being false. This judgment is highly dependant on the circumstances under which the need to extend trust arises. It is clear, however, that Description Resources are unlikely to be trusted in isolation and that both their publishers and consumers will only benefit from their existence if one or more techniques for enhancing trust are employed.</p>
|
|
|
|
<h2 id="references">6 References</h2>
|
|
<h3 id="normRefs">6.1 Normative References</h3>
|
|
<dl>
|
|
<dt><a id="formal" name="formal">FORMAL</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/powder-formal/">Protocol for Web Description Resources (POWDER): Formal Semantics</a></cite> 2008, S. Konstantopoulos, P. Archer. This document is at http://www.w3.org/TR/powder-formal/</dd>
|
|
<dt><a id="grddl" name="grddl">GRDDL</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/grddl/">Gleaning Resource Descriptions from Dialects of Languages (GRDDL)</a></cite> W3C Recommendation 11 September 2007. D. Connolly. This document is at http://www.w3.org/TR/grddl/</dd>
|
|
<dt><a id="group" name="group">GROUP</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/powder-grouping/">Protocol for Web Description Resources (POWDER): Grouping of Resources</a></cite>, A. Perego, P. Archer. This document is at http://www.w3.org/TR/powder-grouping/</dd>
|
|
<dt><a id="xmldatetime" name="xmldatetime">XML dateTime</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#dateTime">XML Schema Part 2: Datatypes Second Edition</a></cite> W3C Recommendation 28 October 2004. P. Biron, A. Malhotra (Eds). This document is at http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#dateTime</dd>
|
|
<dt><a id="rfc4287" name="rfc4287">RFC4287</a></dt>
|
|
<dd><cite><a href="http://www.ietf.org/rfc/rfc4287.txt">The Atom Syndication Format</a></cite> M. Nottingham,R. Sayre (Eds) RFC 4287, December 2005. This document is at http://www.ietf.org/rfc/rfc4287.txt</dd>
|
|
<dt><a id="areg" name="areg">AREG</a></dt>
|
|
<dd><cite><a href="http://www.iana.org/assignments/link-relations/link-relations.xhtml">Atom Link Relations</a></cite> This document is at http://www.iana.org/assignments/link-relations/link-relations.xhtml</dd>
|
|
<dt><a id="iri" name="iri">RFC3987</a></dt>
|
|
<dd><cite><a href="http://www.ietf.org/rfc/rfc3987.txt">Internationalized Resource Identifiers (IRIs)</a></cite>, M. Duerst, M. Suignard. RFC January 2005. This document is at http://www.ietf.org/rfc/rfc3987.txt</dd>
|
|
<dt><a id="mime" name="mime">MIME</a></dt>
|
|
<dd><cite><a href="http://tools.ietf.org/html/rfc2046">RFC 2046: Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</a></cite> N. Freed, N. Borenstein. This document is at http://tools.ietf.org/html/rfc2046</dd>
|
|
<dt><a id="owl" name="owl">OWL</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/2004/REC-owl-guide-20040210/">OWL Web Ontology Language Guide</a></cite> M. K. Smith, C. Welty, D. L. McGuinness. W3C Recommendation 10 February 2004. This document is at http://www.w3.org/TR/2004/REC-owl-guide-20040210/</dd>
|
|
<dt><a id="ref-rfc2119" name="ref-rfc2119">RFC2119</a></dt>
|
|
<dd><cite><a href="http://www.ietf.org/rfc/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a></cite>, S. Bradner. IETF, March 1997. This document is at http://www.ietf.org/rfc/rfc2119.</dd>
|
|
<dt><a id="rfc2616" name="rfc2616">RFC2616</a></dt>
|
|
<dd><cite><a href="http://www.ietf.org/rfc/rfc2616.txt">Hypertext Transfer Protocol -- HTTP/1.1</a></cite>, R. Fielding et al, June 1999. This document is at http://www.ietf.org/rfc/rfc2616.txt</dd>
|
|
<dt><a id="xf" name="xf">XF</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/xforms/#serialize-urlencode">XForms 1.0 (Third Edition)</a></cite>, W3C Recommendation 29 October 2007. J. Boyer. This document is at http://www.w3.org/TR/xforms/#serialize-urlencode</dd>
|
|
<dt><a id="rfc3023" name="rfc3023">RFC3023</a></dt>
|
|
<dd><cite><a href="http://www.ietf.org/rfc/rfc3023.txt">XML Media Types</a></cite>, M. Murata, S. St.Laurent, D. Kohn. RFC January 2001. This document is at http://www.ietf.org/rfc/rfc3023.txt</dd>
|
|
<dt><a id="rfc3986" name="rfc3986">RFC3986</a></dt>
|
|
<dd><cite><a href="http://www.ietf.org/rfc/rfc3986.txt">Uniform Resource Identifier (URI): Generic Syntax</a></cite>, T. Berners-Lee, R. Fielding, L. Masinter. RFC January 2005. This document is at http://www.ietf.org/rfc/rfc3986.txt</dd>
|
|
<dt id="xqxp">[XQXP]</dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/xpath-functions/">XQuery 1.0 and XPath 2.0 Functions and Operators</a></cite>, A. Malhotra, J. Melton, N. Walsh. W3C Recommendation, 23 January 2007. This document is at http://www.w3.org/TR/xpath-functions/</dd>
|
|
</dl>
|
|
|
|
<h3 id="infoRefs">6.2 Informative References</h3>
|
|
<dl>
|
|
|
|
<dt><a id="dc" name="dc">DC</a></dt>
|
|
<dd><cite><a href="http://dublincore.org/">Dublin Core Metadata Initiative</a></cite></dd>
|
|
<dt><a id="foaf" name="foaf">FOAF</a></dt>
|
|
<dd><cite><a href="http://xmlns.com/foaf/spec/">FOAF Vocabulary Specification 0.9</a></cite> Namespace Document 24 May 2007, D. Brickley, L. Miller. This document is at http://xmlns.com/foaf/spec/</dd>
|
|
|
|
<dt><a id="hlink" name="hlink">HLINK</a></dt>
|
|
<dd><cite><a href="http://tools.ietf.org/html/draft-nottingham-http-link-header-05">Link Relations and HTTP Header Linking</a></cite> M. Nottingham. Internet Draft 17, April 2009. This document is at http://tools.ietf.org/html/draft-nottingham-http-link-header-05</dd>
|
|
<dt><a id="mok" name="mok">MOBILEOK</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/mobileOK/">W3C mobileOK Scheme 1.0</a></cite> J. Rabin. This document is at http://www.w3.org/TR/mobileOK/</dd>
|
|
<dt><a id="mokcheck" name="mokcheck">MOBILEOK CHECKER</a></dt>
|
|
<dd><cite><a href="http://validator.w3.org/mobile/">W3C mobileOK Basic Checker</a></cite> D. Hazaël-Massieux, F Daoust. This tool is at http://validator.w3.org/mobile/</dd>
|
|
<dt><a id="primer" name="primer">PRIMER</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/powder-primer/">Protocol for Web Description Resources (POWDER): Primer</a></cite> 2008, K. Scheppe. This document is at http://www.w3.org/TR/powder-primer/</dd>
|
|
<dt><a id="rdfa" name="rdfa">RDFA</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/xhtml-rdfa-primer/">RDFa Primer 1.0 Embedding RDF in XHTML</a></cite>, B. Adida, M. Birbeck. This document is at http://www.w3.org/TR/xhtml-rdfa-primer/</dd>
|
|
<dt><a id="sparql" name="sparql">SPARQL</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/rdf-sparql-query/">SPARQL Query Language for RDF</a></cite> E. Prud'hommeaux, A. Seaborne. This document is at http://www.w3.org/TR/rdf-sparql-query/</dd>
|
|
<dt><a id="testsuite" name="testsuite">TESTS</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/powder-test/">Protocol for Web Description Resources (POWDER): Test Suite</a></cite> 2008, A. Kukurikos. This document is at http://www.w3.org/TR/powder-test/</dd>
|
|
<dt><a id="usecases" name="usecases">USECASES</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/powder-use-cases/">POWDER: Use Cases and Requirements</a></cite> W3C Working Group Note 31 October 2007, P. Archer. This document is at http://www.w3.org/TR/powder-use-cases/</dd>
|
|
<dt><a id="xgr" name="xgr">XGR</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/2005/Incubator/wcl/XGR-wcl/">W3C Incubator Group Report</a></cite> P. Archer, J. Rabin, 20 February 2007. This document is at http://www.w3.org/2005/Incubator/wcl/XGR-wcl/</dd>
|
|
<dt><a id="xmlsig" name="xmlsig">XMLSIG</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/xmldsig-core/">XML-Signature Syntax and Processing</a></cite>, Donald. Eastlake, J. Reagle, D. Solo (Eds). W3C Recommendation 12 February 2002. This document is at http://www.w3.org/TR/xmldsig-core/</dd>
|
|
<dt><a id="wclxg" name="wclxg">WCL-XG</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/2005/Incubator/wcl/">W3C Content Label Incubator Group</a></cite> February 2006 - February 2007</dd>
|
|
<dt><a id="wdr" name="wdr">WDR</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/2007/05/powder">Protocol for Web Description Resources (POWDER): Web Description Resources XML Schema (WDR)</a></cite>, A. Perego, K. Smith. This document is at http://www.w3.org/2007/05/powder</dd>
|
|
<dt><a id="wdrb" name="wdrb">WDRB</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/2007/05/powder-base">Protocol for Web Description Resources (POWDER): Web Description Resources "Base" XML Schema (WDRB)</a></cite>, A. Perego, K. Smith. This document is at http://www.w3.org/2007/05/powder-base</dd>
|
|
<dt><a id="wdrd" name="wdrd">WDRD</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/powder-xsd/">Protocol for Web Description Resources (POWDER): Web Description Resources Datatypes (WDRD)</a></cite>, A Perego, K. Smith. This document is at http://www.w3.org/TR/powder-xsd</dd>
|
|
<dt><a id="wdrs" name="wdrs">WDRS</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/2007/05/powder-s">Protocol for Web Description Resources (POWDER): POWDER-S Vocabulary (WDRS)</a></cite>, P. Archer. This document is at http://www.w3.org/2007/05/powder-s</dd>
|
|
<dt><a id="wot" name="wot">WOT</a></dt>
|
|
<dd><cite><a href="http://xmlns.com/wot/0.1/">Web Of Trust RDF Ontology</a></cite>, D. Brickley. This document is at http://xmlns.com/wot/0.1/</dd>
|
|
<dt><a id="wsdl" name="wsdl">WSDL</a></dt>
|
|
<dd>See, for example, <cite><a href="http://www.w3.org/TR/wsdl20-primer/">Web Services Description Language (WSDL) Version 2.0 Part 0: Primer</a></cite> D. Booth, C. K. Liu, W3C Recommendation 26 June 2007. This document is at http://www.w3.org/TR/wsdl20-primer/</dd>
|
|
<dt><a name="its" id="its">ITS</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/TR/its/">Internationalization Tag Set (ITS) Version 1.0</a></cite>. W3C Recommendation 03 April 2007, C. Lieske, F. Sasaki. This document is at http://www.w3.org/TR/its/.</dd>
|
|
<dt><a name="itsrules" id="itsrules">ITS-Rules</a></dt>
|
|
<dd><cite><a href="http://www.w3.org/2007/powder/powder_itsrules.xml">POWDER Internationalization Tage Set Rules File</a></cite> This document is at http://www.w3.org/2007/powder/powder_itsrules.xml</dd>
|
|
|
|
|
|
</dl>
|
|
|
|
<h2 id="ack">7 Acknowledgements</h2>
|
|
<p>The editors duly acknowledge the earlier work in this area carried out by the Web Content Label Incubator Activity, especially the contribution made by Jo Rabin. David Booth and Jeremy Carroll of HP contributed substantially to the operational/semantic model for POWDER, with further contributions from Dan Brickley and support from all members of the POWDER Working Group.</p>
|
|
|
|
<h2 id="change">8 Change Log</h2>
|
|
<h3 id="sincePR">8.1 Changes since <a href="http://www.w3.org/TR/2009/PR-powder-dr-20090604/">Proposed Recommendation</a></h3>
|
|
<ul><li><a href="#ns_typo">XML Schema namespace</a> corrected</li>
|
|
<li><a href="#xq">Sentence added</a> to clarify the Regular Expression Syntax used</li>
|
|
<li>Sentence describing <a href="#whitespace">white space processing</a> rules amended to refer to, and be consistent with, XML attribute value normalization.</li>
|
|
<li>Change log reduced to refer only to changes since PR</li>
|
|
</ul>
|
|
|
|
<h2 id="appA">Appendix A: Summary of POWDER Elements & Properties</h2>
|
|
|
|
<h3 id="xmlElements">A.1 XML Elements (in the <code>wdr</code> namespace)</h3>
|
|
<table style="border-collapse:collapse">
|
|
<tr><th>Element Name</th><th>Content</th><th>Attributes</th><th>Cardinality</th><th>Introduced</th></tr>
|
|
<tr><td><a name="powder" id="powder"><code>powder</code></a></td><td><code>attribution</code>, <code>dr</code>, <code>ol</code>, <code>descriptorset</code>, <code>tagset</code>, <code>more</code></td><td></td><td>The Root Element</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="attribution" id="attribution"><code>attribution</code></a></td><td><code>issuedby</code>, <code>issued</code>, <code>abouthosts</code>, <code>validfrom</code>, <code>validuntil</code>, <code>certifiedby</code>, <code>supportedby</code></td><td></td><td>Required</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="issuedby" id="issuedby"><code>issuedby</code></a></td><td>MUST refer to an instance of an RDF class that describes the entity that created the POWDER document. It is RECOMMENDED that this be done using an instance of either <code>foaf:Agent</code> or <code>dcterms:Agent</code> (or subclass thereof)</td><td><code>src</code></td><td>Exactly one of these elements is required</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="issued" id="issued"><code>issued</code></a></td><td><code>xsd:dateTime</code></td><td></td><td>Optional</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="dr" id="dr"><code>dr</code></a></td><td><code>iriset</code> (1 or more) plus either 1 <code>descriptorset</code>, 1 <code>tagset</code> or both <code>descriptorset</code> and <code>tagset</code></td><td></td><td>0 or more</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="iriset" id="iriset"><code>iriset</code></a></td><td>See Grouping of Resources document [<a href="#group">GROUP</a>]</td><td></td><td>At least 1 in each <code>dr</code></td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="descriptorset" id="descriptorset"><code>descriptorset</code></a></td><td><code>displaytext</code>, <code>displayicon</code>, <code>seealso</code>, <code>label</code>, <code>comment</code>, <code>sha1sum</code>, <code>certified</code>, <code>supportedby</code>, <code>typeof</code>, RDF/XML (excluding blank nodes), <strong>OR</strong> a reference to another <code>descriptorset</code> element. See Formal Semantics document [<a href="#formal">FORMAL</a>] for full details.</td><td><code>src</code>, <code id="include">include</code>, <code id="node">node</code>, <code>xml:id</code></td><td><span id="appErr1">At least</span> 1 required as child element of <code>dr</code> unless <code>tagset</code> is present. Any number may be a child element of <code>powder</code></td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="displaytext" id="displaytext"><code>displaytext</code></a></td><td>Text</td><td></td><td>0 or more (1 is the recommended maxiumum)</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="displayicon" id="displayicon"><code>displayicon</code></a></td><td>None, but the <code>src</code> attribute is the IRI of an image and is of type <code>xsd:anyURI</code></td><td><code>src</code></td><td>0 or more (1 is the recommended maxiumum)</td><td><a href="#operational">Section 2.1</a></td></tr>
|
|
<tr><td><a name="ol" id="ol"><code>ol</code></a></td><td>At least 1 <code>dr</code></td><td></td><td>0 or more</td><td><a href="#olDR">Section 2.3</a></td></tr>
|
|
<tr><td><a name="abouthosts" id="abouthosts"><code>abouthosts</code></a></td><td>White space separated list of hosts. When this element is present, descriptions within the document MUST NOT be applied to resources available from other hosts.</td><td></td><td>Optional</td><td><a href="#olDR">Section 2.3</a> and <a href="#preDefinedDescriptors">Section 2.6</a></td></tr>
|
|
<tr><td><a name="tagset" id="tagset"><code>tagset</code></a></td><td>At least 1 <code>tag</code> plus any number of <code>seealso</code>, <code>label</code>, <code>comment</code>.</td><td></td><td>0 or more</td><td><a href="#tags">Section 2.7</a></td></tr>
|
|
<tr><td><a name="tag" id="tag"><code>tag</code></a></td><td><code>xsd:token</code></td><td></td><td>At least 1 within a <code>tagset</code></td><td><a href="#tags">Section 2.7</a></td></tr>
|
|
<tr><td><a name="seealso" id="seealso"><code>seealso</code></a></td><td>None, but the <code>src</code> attribute is of type <code>xsd:anyURI</code></td><td><code>src</code></td><td>0 or more</td><td><a href="#tags">Section 2.7</a></td></tr>
|
|
<tr><td><a name="label" id="label"><code>label</code></a></td><td id="appErr2">Text</td><td></td><td>0 or more</td><td><a href="#tags">Section 2.7</a></td></tr>
|
|
<tr><td><a name="comment" id="comment"><code>comment</code></a></td><td>Text</td><td></td><td>0 or more</td><td><a href="#tags">Section 2.7</a></td></tr>
|
|
<tr><td><a name="typeof" id="typeof"><code>typeof</code></a></td><td>None, but the <code>src</code> attribute is of type <code>xsd:anyURI</code></td><td><code>src</code></td><td>0 or more</td><td><a href="#multiDesc">Section 2.8</a></td></tr>
|
|
<tr><td><a name="more" id="more"><code>more</code></a></td><td>None, but the <code>src</code> attribute is of type <code>xsd:anyURI</code></td><td><code>src</code></td><td>0 or more</td><td><a href="#linkingDRdocs">Section 4.3</a></td></tr>
|
|
<tr><td><a name="validfrom" id="validfrom"><code>validfrom</code></a></td><td><code>xsd:dateTime</code></td><td></td><td>Optional</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="validuntil" id="validuntil"><code>validuntil</code></a></td><td><code>xsd:dateTime</code></td><td></td><td>Optional</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="sha" id="sha"><code>sha1sum</code></a></td><td>The base 64-encoded binary SHA-1 sum of the described resource.</td><td></td><td>Optional</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="certified" id="certified"><code>certified</code></a></td><td>An element of type <code>xsd:boolean</code> used when a DR certifies another resource.</td><td></td><td>Optional</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="certifiedby" id="certifiedby"><code>certifiedby</code></a></td><td>None, but the <code>src</code> attribute is of type <code>xsd:anyURI</code> which links a DR to another that certifies.</td><td><code>src</code></td><td>0 or more</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="supportedBy" id="supportedBy"><code>supportedby</code></a></td><td>None, but the <code>src</code> attribute is of type <code>xsd:anyURI</code> which is a pointer to some other data source that supports the claims made in the DR.</td><td><code>src</code></td><td>0 or more</td><td><a href="#supportedBy">Section 5.3</a></td></tr>
|
|
</table>
|
|
|
|
<h3 id="rdfProperties">A.2 RDF/OWL Classes and Properties (in the <code>wdrs</code> namespace)</h3>
|
|
<table style="border-collapse:collapse">
|
|
<tr><th>Term</th><th>Notes</th><th>Type</th><th>Introduced</th></tr>
|
|
<tr><td><a name="issuedby-s" id="issuedby-s"><code>issuedby</code></a></td><td>Range is undefined but it is RECOMMENDED that the filler be either a <code>dcterms:Agent</code> or a <code>foaf:Agent</code></td><td>OWL Annotation Property</td><td><a href="#formalSemantics">Section 2.2</a></td></tr>
|
|
<tr><td><a name="issued-s" id="issued-s"><code>issued</code></a></td><td>It takes as value a literal of type <code>xsd:dateTime</code>.</td><td>OWL Annotation Property</td><td><a href="#formalSemantics">Section 2.2</a></td></tr>
|
|
<tr><td><a name="text" id="text"><code>text</code></a></td><td>As <code>displaytext</code> in previous table</td><td>OWL Annotation Property</td><td><a href="#formalSemantics">Section 2.2</a></td></tr>
|
|
<tr><td><a name="logo" id="logo"><code>logo</code></a></td><td>As <code>displayicon</code> in previous table</td><td>OWL Annotation Property</td><td><a href="#formalSemantics">Section 2.2</a></td></tr>
|
|
<tr><td><a name="matchesregex" id="matchesregex"><code>matchesregex</code></a></td><td>RDF/OWL tools must understand the POWDER Semantic Extension to process the semantics of this property.</td><td>OWL Datatype Property</td><td><a href="#formalSemantics">Section 2.2</a></td></tr>
|
|
<tr><td><a name="notmatchesregex" id="notmatchesregex"><code>notmatchesregex</code></a></td><td>RDF/OWL tools must understand the POWDER Semantic Extension to process the semantics of this property.</td><td>OWL Datatype Property</td><td><a href="#formalSemantics">Section 2.2</a></td></tr>
|
|
<tr><td><a name="Processor" id="Processor"><code>Processor</code></a></td><td>The class of POWDER Processors</td><td>Sub class of <code>dcterms:Agent</code></td><td><a href="#powderprocessor">Section 3</a></td></tr>
|
|
<tr><td><a name="Document" id="Document"><code>Document</code></a></td><td>The class of POWDER documents</td><td>Sub class of <code>owl:Ontology</code></td><td><a href="#powderprocessor">Section 3</a></td></tr>
|
|
<tr><td><a name="data_error" id="data_error"><code>data_error</code></a></td><td>A property denoting a description of the specific processing error occurred when processing a given POWDER document. Domain is #Document</td><td>OWL Datatype Property</td><td><a href="#powderprocessor">Section 3</a></td></tr>
|
|
<tr><td><a name="proc_error" id="proc_error"><code>proc_error</code></a></td><td>A property denoting a description of the specific processing error occurred when processing a given POWDER document. Domain is #Processor</td><td>OWL Datatype Property</td><td><a href="#powderprocessor">Section 3</a></td></tr>
|
|
<tr><td><a name="err_code" id="err_code"><code>err_code</code></a></td><td>A property denoting a description of the specific processing error occurred when processing a given POWDER document. Range is <code>xsd:nonNegativeInterger</code></td><td>OWL Datatype Property</td><td><a href="#powderprocessor">Section 3</a></td></tr>
|
|
<tr><td><a name="describedby" id="describedby"><code>describedby</code></a></td><td>A property that links a described resource to a POWDER document. For use with RDFa and other rich formats.</td><td>OWL Object Property</td><td><a href="#semlink">Section 4.1.3</a></td></tr>
|
|
<tr><td><a name="tag-s" id="tag-s"><code>tag</code></a></td><td>Filler is a string literal that may include spaces</td><td>OWL Datatype Property</td><td><a href="#tags">Section 2.7</a></td></tr>
|
|
<tr><td><a name="notknownto" id="notknownto"><code>notknownto</code></a></td><td>Property used by a POWDER Processor that it does not have any information about a particular IRI. Range is #Processor.</td><td>OWL Object Property</td><td><a href="#powderprocessor">Section 3</a></td></tr>
|
|
<tr><td><a name="authenticate" id="authenticate"><code>authenticate</code></a></td><td>An RDF property that links a <code>dcterms:Agent</code> or <code>foaf:Agent</code> class to a resource describing how to authenticate its DRs.</td><td>OWL Object Property</td><td><a href="#discover">Section 5.1</a></td></tr>
|
|
<tr><td><a name="validfrom-s" id="validfrom-s"><code>validfrom</code></a></td><td>It takes as value a literal of type <code>xsd:dateTime</code>.</td><td>OWL Annotation Property</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="validuntil-s" id="validuntil-s"><code>validuntil</code></a></td><td>It takes as value a literal of type <code>xsd:dateTime</code>.</td><td>OWL Annotation Property</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="sha1sum-s" id="sha1sum-s"><code>sha1sum</code></a></td><td>Range is datatype <code>xsd:base64Binary</code>.</td><td>OWL Datatype Property</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="certified-s" id="certified-s"><code>certified</code></a></td><td>It takes as value a literal of type <code>xsd:boolean</code>.</td><td>OWL Datatype Property</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="certifiedby-s" id="certifiedby-s"><code>certifiedby</code></a></td><td><code>owl:Thing</code>.</td><td>OWL Object Property</td><td><a href="#certification">Section 5.2</a></td></tr>
|
|
<tr><td><a name="supportedby-s" id="supportedby-s"><code>supportedby</code></a></td><td><code>owl:Thing</code></td><td>OWL Object Property</td><td><a href="#evidence">Section 5.3</a></td></tr>
|
|
</table>
|
|
|
|
|
|
<h2 id="appB">Appendix B: POWDER Internet Media Type and Macintosh File Type</h2>
|
|
<p>The following Media Type has been submitted to the <a href="http://www.ietf.org/iesg.html">IESG</a> for review, approval, and registration with <a href="http://iana.org/">IANA</a></p>
|
|
<dl>
|
|
<dt>contact:</dt>
|
|
<dd>Phil Archer or Matt Womer</dd>
|
|
<dt>See also:</dt>
|
|
<dd><a href="http://www.w3.org/2002/06/registering-mediatype">How to Register a Media Type for a W3C Specification</a></dd>
|
|
<dd><a href="http://www.w3.org/2001/tag/2002/0129-mime">Internet Media Type registration, consistency of use</a><br />TAG Finding 3 June 2002 (Revised 4 September 2002)</dd>
|
|
</dl>
|
|
<p>The Internet Media Type / MIME Type for POWDER is "application/powder+xml".</p>
|
|
<p>It is recommended that POWDER files use the file extension of .xml (all lowercase) on all platforms.</p>
|
|
<p>It is recommended that POWDER files stored on Macintosh HFS file systems be given a file type of "TEXT".</p>
|
|
|
|
<dl>
|
|
<dt>Type name:</dt>
|
|
<dd>application</dd>
|
|
|
|
<dt>Subtype name:</dt>
|
|
<dd>powder+xml</dd>
|
|
|
|
<dt>Required parameters:</dt>
|
|
<dd>None</dd>
|
|
|
|
<dt>Optional parameters:</dt>
|
|
<dt>None</dt>
|
|
|
|
<dt>Encoding considerations:</dt>
|
|
<dd>Identical to those of "application/xml" as specified in [<a href="#rfc3023">RFC3023</a>], section 3.2.</dd>
|
|
|
|
<dt>Security considerations:</dt>
|
|
<dd>POWDER is used to make assertions, sometimes socially sensitive,
|
|
about web resources. Consumers of POWDER should be aware of the
|
|
source and chain of custody of this data. Security considerations
|
|
for URIs (Section 7 of RFC 3986 [<a href="#rfc3986">RFC3986</a>]) and IRIs (Section 8 of RFC 3987 [<a href="#iri">RFC3987</a>])
|
|
apply to the extent that describing resources in POWDER may prompt
|
|
consumers to retrieve those resources.</dd>
|
|
|
|
<dt>Interoperability considerations:</dt>
|
|
<dd>There are no known interoperability issues.</dd>
|
|
|
|
<dt>Published specification:</dt>
|
|
<dd><a href="http://www.w3.org/TR/powder-dr/">http://www.w3.org/TR/powder-dr/</a></dd>
|
|
|
|
<dt>Applications which use this media type:</dt>
|
|
<dd>No known applications currently use this media type.</dd>
|
|
|
|
<dt>Additional information:</dt>
|
|
|
|
<dt>Magic number(s):</dt>
|
|
<dd>As specified for "application/xml" in RFC 3023 [<a href="#rfc3023">RFC3023</a>], section 3.2.</dd>
|
|
|
|
<dt>File extension(s):</dt>
|
|
<dd>.xml</dd>
|
|
|
|
<dt>Fragment identifiers:</dt>
|
|
<dd>Identical to that of "application/xml" as described in RFC 3023 [<a href="#rfc3023">RFC3023</a>], section 5.</dd>
|
|
|
|
<dt>Base URI:</dt>
|
|
<dd>As specified in RFC 3023 [<a href="#rfc3023">RFC3023</a>], section 6.</dd>
|
|
|
|
<dt>Macintosh file type code(s):</dt>
|
|
<dd>"TEXT"</dd>
|
|
|
|
<dt>Person & email address to contact for further information:</dt>
|
|
<dd>public-powderwg@w3.org</dd>
|
|
|
|
<dt>Intended usage:</dt>
|
|
<dd>COMMON</dd>
|
|
|
|
<dt>Restrictions on usage:</dt>
|
|
<dd>None</dd>
|
|
|
|
<dt>Author/Change controller:</dt>
|
|
<dd>The POWDER specification is a work product of the World Wide Web
|
|
Consortium's Protocol for Web Description Resources (POWDER) Working
|
|
Group. The W3C has change control over these specifications.</dd>
|
|
</dl>
|
|
|
|
|
|
<h2 id="appC">Appendix C: POWDER-S Internet Media Type and Macintosh File Type</h2>
|
|
<p>The following Media Type has been submitted to the <a href="http://www.ietf.org/iesg.html">IESG</a> for review, approval, and registration with <a href="http://iana.org/">IANA</a></p>
|
|
<dl>
|
|
<dt>contact:</dt>
|
|
<dd>Phil Archer or Matt Womer</dd>
|
|
<dt>See also:</dt>
|
|
<dd><a href="http://www.w3.org/2002/06/registering-mediatype">How to Register a Media Type for a W3C Specification</a></dd>
|
|
<dd><a href="http://www.w3.org/2001/tag/2002/0129-mime">Internet Media Type registration, consistency of use</a><br />TAG Finding 3 June 2002 (Revised 4 September 2002)</dd>
|
|
</dl>
|
|
<p>The Internet Media Type / MIME Type for POWDER-S is "application/powder-s+xml".</p>
|
|
<p>It is recommended that POWDER-S files use the file extension of .rdf (all lowercase) on all platforms.</p>
|
|
<p>It is recommended that POWDER-S files stored on Macintosh HFS file systems be given a file type of "TEXT".</p>
|
|
|
|
<dl>
|
|
<dt>Type name:</dt>
|
|
<dd>application</dd>
|
|
|
|
<dt>Subtype name:</dt>
|
|
<dd>powder-s+xml</dd>
|
|
|
|
<dt>Required parameters:</dt>
|
|
<dd>None</dd>
|
|
|
|
<dt>Optional parameters:</dt>
|
|
<dt>None</dt>
|
|
|
|
<dt>Encoding considerations:</dt>
|
|
<dd>Identical to those of "application/xml" as specified in [<a href="#rfc3023">RFC3023</a>], section 3.2.</dd>
|
|
|
|
<dt>Security considerations:</dt>
|
|
<dd>POWDER-S is used to make assertions, sometimes socially sensitive,
|
|
about web resources. Consumers of POWDER should-S be aware of the
|
|
source and chain of custody of this data. Security considerations
|
|
for URIs (Section 7 of RFC 3986 [<a href="#rfc3986">RFC3986</a>]) and IRIs (Section 8 of RFC 3987 [<a href="#iri">RFC3987</a>])
|
|
apply to the extent that describing resources in POWDER-S may prompt
|
|
consumers to retrieve those resources.</dd>
|
|
|
|
<dt>Interoperability considerations:</dt>
|
|
<dd>There are no known interoperability issues.</dd>
|
|
|
|
<dt>Published specification:</dt>
|
|
<dd><a href="http://www.w3.org/TR/powder-dr/">http://www.w3.org/TR/powder-dr/</a></dd>
|
|
|
|
<dt>Applications which use this media type:</dt>
|
|
<dd>No known applications currently use this media type.</dd>
|
|
|
|
<dt>Additional information:</dt>
|
|
|
|
<dt>Magic number(s):</dt>
|
|
<dd>As specified for "application/xml" in RFC 3023 [<a href="#rfc3023">RFC3023</a>], section 3.2.</dd>
|
|
|
|
<dt>File extension(s):</dt>
|
|
<dd>.rdf</dd>
|
|
|
|
<dt>Fragment identifiers:</dt>
|
|
<dd>Identical to that of "application/xml" as described in RFC 3023 [<a href="#rfc3023">RFC3023</a>], section 5.</dd>
|
|
|
|
<dt>Base URI:</dt>
|
|
<dd>As specified in RFC 3023 [<a href="#rfc3023">RFC3023</a>], section 6.</dd>
|
|
|
|
<dt>Macintosh file type code(s):</dt>
|
|
<dd>"TEXT"</dd>
|
|
|
|
<dt>Person & email address to contact for further information:</dt>
|
|
<dd>public-powderwg@w3.org</dd>
|
|
|
|
<dt>Intended usage:</dt>
|
|
<dd>COMMON</dd>
|
|
|
|
<dt>Restrictions on usage:</dt>
|
|
<dd>None</dd>
|
|
|
|
<dt>Author/Change controller:</dt>
|
|
<dd>The POWDER-S specification is a work product of the World Wide Web
|
|
Consortium's Protocol for Web Description Resources (POWDER) Working
|
|
Group. The W3C has change control over these specifications.</dd>
|
|
</dl>
|
|
|
|
<h2 id="appD">Appendix D: describedby Link Relationship</h2>
|
|
<p>The following Link Relationship has been submitted to <a href="http://iana.org/">IANA</a> for review, approval, and inclusion in the <a href="http://www.iana.org/assignments/link-relations/link-relations.xhtml">Atom Link Relations</a> registry</p>
|
|
|
|
<dl>
|
|
<dt>Attribute Value:</dt>
|
|
<dd>describedby</dd>
|
|
<dt>Description:</dt>
|
|
<dd>The relationship A 'describedby' B asserts that resource B provides a description of resource A. There are
|
|
no constraints on the format or representation of either A or B, neither are there any further constraints
|
|
on either resource. </dd>
|
|
<dt>Expected display characteristics</dt>
|
|
<dd>None</dd>
|
|
<dt>Security considerations:</dt>
|
|
<dd>Descriptions of resources may be socially sensitive, may require processing to be understood and may or may not not be accurate. Consumers of descriptive resources should be aware of the source and chain of custody of the data. Security considerations for URIs (Section 7 of RFC 3986) and IRIs (Section 8 of RFC 3987 ) apply to the extent that describing resources may affect consumers' decisions about how or whether to retrieve those resources.</dd>
|
|
<dt>Documentation:</dt>
|
|
<dd><a href="http://www.w3.org/TR/powder-dr/#assoc-linking">http://www.w3.org/TR/powder-dr/#assoc-linking</a></dd>
|
|
</dl>
|
|
|
|
|
|
</body>
|
|
</html>
|