Difference between revisions of "License RDF"

From Creative Commons
Jump to: navigation, search
(New page: {{draft}} == License Files (.rdf) == === Attributes === * cc:license ** about ** permits ** requires ** prohibits * dc:title - The human readable name of the license. * dc:description - ...)
 
(updated protocol to https and added IIIF)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{draft}}
+
Creative Commons provides information on licenses for three audiences: lawyers, humans and machines.  The machine-readable information is described using [http://www.w3.org/RDF RDF] and made available from the [https://github.com/creativecommons/cc.licenserdf creativecommons/cc.licenserdf] git repository.
  
== License Files (.rdf) ==
+
== File Naming ==
=== Attributes ===
 
  
* cc:license
+
Files in the <code>license_rdf</code> module are named using the following convention:
** about
 
** permits
 
** requires
 
** prohibits
 
* dc:title - The human readable name of the license.
 
* dc:description - Description of the license.
 
* dc:coverage - The jurisdiction of the license. (country code from [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO3166])
 
* dc:relation
 
** hasVersion - version number
 
** isReplacedBy - indicates retired license ([http://www.ietf.org/rfc/rfc2396.txt URI])
 
** isBasedOn - indicates ported version ([http://www.ietf.org/rfc/rfc2396.txt URI])
 
* dc:type - always "License"
 
* dc:creator
 
* dc:publisher
 
* dc:identifier - URI of license ([http://www.ietf.org/rfc/rfc2396.txt URI])
 
  
=== Example ===
+
<pre>creativecommons.org_license_[license-code]_[version]_[jurisdiction]_.rdf</pre>
<pre><rdf:RDF
 
  xmlns="http://creativecommons.org/ns#"
 
  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 
  xmlns:dc="http://purl.org/dc/elements/1.1/"
 
  xmlns:dcq="http://purl.org/dc/terms/"
 
>
 
  <rdf:Description rdf:about="http://creativecommons.org/licenses/by-nd/2.0/za/">
 
    <dc:title>Creative Commons Attribution No Derivatives</dc:title>
 
    <dc:description>This license allows for redistribution, commercial and non-commercial,
 
as long as it is passed along unchanged and in whole, with credit to you.</dc:description>
 
    <dc:coverage>
 
        <dcq:ISO3166>
 
            <rdf:value>za</rdf:value>
 
        </dcq:ISO3166>
 
    </dc:coverage>
 
    <dc:hasVersion>2.0</dc:hasVersion>
 
    <dc:isReplacedBy>
 
        <dcq:URI>
 
            <rdf:value>http://creativecommons.org/licenses/by-nd/2.5/za/</rdf:value>
 
        </dcq:URI>
 
    </dc:isReplacedBy>
 
    <dc:isBasedOn>
 
        <dcq:URI>
 
            <rdf:value>http://creativecommons.org/licenses/by-nd/2.5/</rdf:value>
 
        </dcq:URI>
 
    </dc:isBasedOn>
 
    <dc:type>License</dc:type>
 
    <dc:creator>iCommons</dc:creator>
 
    <dc:publisher>Creative Commons</dc:publisher>
 
    <dc:identifier>http://creativecommons.org/licenses/by-nd/2.0/za/</dc:identifier>
 
  
    <rdf:type rdf:resource="http://creativecommons.org/ns#License"/>
+
More generally, you can take the URL of a license (i.e. <code>https://creativecommons.org/licenses/by/3.0/</code>), strip the protocol information (<code>https://</code>) and replace all forward-slashes (<code>/</code>) with underscores (<code>_</code>) to arrive at the base filename.  [[Liblicense]] provides a function to perform this mapping for you.
    <permits rdf:resource="http://creativecommons.org/ns#Distribution"/>
 
    <permits rdf:resource="http://creativecommons.org/ns#Reproduction"/>
 
    <requires rdf:resource="http://creativecommons.org/ns#Attribution"/>
 
    <requires rdf:resource="http://creativecommons.org/ns#Notice"/>
 
  </rdf:Description>
 
</rdf:RDF></pre>
 
  
=== Example (i18n) ===
+
== File Contents ==
<pre><rdf:RDF
 
  xmlns="http://creativecommons.org/ns#"
 
  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 
  xmlns:dc="http://purl.org/dc/elements/1.1/"
 
  xmlns:dcq="http://purl.org/dc/terms/"
 
>
 
  <rdf:Description rdf:about="http://creativecommons.org/licenses/by-nd/2.0/">
 
    <dc:title>
 
        <rdf:Alt>
 
            <rdf:li xml:lang="x-default">Creative Commons Attribution No Derivatives</rdf:li>
 
            <rdf:li xml:lang="es-cl">Creative Commons Atribución-SinDerivadas</rdf:li>
 
        </rdf:Alt>
 
    </dc:title>
 
    <dc:description>
 
        <rdf:Alt>
 
            <rdf:li xml:lang="x-default">This license allows for redistribution, commercial and non-commercial,
 
as long as it is passed along unchanged and in whole, with credit to you.</rdf:li>
 
        </rdf:Alt>
 
    </dc:description>
 
    <dc:coverage>
 
        <dcq:ISO3166>
 
            <rdf:value>us</rdf:value>
 
        </dcq:ISO3166>
 
    </dc:coverage>
 
    <dc:hasVersion>2.0</dc:hasVersion>
 
    <dc:isReplacedBy>
 
        <dcq:URI>
 
            <rdf:value>http://creativecommons.org/licenses/by-nd/2.5/</rdf:value>
 
        </dcq:URI>
 
    </dc:isReplacedBy>
 
    <dc:type>License</dc:type>
 
    <dc:creator>Creative Commons</dc:creator>
 
    <dc:publisher>Creative Commons</dc:publisher>
 
    <dc:identifier>http://creativecommons.org/licenses/by-nd/2.0/</dc:identifier>
 
  
    <rdf:type rdf:resource="http://creativecommons.org/ns#License"/>
+
Each file contains the RDF (encoded as RDF/XML) describing the particular license. Information described by the RDF includes:
    <permits rdf:resource="http://creativecommons.org/ns#Distribution"/>
+
 
    <permits rdf:resource="http://creativecommons.org/ns#Reproduction"/>
+
* license name, including translations
    <requires rdf:resource="http://creativecommons.org/ns#Attribution"/>
+
* license description, including translations
    <requires rdf:resource="http://creativecommons.org/ns#Notice"/>
+
* license properties, as described by [[ccREL]]
  </rdf:Description>
+
 
</rdf:RDF></pre>
+
== Usages ==
 +
 
 +
The license RDF files are used in the following CC applications:
 +
 
 +
* The license engine
 +
* [[OpenOfficeOrg Addin]]
 +
* [[Liblicense]]
 +
* IIIF (International Image Interoperability Framework)

Latest revision as of 21:41, 15 November 2019

Creative Commons provides information on licenses for three audiences: lawyers, humans and machines. The machine-readable information is described using RDF and made available from the creativecommons/cc.licenserdf git repository.

File Naming

Files in the license_rdf module are named using the following convention:

creativecommons.org_license_[license-code]_[version]_[jurisdiction]_.rdf

More generally, you can take the URL of a license (i.e. https://creativecommons.org/licenses/by/3.0/), strip the protocol information (https://) and replace all forward-slashes (/) with underscores (_) to arrive at the base filename. Liblicense provides a function to perform this mapping for you.

File Contents

Each file contains the RDF (encoded as RDF/XML) describing the particular license. Information described by the RDF includes:

  • license name, including translations
  • license description, including translations
  • license properties, as described by ccREL

Usages

The license RDF files are used in the following CC applications: