Difference between revisions of "License Deeds (Metadata)"

From Creative Commons
Jump to: navigation, search
(Standard Licenses)
(More Permissions)
 
(20 intermediate revisions by 2 users not shown)
Line 23: Line 23:
  
 
The standard Creative Commons License Class Deeds(all non-Public Domain licenses) will display a notice instructing how the referrer must be attributed and generate an HTML+RDFa marking that can be used to attribute the work when sufficient metadata is available on the referring page. The Public Domain Deed's provide similar functionality; an HTML+RDFa string that can be used as a citation for the referring work in the Public Domain when sufficient metadata is available. The tables below describe which metadata triples must be available, and how each triple can affect the output seen on the deeds.
 
The standard Creative Commons License Class Deeds(all non-Public Domain licenses) will display a notice instructing how the referrer must be attributed and generate an HTML+RDFa marking that can be used to attribute the work when sufficient metadata is available on the referring page. The Public Domain Deed's provide similar functionality; an HTML+RDFa string that can be used as a citation for the referring work in the Public Domain when sufficient metadata is available. The tables below describe which metadata triples must be available, and how each triple can affect the output seen on the deeds.
 +
 +
{{Infobox|This document contains prefixed identifiers for RDFa predicates, a table of these prefixes is presented at the bottom of this document. }}
  
 
==== Standard Licenses ====
 
==== Standard Licenses ====
Line 137: Line 139:
 
* '''Creator''': dct:creator, dc:creator, cc:attributionURL
 
* '''Creator''': dct:creator, dc:creator, cc:attributionURL
 
* '''Creator Title''': dct:title of '''Creator''', dc:title of '''Creator''', foaf:name of '''Creator'''
 
* '''Creator Title''': dct:title of '''Creator''', dc:title of '''Creator''', foaf:name of '''Creator'''
 +
* '''Title''': dct:title, dc:title
 +
 +
{| class="wikitable" style="padding:10px;"
 +
|-
 +
! Curator
 +
! Curator Title
 +
! Creator
 +
! Creator Title
 +
! Citation
 +
! Title
 +
|-
 +
| http://example.com/
 +
| Example
 +
| http://testing.com/
 +
| Testing
 +
| Work Title
 +
| <pre>
 +
<div xmlns:cc="http://creativecommons.org/ns#"   
 +
    xmlns:dct="http://purl.org/dc/terms/"   
 +
    about="http://example.com/work">
 +
  <span property="dct:title">Work Title</span> /
 +
  <a rel="cc:attributionURL dct:creator"
 +
    property="cc:attributionName"
 +
    href="http://example.com/">Example</a>
 +
  (<a rel="cc:attributionURL dct:publisher"
 +
      href="http://testing.com/">Testing</a>) /
 +
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
 +
    CC0 1.0
 +
  </a>
 +
</div>
 +
</pre>
 +
|-
 +
| http://example.com/
 +
| Example
 +
| http://testing.com/
 +
| Testing
 +
|
 +
| <pre>
 +
<div xmlns:cc="http://creativecommons.org/ns#"   
 +
    xmlns:dct="http://purl.org/dc/terms/"   
 +
    about="http://example.com/work">
 +
  <a rel="cc:attributionURL dct:creator"
 +
    property="cc:attributionName"
 +
    href="http://example.com/">Example</a>
 +
  (<a rel="cc:attributionURL dct:publisher"
 +
      href="http://testing.com/">Testing</a>) /
 +
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
 +
    CC0 1.0
 +
  </a>
 +
</div>
 +
</pre>
 +
|-
 +
| http://example.com/
 +
| Example
 +
| http://testing.com/
 +
|
 +
|
 +
| <pre>
 +
<div xmlns:cc="http://creativecommons.org/ns#"   
 +
    xmlns:dct="http://purl.org/dc/terms/"   
 +
    about="http://example.com/work">
 +
  <a rel="cc:attributionURL dct:creator"
 +
    property="cc:attributionName"
 +
    href="http://example.com/">Example</a>
 +
  (<a rel="cc:attributionURL dct:publisher"
 +
      href="http://testing.com/">http://testing.com/</a>) /
 +
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
 +
    CC0 1.0
 +
  </a>
 +
</div>
 +
</pre>
 +
|-
 +
| http://example.com/
 +
| Example
 +
|
 +
|
 +
|
 +
| <pre>
 +
<div xmlns:cc="http://creativecommons.org/ns#"   
 +
    xmlns:dct="http://purl.org/dc/terms/"   
 +
    about="http://example.com/work">
 +
  <a rel="cc:attributionURL dct:creator"
 +
    property="cc:attributionName"
 +
    href="http://example.com/">Example</a> /
 +
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
 +
    CC0 1.0
 +
  </a>
 +
</div>
 +
</pre>
 +
|-
 +
| http://example.com/
 +
|
 +
|
 +
|
 +
|
 +
| <pre>
 +
<div xmlns:cc="http://creativecommons.org/ns#"   
 +
    xmlns:dct="http://purl.org/dc/terms/"   
 +
    about="http://example.com/work">
 +
  <a rel="cc:attributionURL dct:creator"
 +
    href="http://example.com/">http://example.com/</a> /
 +
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
 +
    CC0 1.0
 +
  </a>
 +
</div>
 +
</pre>
 +
|-
 +
|
 +
|
 +
| http://testing.com/
 +
| Testing
 +
| Work Title
 +
| <pre>
 +
<div xmlns:cc="http://creativecommons.org/ns#"   
 +
    xmlns:dct="http://purl.org/dc/terms/"   
 +
    about="http://example.com/work">
 +
  <span property="dct:title">Work Title</span> /
 +
  (<a rel="cc:attributionURL dct:publisher"
 +
      href="http://testing.com/">Testing</a>) /
 +
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
 +
    CC0 1.0
 +
  </a>
 +
</div>
 +
</pre>
 +
|-
 +
|}
  
== Examples ==
 
  
{{Infobox|We are currently developing comprehensive examples which will supersede these; these examples are likely to go away, break, or be otherwise changed at some point in the future.}}
+
=== Work Registration ===
  
<nowiki>
+
In order for the license deeds to display information about a work's registration, there must exist a triple for '''sioc:has_owner''' on the referring document.
<div xmlns:cc="http://creativecommons.org/ns#">
 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
 
    <img src="http://i.creativecommons.org/l/by/3.0/88x31.png" />
 
  </a>
 
  <br />
 
  This page, by
 
  <a property="cc:attributionName"
 
    rel="cc:attributionURL"
 
    href="http://lessig.org/">Lawrence Lessig</a>,
 
  is licensed under a
 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
 
    Creative Commons Attribution License</a>.
 
</div>
 
</nowiki>
 
  
 +
When a valid CC Network user profile URI is specified as the '''sioc:has_owner''', the resulting RDFa graph will look like the following:
  
To see the examples, visit the work pages (listed here) and click through to the deed.
+
<pre>
 +
<http://example.com/> <sioc:has_owner> <https://creativecommons.net/johndoig/>
 +
<https://creativecommons.net/username/> <sioc:name> "Username"
 +
<https://creativecommons.net/username/> <sioc:member_of> <https://creativecommons.net/>
 +
<https://creativecommons.net/> <dct:title> "CC Network"
 +
<https://creativecommons.net/> <sioc_service:has_service> <https://creativecommons.net/r/lookup/>
 +
<https://creativecommons.net/r/lookup/> <sioc_service_protocol> <http://wiki.creativecommons.org/work-lookup>
 +
</pre>
  
* http://labs.creativecommons.org/~nathan/tests/pdm/monalisa.html Public Domain Mark with use guidelines
+
In order for this graph to form, the URI '''https://creativecommons.net/username/''' must be a valid CC Network profile URI, and the user needs to have registered the work ('''http://example.com/''') with their account on the CC Network. When those two conditions are met, the license deeds will display a notice that reads:
* http://labs.creativecommons.org/~nathan/tests/attrib.html Basic attribution information
 
* http://labs.creativecommons.org/~nathan/tests/pic/guidelines.html CC0 with use guidelines
 
* http://labs.creativecommons.org/~nathan/info/decoupling.html Attribution information with registration
 
  
== Consumed Metadata ==
+
<div style="background:#D4EFB9;padding:1em !important;font-size:1em !important;line-height:1em !important;">
 +
[https://creativecommons.net/username/ Username] has registered [https://creativecommons.net/r/lookup?uri=http://lessig.org/blog/ this work] at the [https://creativecommons.net/ CC Network]
 +
</div>
  
{{stub}}
+
=== More Permissions ===
  
* xhtml:license, cc:license, dct:license
+
When the referring document contains [[CCPlus]] metadata, the License Deed will display information to the user where they may discover more information regarding the permissions to the work. In order for the License Deed to display the information, the triple for the predicate '''cc:morePermissions''' mapped to a URI of a document detailing the extra permissions/restrictions associated with the referring work.
* dct:publisher, dct:creator
 
* Registration metadata; see [http://labs.creativecommons.org/~nathan/oscri/describing-registrations.html Describing Work Registrations] for details.
 
  
Namespaces:
+
== Examples ==
  
* xhtml
+
See [http://labs.creativecommons.org/2011/ccrel-guide CC REL By Example] for an extensive set of examples.
* cc
 
* dct
 
* dc
 
* sioc
 

Latest revision as of 21:11, 12 April 2011

Creative Commons license deeds will display information about the referring work if available. This page documents what information is displayed by the deeds.

How it Works

When you visit a CC legal deed by clicking on a link from a licensed work, CC looks at the page you came from (the referrer) to see if it contains information about the licensed work. This information can include how the creator wants to be attributed, who identified a work as in the public domain, etc. If present, this information is displayed for the user, and used to generate copy and paste attribution/citation HTML.

Limitations

Works that require a password to access them can not be checked by the server software.

If the referring page contains multiple works under the same license (even with properly scoped metadata), we can not determine which link was clicked on. In that situation, we err on the side of certainty and do not display the information.

If the software can not unambiguously determine the title or attribution information, we err on the side of certainty and do not display the information.

Features

The Creative Commons License Deeds will provide extra information about the referrer in three general categories:

  • How to attribute/cite the work
  • Work registration details
  • Where to read more permissions assigned to the work

Work Attribution / Citation

The standard Creative Commons License Class Deeds(all non-Public Domain licenses) will display a notice instructing how the referrer must be attributed and generate an HTML+RDFa marking that can be used to attribute the work when sufficient metadata is available on the referring page. The Public Domain Deed's provide similar functionality; an HTML+RDFa string that can be used as a citation for the referring work in the Public Domain when sufficient metadata is available. The tables below describe which metadata triples must be available, and how each triple can affect the output seen on the deeds.

This document contains prefixed identifiers for RDFa predicates, a table of these prefixes is presented at the bottom of this document.

Standard Licenses

Supported RDFa Predicates (in order of precedence):

  • Attribution Name: cc:attributionName, foaf:name of dct:creator, foaf:name of dc:creator
  • Attribution URL: cc:attributionURL
  • Title: dct:title, dc:title

Assuming the referring URI is http://example.com/work:

Attribution Name Attribution URL Title Marking
Example http://example.com/ Testing
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <span property="dct:title">Testing</span> 
  (<a rel="cc:attributionURL" property="cc:attributionName" 
      href="http://example.com/">Example</a>) / 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
    CC BY 3.0
  </a>
</div>
Example http://example.com/
<div xmlns:cc="http://creativecommons.org/ns#" 
     about="http://example.com/work">
  <a rel="cc:attributionURL" property="cc:attributionName" 
     href="http://example.com/">Example</a> / 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
    CC BY 3.0
  </a>
</div>
Example Testing
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <span property="dct:title">Testing</span> 
  (<span property="cc:attributionName">Example</span>) / 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
    CC BY 3.0
  </a>
</div>
Example
<div xmlns:cc="http://creativecommons.org/ns#" 
     about="http://example.com/work">
  <span property="cc:attributionName">Example</span> / 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
    CC BY 3.0
  </a>
</div>
http://example.com/ Testing
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <a rel="cc:attributionURL" 
     property="dct:title" 
     href="http://example.com/">Testing</a> / 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
    CC BY 3.0
  </a>
</div>
http://example.com/
<div xmlns:cc="http://creativecommons.org/ns#" 
     about="http://example.com/work">
  <a rel="cc:attributionURL" 
     href="http://example.com/">http://example.com/</a> / 
  <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
    CC BY 3.0
  </a>
</div>

Public Domain

Supported RDFa Predicates (in order of precedence):

  • Curator: dct:publisher, dc:publisher, marcel:dtc
  • Curator Title: dct:title of Curator, dc:title of Curator, foaf:name of Curator
  • Creator: dct:creator, dc:creator, cc:attributionURL
  • Creator Title: dct:title of Creator, dc:title of Creator, foaf:name of Creator
  • Title: dct:title, dc:title
Curator Curator Title Creator Creator Title Citation Title
http://example.com/ Example http://testing.com/ Testing Work Title
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <span property="dct:title">Work Title</span> / 
  <a rel="cc:attributionURL dct:creator" 
     property="cc:attributionName" 
     href="http://example.com/">Example</a>
  (<a rel="cc:attributionURL dct:publisher" 
      href="http://testing.com/">Testing</a>) / 
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
    CC0 1.0
  </a>
</div>
http://example.com/ Example http://testing.com/ Testing
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <a rel="cc:attributionURL dct:creator" 
     property="cc:attributionName" 
     href="http://example.com/">Example</a>
  (<a rel="cc:attributionURL dct:publisher" 
      href="http://testing.com/">Testing</a>) / 
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
    CC0 1.0
  </a>
</div>
http://example.com/ Example http://testing.com/
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <a rel="cc:attributionURL dct:creator" 
     property="cc:attributionName" 
     href="http://example.com/">Example</a>
  (<a rel="cc:attributionURL dct:publisher" 
      href="http://testing.com/">http://testing.com/</a>) / 
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
    CC0 1.0
  </a>
</div>
http://example.com/ Example
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <a rel="cc:attributionURL dct:creator" 
     property="cc:attributionName" 
     href="http://example.com/">Example</a> /
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
    CC0 1.0
  </a>
</div>
http://example.com/
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <a rel="cc:attributionURL dct:creator" 
     href="http://example.com/">http://example.com/</a> /
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
    CC0 1.0
  </a>
</div>
http://testing.com/ Testing Work Title
<div xmlns:cc="http://creativecommons.org/ns#"    
     xmlns:dct="http://purl.org/dc/terms/"    
     about="http://example.com/work">
  <span property="dct:title">Work Title</span> / 
  (<a rel="cc:attributionURL dct:publisher" 
      href="http://testing.com/">Testing</a>) / 
  <a rel="license" href="http://creativecommons.org/publicdomain/zero/1.0/">
    CC0 1.0
  </a>
</div>


Work Registration

In order for the license deeds to display information about a work's registration, there must exist a triple for sioc:has_owner on the referring document.

When a valid CC Network user profile URI is specified as the sioc:has_owner, the resulting RDFa graph will look like the following:

<http://example.com/> <sioc:has_owner> <https://creativecommons.net/johndoig/>
<https://creativecommons.net/username/> <sioc:name> "Username"
<https://creativecommons.net/username/> <sioc:member_of> <https://creativecommons.net/>
<https://creativecommons.net/> <dct:title> "CC Network"
<https://creativecommons.net/> <sioc_service:has_service> <https://creativecommons.net/r/lookup/>
<https://creativecommons.net/r/lookup/> <sioc_service_protocol> <http://wiki.creativecommons.org/work-lookup>

In order for this graph to form, the URI https://creativecommons.net/username/ must be a valid CC Network profile URI, and the user needs to have registered the work (http://example.com/) with their account on the CC Network. When those two conditions are met, the license deeds will display a notice that reads:

Username has registered this work at the CC Network

More Permissions

When the referring document contains CCPlus metadata, the License Deed will display information to the user where they may discover more information regarding the permissions to the work. In order for the License Deed to display the information, the triple for the predicate cc:morePermissions mapped to a URI of a document detailing the extra permissions/restrictions associated with the referring work.

Examples

See CC REL By Example for an extensive set of examples.