Difference between revisions of "DiscoverEd Metadata"

From Creative Commons
Jump to: navigation, search
(ccLearn Syndication Guidelines)
(ccLearn Syndication Guidelines)
Line 20: Line 20:
 
For example, the tag for Language would become something like:
 
For example, the tag for Language would become something like:
  
<blockquote>cc:license:es</blockquote>
+
<pre>cc:license:es</pre>
  
 
Another example for Grade level could be:
 
Another example for Grade level could be:
  
<blockquote>cc:gradelevel:5-7</blockquote>
+
<pre>cc:gradelevel:5-7</pre>
  
 
The "cc:" specific fields should be embedded precisely as specified above in parentheses:
 
The "cc:" specific fields should be embedded precisely as specified above in parentheses:
Line 32: Line 32:
  
 
=== Embedding license data ===
 
=== Embedding license data ===
Since License is expected to be a URL, then we can leverage the Atom &lt;link&gt; element.  However we must markup the link element so as to identify is as a license URL.
+
Since License is expected to be a URL, then we can leverage the Atom &lt;link&gt; element.  However we must markup the link element so as to identify is as a license URL. This is accomplished with adding an the attribute rel="license" to the &lt;link&gt; element.  For example:
 +
 
 +
<pre>&lt;link rel="license" href="http://creativecommons.org/licenses/by/3.0/" /&gt;</pre>
  
 
== Embedding license information ==
 
== Embedding license information ==

Revision as of 23:49, 16 January 2008

ccLearn Syndication Guidelines

This document outlines the format in which ccLearn would like to receive syndication feeds for the data that will go into it's OER database.

The data must be supplied in an Atom or RSS format. These are two very well documented XML formats, and they are commonly implemted out-of-the-box by many content management systems.

Presently, ccLearn is looking for the following data:

  • Link: Full URL of the referenced resource.
  • Title: A brief descriptive title for the resource.
  • Summary: A relatively short summary/synopsis of the resource.
  • License: This should be a URL to the license e.g. http://creativecommons.org/licenses/by/3.0/ph/.
  • Grade level (cc:gradelevel): What grade or level this material is suitable for.
  • Language (cc:lang): The language of the referenced resource (not of the your site).
  • Subject (cc:subject): A more formal subject name e.g. Mathematics.

Because some of these fields do not have native Atom or RSS element definitions, we suggest that they be embedded as tags. In order for us to be able to recognize these within the feed, the tag content should be of the format

cc:<field>:

For example, the tag for Language would become something like:

cc:license:es

Another example for Grade level could be:

cc:gradelevel:5-7

The "cc:" specific fields should be embedded precisely as specified above in parentheses:

  • Subject: cc:subject:
  • Grade level: cc:gradelevel:
  • Language: cc:lang:

Embedding license data

Since License is expected to be a URL, then we can leverage the Atom <link> element. However we must markup the link element so as to identify is as a license URL. This is accomplished with adding an the attribute rel="license" to the <link> element. For example:

<link rel="license" href="http://creativecommons.org/licenses/by/3.0/" />

Embedding license information