Skip to content

Commit

Permalink
[] (0) Microdata: Introduce a vocabulary for licensing works which ma…
Browse files Browse the repository at this point in the history 
…ps to ccREL at the RDF layer.

git-svn-id: http://svn.whatwg.org/webapps@3370 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jul 7, 2009
1 parent dc51b5c commit 0b0d7d4
Show file tree
Hide file tree
Showing 2 changed files with 257 additions and 33 deletions.
146 changes: 123 additions & 23 deletions index
View file
Expand Up @@ -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>
Expand Down Expand Up @@ -41515,7 +41518,19 @@ document.body.appendChild(outer);</pre>
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>
Expand Down Expand Up @@ -42557,7 +42572,7 @@ document.body.appendChild(outer);</pre>

<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>

Expand Down Expand Up @@ -42638,7 +42653,7 @@ document.body.appendChild(outer);</pre>



<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>

Expand Down Expand Up @@ -43160,7 +43175,7 @@ document.body.appendChild(outer);</pre>

</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 -->

Expand Down Expand Up @@ -43243,7 +43258,7 @@ document.body.appendChild(outer);</pre>
</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>
Expand Down Expand Up @@ -43302,7 +43317,7 @@ document.body.appendChild(outer);</pre>
<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>

Expand Down Expand Up @@ -43963,7 +43978,7 @@ document.body.appendChild(outer);</pre>
<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>

Expand All @@ -43990,14 +44005,87 @@ document.body.appendChild(outer);</pre>



<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>&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>



Expand Down Expand Up @@ -44118,7 +44206,7 @@ document.body.appendChild(outer);</pre>

<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>
Expand Down Expand Up @@ -44258,12 +44346,17 @@ document.body.appendChild(outer);</pre>
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=#refsRFC3987>[RFC3987]</a></li>
Expand Down Expand Up @@ -44308,6 +44401,13 @@ document.body.appendChild(outer);</pre>
<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;
Expand Down

0 comments on commit 0b0d7d4

Please sign in to comment.