/about/COinS
Type: /type/page
body: value: <h2>Creating a COinS entry for each edition page</h2>
<p>See:</p>
<ul><li> <a href="http://ocoins.info/cobgbook.html">Brief Guide to Implementing OpenURL... for Books</a></li><li><a href="http://ocoins.info/">The COinS site</a></li></ul>
<p>In particular, note that all of the fields here with the exception of rft_id and rft.au are not repeatable.</p>
<h3>COinS</h3>
<p>COinS are Context Objects in Spans, a variant on the OpenURL, that carries bibliographic data in the OpenURL Context Object format. By including COinS in the Edition pages of the Open Library, software that is COinS aware can use the data there to generate a variety of services. COinS is used by Zotero, when found, and is used by some browser plug-ins to link from the bibliographic data to the user's local library holdings.</p>
<h3>The data elements</h3>
<table frame=border rules=all cellpadding="5%" style="font-size: 10pt">
<tr><th>Key</th>
    <th>OL field</th>
  </tr>

<tr><td align=right>ctx_ver</td><td>Z39.88-2004</td></tr>
<tr><td align=right>rfr_id</td><td>info:sid/openlibrary.org</td></tr>
<tr><td align=right>rft_val_fmt</td><td>info:ofi/fmt:kev:mtx:book</td></tr>
<tr>
    <td align=right>rft.id</td>
    <td>http://www.openlibrary.org/b/OL[n]M</td></tr>

<tr><td align=right>rft.genre</td><td>book</td></tr>
<tr><td align=right>rft.btitle</td>
    <td>title</td>
  </tr>

<tr><td align=right>rft.series</td><td>series</td></tr>

<tr><td align=right>rft.aulast</td><td>[author last name - do we have?]</td></tr>
<tr><td align=right>rft.aufirst</td><td>[author first name -  do we have?]</td></tr>

<tr><td align=right>rft.au</td>
    <td>authors, contributions</td>
  </tr>

<tr><td align=right>rft.pub</td>
    <td>publishers</td>
  </tr>
<tr><td align=right>rft.place</td>
    <td>publish_places</td>
  </tr>

<tr><td align=right>rft.edition</td>
    <td>edition_name</td>
  </tr>
<tr><td align=right>rft_id</td>
    <td>info:oclcnum/ + oclc_numbers</td>
  </tr>
<tr>
    <td align=right>rft_id</td>
    <td>info:lccn/ + lccn</td>
  </tr>
<tr><td align=right>rft.tpages</td>
    <td>number_of_pages</td>
  </tr>
<tr><td align=right>rft.isbn</td>
    <td>isbn_10, isbn_13</td>
  </tr>
</table>
<h3>Context Object in Span</h3>
<p>The data elements are written as key=value pairs:</p>
<p>rft.btitle=Harry Potter and the philosopher's stone
<br>rft.au=J. K. Rowling</p>
<p>and are concatened in a URL format using the ampersand as a separator</p>
<p>rft.btitle=Harry Potter and the philosopher's stone&amp;rft.au=J.K. Rowling</p>

<p>The entire string is then URL-encoded, and placed within a <code>span</code> 
  element in the html as the value of the <code>span</code> <code>title</code> 
  element, enclosed in quotes. The <code>span</code> also needs <code>class=&quot;Z3988&quot;</code>.</p>
<p>&lt;span <br>
  class=&quot;Z3988&quot; <br>
  title=&quot;ctx_ver=Z39.88-2004&amp;amp;rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&amp;amp;<br>
  rfr_id=info%3Asid%2Fopenlibrary.org&amp;amp;rft.genre=book&amp;amp;<br>
  rft.btitle=Harry+Potter+and+the+philosopher%27s+stone&amp;amp;rft.isbn=0747532745<br>
  &amp;amp;rft.aulast=Rowling&amp;amp;rft.auinit=J.+K.
  &amp;amp;rft.au=J.+K.+Rowling&amp;amp;rft.date=1997&amp;amp;rft.pub=Bloomsbury+Publishing<br>
  &amp;amp;rft.place=London&amp;amp;rft.tpages=223&amp;amp;<br>
  rft_id=http%3A%2F%2Fopenlibrary.org%2Fb%2FOL16948138M&quot;&gt;<br>
  <br>
  &lt;/span&gt;</p>
<p>The above is a COinS that is not visible on the rendered page. If desired, the COinS can be made visible with an image placed inside the <code>span</code> that shows on the page. 
</p>
title: Using COinS in Edition Pages