[html5] r3370 - [] (0) Microdata: Introduce a vocabulary for licensing works which maps to ccREL [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Jul 7 16:21:31 PDT 2009
Author: ianh
Date: 2009-07-07 16:21:29 -0700 (Tue, 07 Jul 2009)
New Revision: 3370
Modified:
index
source
Log:
[] (0) Microdata: Introduce a vocabulary for licensing works which maps to ccREL at the RDF layer.
Modified: index
===================================================================
--- index 2009-07-07 21:40:59 UTC (rev 3369)
+++ index 2009-07-07 23:21:29 UTC (rev 3370)
@@ -614,20 +614,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>
@@ -41515,8 +41518,20 @@
names</dfn> that are used to describe data of that type.</p>
- <h4 id=vcard><span class=secno>5.4.1 </span>vCard</h4>
+ <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>
+
+ <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>.</p>
+
+
+ <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>
@@ -42557,7 +42572,7 @@
<dd>
- </dl><h5 id=examples><span class=secno>5.4.1.1 </span>Examples</h5>
+ </dl><h5 id=examples><span class=secno>5.4.2.1 </span>Examples</h5>
<div class=example>
@@ -42638,7 +42653,7 @@
- <h4 id=vevent><span class=secno>5.4.2 </span>vEvent</h4>
+ <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>
@@ -43160,7 +43175,7 @@
</ul></li>
- </ol><h5 id=examples-0><span class=secno>5.4.2.1 </span>Examples</h5>
+ </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 -->
@@ -43243,7 +43258,7 @@
</div>
- <h4 id=bibtex><span class=secno>5.4.3 </span>BibTeX</h4>
+ <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>
@@ -43302,7 +43317,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>
@@ -43963,7 +43978,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>
+ </table><h5 id=examples-1><span class=secno>5.4.4.1 </span>Examples</h5>
<div class=example>
@@ -43990,17 +44005,90 @@
- <h4 id=rdf><span class=secno>5.4.4 </span>RDF</h4>
+ <h4 id=licensing-works><span class=secno>5.4.5 </span>Licensing works</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>
+ <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>
- <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>.</p>
+ <p>The following are the type's <a href=#predefined-property-name title="predefined property
+ name">predefined property names</a>.</p>
+ <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.</p>
+
+
+ <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><figure <strong>item="work"</strong>>
+ <img <strong>itemprop="about"</strong> src="mypond.jpeg">
+ <legend>
+ <p><cite <strong>itemprop="title"</strong>>My Pond</cite></p>
+ <p><small>Licensed under the <a <strong>itemprop="license"</strong>
+ href="http://creativecommons.org/licenses/by-sa/3.0/us/">Creative
+ Commons Attribution-Share Alike 3.0 United States License</a>
+ and the <a <strong>itemprop="license"</strong>
+ href="http://www.opensource.org/licenses/mit-license.php">MIT
+ license</a>.</small>
+ </legend>
+</figure></pre>
+
+ </div>
+
+
+
<div class=impl>
<h3 id=converting-html-to-other-formats><span class=secno>5.5 </span>Converting HTML to other formats</h3>
@@ -44118,7 +44206,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>
@@ -44258,12 +44346,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 <ifragment>
production of the IRI syntax being %-escaped. <a href=#refsRFC3987>[RFC3987]</a></li>
@@ -44308,6 +44401,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 <ifragment>
Modified: source
===================================================================
--- source 2009-07-07 21:40:59 UTC (rev 3369)
+++ source 2009-07-07 23:21:29 UTC (rev 3370)
@@ -46751,6 +46751,21 @@
names</dfn> that are used to describe data of that type.</p>
+
+ <h4>General</h4>
+
+ <p>The <dfn title="md-about"><code>about</code></dfn> property can
+ be used to name an <span title="concept-item">item</span> for the
+ purposes of identifying or refering to the data defined in that
+ item.</p>
+
+ <p>A single property with the name <code
+ title="md-about">about</code> may be present within each <span
+ title="concept-item">item</span>. Its <span
+ title="concept-property-value">value</span> must be an
+ <span>absolute URL</span>.</p>
+
+
<h4>vCard</h4>
<p>An item with the <span>predefined type</span> <dfn
@@ -48883,7 +48898,7 @@
</dl>
<p>Exactly one property with the name <code
- title="md-bibtex-entrytype">entrytype</code> mush be present
+ title="md-bibtex-entrytype">entrytype</code> must be present
within each <span title="concept-item">item</span> with the type
<code title="md-bibtex">bibtex</code>.</p>
@@ -49703,20 +49718,105 @@
- <h4>RDF</h4>
+ <h4>Licensing works</h4>
- <p>The <dfn title="md-about"><code>about</code></dfn> property can
- be used to name an <span title="concept-item">item</span> for the
- purposes of refering to the data defined in that item from RDF.</p>
+ <p>An item with the <span>predefined type</span> <dfn
+ 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>
- <p>A single property with the name <code
- title="md-about">about</code> may be present within each <span
- title="concept-item">item</span>. Its <span
- title="concept-property-value">value</span> must be an
- <span>absolute URL</span>.</p>
+ <p>The following are the type's <span title="predefined property
+ name">predefined property names</span>.</p>
+ <dl>
+ <dt><dfn 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">title</code> may be present within each
+ <span title="concept-item">item</span> with the type <code
+ title="md-work">work</code>.</p>
+
+ </dd>
+
+
+ <dt><dfn 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 <span title="concept-property-value">value</span> must be
+ either an <span title="concept-item">item</span> with the type
+ <code title="md-vcard">vcard</code>, or text.</p>
+
+ <p>Any number of properties with the name <code
+ title="md-work-author">author</code> may be present within each
+ <span title="concept-item">item</span> with the type <code
+ title="md-work">work</code>.</p>
+
+ </dd>
+
+
+ <dt><dfn 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 <span title="concept-property-value">value</span> must be
+ an <span>absolute URL</span>.</p>
+
+ <p>Any number of properties with the name <code
+ title="md-work-license">license</code> may be present within each
+ <span title="concept-item">item</span> with the type <code
+ title="md-work">work</code>.</p>
+
+ </dd>
+
+ </dl>
+
+ <p>In addition, exactly one property with the name <code
+ title="md-about">about</code> must be present within each <span
+ title="concept-item">item</span> with the type <code
+ title="md-work">work</code>, giving the <span>URL</span> of the
+ work.</p>
+
+
+ <h5>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><figure <strong>item="work"</strong>>
+ <img <strong>itemprop="about"</strong> src="mypond.jpeg">
+ <legend>
+ <p><cite <strong>itemprop="title"</strong>>My Pond</cite></p>
+ <p><small>Licensed under the <a <strong>itemprop="license"</strong>
+ href="http://creativecommons.org/licenses/by-sa/3.0/us/">Creative
+ Commons Attribution-Share Alike 3.0 United States License</a>
+ and the <a <strong>itemprop="license"</strong>
+ href="http://www.opensource.org/licenses/mit-license.php">MIT
+ license</a>.</small>
+ </legend>
+</figure></pre>
+
+ </div>
+
+
+
<div class="impl">
<h3>Converting HTML to other formats</h3>
@@ -50064,6 +50164,8 @@
property. Otherwise, let <var title="">subject</var> be a new blank
node.</p></li>
+ <li><p>Let <var title="">is-work</var> be false.</p></li>
+
<li>
<p>For each <span title="item types">item type</span> <var
@@ -50072,6 +50174,10 @@
<ol>
+ <li><p>If <var title="">type</var> is <code
+ title="md-work">work</code>, let <var title="">is-work</var> be
+ true.</p></li>
+
<li><p>If <var title="">type</var> is not an <span>absolute
URL</span>, then let <var title="">type</var> be the result of
concatenating the string "<code
@@ -50137,6 +50243,24 @@
<li><p>If <var title="">name</var> is equal to the string
"<code title="md-about">about</code>", skip this name.</p></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">title</code>", let <var
+ title="">name</var> be the string "<code
+ title="">http://purl.org/dc/elements/1.1/title</code>".</p></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">author</code>", let <var
+ title="">name</var> be the string "<code
+ title="">http://creativecommons.org/ns#attributionName</code>".</p></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">license</code>", let <var
+ title="">name</var> be the string "<code
+ title="">http://www.w3.org/1999/xhtml/vocab#license</code>".</p></li>
+
<li><p>Otherwise, if <var title="">name</var> is not an
<span>absolute URL</span>, then let <var title="">name</var> be
the result of concatenating the string "<code
More information about the Commit-Watchers
mailing list