W3C home > Mailing lists > Public > public-html-commits@w3.org > July 2009

html5/spec Overview.html,1.2501,1.2502

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 07 Jul 2009 23:21:38 +0000
To: public-html-commits@w3.org
Message-Id: <E1MOJyk-0004EK-Dk@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv16242

Modified Files:
	Overview.html 
Log Message:
Microdata: Introduce a vocabulary for licensing works which maps to ccREL at the RDF layer. (whatwg r3370)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2501
retrieving revision 1.2502
diff -u -d -r1.2501 -r1.2502
--- Overview.html	7 Jul 2009 08:26:20 -0000	1.2501
+++ Overview.html	7 Jul 2009 23:21:35 -0000	1.2502
@@ -750,20 +750,23 @@
    <li><a href="#microdata-dom-api"><span class="secno">5.3 </span>Microdata DOM API</a></li>
    <li><a href="#predefined-vocabularies"><span class="secno">5.4 </span>Predefined vocabularies</a>
     <ol>
-     <li><a href="#vcard"><span class="secno">5.4.1 </span>vCard</a>
+     <li><a href="#general"><span class="secno">5.4.1 </span>General</a></li>
+     <li><a href="#vcard"><span class="secno">5.4.2 </span>vCard</a>
       <ol>
-       <li><a href="#examples"><span class="secno">5.4.1.1 </span>Examples</a></ol></li>
-     <li><a href="#vevent"><span class="secno">5.4.2 </span>vEvent</a>
+       <li><a href="#examples"><span class="secno">5.4.2.1 </span>Examples</a></ol></li>
+     <li><a href="#vevent"><span class="secno">5.4.3 </span>vEvent</a>
       <ol>
-       <li><a href="#examples-0"><span class="secno">5.4.2.1 </span>Examples</a></ol></li>
-     <li><a href="#bibtex"><span class="secno">5.4.3 </span>BibTeX</a>
+       <li><a href="#examples-0"><span class="secno">5.4.3.1 </span>Examples</a></ol></li>
+     <li><a href="#bibtex"><span class="secno">5.4.4 </span>BibTeX</a>
       <ol>
-       <li><a href="#examples-1"><span class="secno">5.4.3.1 </span>Examples</a></ol></li>
-     <li><a href="#rdf"><span class="secno">5.4.4 </span>RDF</a></ol></li>
+       <li><a href="#examples-1"><span class="secno">5.4.4.1 </span>Examples</a></ol></li>
+     <li><a href="#licensing-works"><span class="secno">5.4.5 </span>Licensing works</a>
+      <ol>
+       <li><a href="#examples-2"><span class="secno">5.4.5.1 </span>Examples</a></ol></ol></li>
    <li><a href="#converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</a>
     <ol>
      <li><a href="#json"><span class="secno">5.5.1 </span>JSON</a></li>
-     <li><a href="#rdf-0"><span class="secno">5.5.2 </span>RDF</a></li>
+     <li><a href="#rdf"><span class="secno">5.5.2 </span>RDF</a></li>
      <li><a href="#vcard-0"><span class="secno">5.5.3 </span>vCard</a></li>
      <li><a href="#icalendar"><span class="secno">5.5.4 </span>iCalendar</a></li>
      <li><a href="#bibtex-0"><span class="secno">5.5.5 </span>BibTeX</a></li>
@@ -36964,7 +36967,11 @@
   </div><h3 id="predefined-vocabularies"><span class="secno">5.4 </span>Predefined vocabularies</h3><p>A number of <dfn id="predefined-type" title="predefined type">predefined types</dfn>
   exist, for describing common structures. Each such type has a set of
   <dfn id="predefined-property-name" title="predefined property name">predefined property
-  names</dfn> that are used to describe data of that type.<h4 id="vcard"><span class="secno">5.4.1 </span>vCard</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-vcard" title="md-vcard"><code>vcard</code></dfn> represents a person's or
+  names</dfn> that are used to describe data of that type.<h4 id="general"><span class="secno">5.4.1 </span>General</h4><p>The <dfn id="md-about" title="md-about"><code>about</code></dfn> property can
+  be used to name an <a href="#concept-item" title="concept-item">item</a> for the
+  purposes of identifying or refering to the data defined in that
+  item.<p>A single property with the name <code title="md-about"><a href="#md-about">about</a></code> may be present within each <a href="#concept-item" title="concept-item">item</a>. Its <a href="#concept-property-value" title="concept-property-value">value</a> must be an
+  <a href="#absolute-url">absolute URL</a>.<h4 id="vcard"><span class="secno">5.4.2 </span>vCard</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-vcard" title="md-vcard"><code>vcard</code></dfn> represents a person's or
   organization's contact information.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
   name">predefined property names</a>. They are based on the
   vocabulary defined in the vCard specification, where more
@@ -37994,7 +38001,7 @@
 
    <dd>
 
-  </dl><h5 id="examples"><span class="secno">5.4.1.1 </span>Examples</h5><div class="example">
+  </dl><h5 id="examples"><span class="secno">5.4.2.1 </span>Examples</h5><div class="example">
 
    <p>Here is a long example <code title="md-vcard"><a href="#md-vcard">vcard</a></code> for a
    fictional character called "Jack Bauer":</p>
@@ -38067,7 +38074,7 @@
  &lt;/span&gt;
 &lt;/address&gt;</pre>
 
-  </div><h4 id="vevent"><span class="secno">5.4.2 </span>vEvent</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-vevent" title="md-vevent"><code>vevent</code></dfn> represents an event.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
+  </div><h4 id="vevent"><span class="secno">5.4.3 </span>vEvent</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-vevent" title="md-vevent"><code>vevent</code></dfn> represents an event.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
   name">predefined property names</a>. They are based on the
   vocabulary defined in the iCalendar specification, where more
   information on how to interpret the values can be found. <a href="#references">[RFC2445]</a><p class="note">Only the parts of the iCalendar vocabulary relating
@@ -38579,7 +38586,7 @@
 
     </ul></li>
 
-  </ol><h5 id="examples-0"><span class="secno">5.4.2.1 </span>Examples</h5><!-- get more from http://www.ietf.org/rfc/rfc2445.txt --><div class="example">
+  </ol><h5 id="examples-0"><span class="secno">5.4.3.1 </span>Examples</h5><!-- get more from http://www.ietf.org/rfc/rfc2445.txt --><div class="example">
 
    <p>Here is an example of a page that uses the <code title="md-vevent"><a href="#md-vevent">vevent</a></code> vocabulary to mark up an event:</p>
 
@@ -38655,7 +38662,7 @@
  &lt;meta itemprop="description" content="via livebrum.co.uk"&gt;
 &lt;/div&gt;</pre>
 
-  </div><h4 id="bibtex"><span class="secno">5.4.3 </span>BibTeX</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-bibtex" title="md-bibtex"><code>bibtex</code></dfn> represents a
+  </div><h4 id="bibtex"><span class="secno">5.4.4 </span>BibTeX</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-bibtex" title="md-bibtex"><code>bibtex</code></dfn> represents a
   bibliography entry.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
   name">predefined property names</a>. They are based on the
   vocabulary defined by the BibTeX format, the documentation for which
@@ -38708,7 +38715,7 @@
      <dt><dfn id="md-bibtex-entrytype-unpublished" title="md-bibtex-entrytype-unpublished"><code>unpublished</code></dfn></dt>
      <dd><p>An unpublished document.</dd>
 
-    </dl><p>Exactly one property with the name <code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code> mush be present
+    </dl><p>Exactly one property with the name <code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code> must be present
     within each <a href="#concept-item" title="concept-item">item</a> with the type
     <code title="md-bibtex"><a href="#md-bibtex">bibtex</a></code>.</p>
 
@@ -39367,7 +39374,7 @@
       <strong><code title="md-bibtex-note"><a href="#md-bibtex-note">note</a></code></strong>*,
       <strong><code title="md-bibtex-title"><a href="#md-bibtex-title">title</a></code></strong>*,
       <code title="md-bibtex-year"><a href="#md-bibtex-year">year</a></code>
-  </table><h5 id="examples-1"><span class="secno">5.4.3.1 </span>Examples</h5><div class="example">
+  </table><h5 id="examples-1"><span class="secno">5.4.4.1 </span>Examples</h5><div class="example">
 
    <p>This example shows how an article's footer can give the citation
    information for the article:</p>
@@ -39388,10 +39395,76 @@
  &lt;/footer&gt;
 &lt;/article&gt;</pre>
 
-  </div><h4 id="rdf"><span class="secno">5.4.4 </span>RDF</h4><p>The <dfn id="md-about" title="md-about"><code>about</code></dfn> property can
-  be used to name an <a href="#concept-item" title="concept-item">item</a> for the
-  purposes of refering to the data defined in that item from RDF.<p>A single property with the name <code title="md-about"><a href="#md-about">about</a></code> may be present within each <a href="#concept-item" title="concept-item">item</a>. Its <a href="#concept-property-value" title="concept-property-value">value</a> must be an
-  <a href="#absolute-url">absolute URL</a>.<div class="impl">
+  </div><h4 id="licensing-works"><span class="secno">5.4.5 </span>Licensing works</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-work" title="md-work"><code>work</code></dfn> represents a work (e.g. an
+  article, an image, a video, a song, etc). This type is primarily
+  intended to allow authors to include licensing information for
+  works.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
+  name">predefined property names</a>.<dl><dt><dfn id="md-work-title" title="md-work-title"><code>title</code></dfn></dt>
+
+   <dd>
+
+    <p>Gives the name of the work.</p>
+
+    <p>A single property with the name <code title="md-work-title"><a href="#md-work-title">title</a></code> may be present within each
+    <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-work"><a href="#md-work">work</a></code>.</p>
+
+   </dd>
+
+
+   <dt><dfn id="md-work-author" title="md-work-author"><code>author</code></dfn></dt>
+
+   <dd>
+
+    <p>Gives the name or contact information of one of the authors or
+    creators of the work.</p>
+
+    <p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
+    either an <a href="#concept-item" title="concept-item">item</a> with the type
+    <code title="md-vcard"><a href="#md-vcard">vcard</a></code>, or text.</p>
+
+    <p>Any number of properties with the name <code title="md-work-author"><a href="#md-work-author">author</a></code> may be present within each
+    <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-work"><a href="#md-work">work</a></code>.</p>
+
+   </dd>
+
+
+   <dt><dfn id="md-work-license" title="md-work-license"><code>license</code></dfn></dt>
+
+   <dd>
+
+    <p>Identifies one of the licenses under which the work is
+    available.</p>
+
+    <p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
+    an <a href="#absolute-url">absolute URL</a>.</p>
+
+    <p>Any number of properties with the name <code title="md-work-license"><a href="#md-work-license">license</a></code> may be present within each
+    <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-work"><a href="#md-work">work</a></code>.</p>
+
+   </dd>
+
+  </dl><p>In addition, exactly one property with the name <code title="md-about"><a href="#md-about">about</a></code> must be present within each <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-work"><a href="#md-work">work</a></code>, giving the <a href="#url">URL</a> of the
+  work.<h5 id="examples-2"><span class="secno">5.4.5.1 </span>Examples</h5><div class="example">
+
+   <p>This example shows an embedded image entitiled <cite>My
+   Pond</cite>, licensed under the Creative Commons Attribution-Share
+   Alike 3.0 United States License and the MIT license
+   simultaneously.</p>
+
+   <pre>&lt;figure <strong>item="work"</strong>&gt;
+ &lt;img <strong>itemprop="about"</strong> src="mypond.jpeg"&gt;
+ &lt;legend&gt;
+  &lt;p&gt;&lt;cite <strong>itemprop="title"</strong>&gt;My Pond&lt;/cite&gt;&lt;/p&gt;
+  &lt;p&gt;&lt;small&gt;Licensed under the &lt;a <strong>itemprop="license"</strong>
+  href="http://creativecommons.org/licenses/by-sa/3.0/us/"&gt;Creative
+  Commons Attribution-Share Alike 3.0 United States License&lt;/a&gt;
+  and the &lt;a <strong>itemprop="license"</strong>
+  href="http://www.opensource.org/licenses/mit-license.php"&gt;MIT
+  license&lt;/a&gt;.&lt;/small&gt;
+ &lt;/legend&gt;
+&lt;/figure&gt;</pre>
+
+  </div><div class="impl">
 
   <h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3>
 
@@ -39508,7 +39581,7 @@
 
    <li><p>Return <var title="">result</var>.</li>
 
-  </ol><h4 id="rdf-0"><span class="secno">5.5.2 </span>RDF</h4>
+  </ol><h4 id="rdf"><span class="secno">5.5.2 </span>RDF</h4>
 
   <p>To convert a <code>Document</code> to RDF, a user agent must run
   the following algorithm:</p>
@@ -39648,12 +39721,17 @@
    property. Otherwise, let <var title="">subject</var> be a new blank
    node.</li>
 
+   <li><p>Let <var title="">is-work</var> be false.</li>
+
    <li>
 
     <p>For each <a href="#item-types" title="item types">item type</a> <var title="">type</var> of <var title="">item</var>, run the following
     substeps:</p>
 
-    <ol><li><p>If <var title="">type</var> is not an <a href="#absolute-url">absolute
+    <ol><li><p>If <var title="">type</var> is <code title="md-work"><a href="#md-work">work</a></code>, let <var title="">is-work</var> be
+     true.</li>
+
+     <li><p>If <var title="">type</var> is not an <a href="#absolute-url">absolute
      URL</a>, then let <var title="">type</var> be the result of
      concatenating the string "<code title="">http://www.w3.org/1999/xhtml/custom#</code>" with <var title="">type</var>, with any characters in <var title="">type</var> that are not valid in the &lt;ifragment&gt;
      production of the IRI syntax being %-escaped. <a href="#references">[RFC3987]</a></li>
@@ -39698,6 +39776,13 @@
       <ol><li><p>If <var title="">name</var> is equal to the string
        "<code title="md-about"><a href="#md-about">about</a></code>", skip this name.</li>
 
+       <li><p>Otherwise, if <var title="">is-work</var> is true, and <var title="">name</var> is equal to the string "<code title="md-work-title"><a href="#md-work-title">title</a></code>", let <var title="">name</var> be the string "<code title="">http://purl.org/dc/elements/1.1/title</code>".</li>
+
+       <li><p>Otherwise, if <var title="">is-work</var> is true, and <var title="">name</var> is equal to the string "<code title="md-work-author"><a href="#md-work-author">author</a></code>", let <var title="">name</var> be the string "<code title="">http://creativecommons.org/ns#attributionName</code>".</li>
+
+       <li><p>Otherwise, if <var title="">is-work</var> is true, and
+       <var title="">name</var> is equal to the string "<code title="md-work-license"><a href="#md-work-license">license</a></code>", let <var title="">name</var> be the string "<code title="">http://www.w3.org/1999/xhtml/vocab#license</code>".</li>
+
        <li><p>Otherwise, if <var title="">name</var> is not an
        <a href="#absolute-url">absolute URL</a>, then let <var title="">name</var> be
        the result of concatenating the string "<code title="">http://www.w3.org/1999/xhtml/custom#</code>" with <var title="">name</var>, with any characters in <var title="">name</var> that are not valid in the &lt;ifragment&gt;
Received on Tuesday, 7 July 2009 23:21:47 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 7 July 2009 23:21:48 GMT