Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
dev:exposing_metadata:coins [2017/11/12 19:53]
127.0.0.1 external edit
dev:exposing_metadata:coins [2020/06/14 13:18] (current)
bwiernik
Line 1: Line 1:
-<​html><​p id="​zotero-5-update-warning"​ style="​color:​ red; font-weight:​ bold">​We’re +====== Using Zotero to create COinS metadata ======
-in the process of updating the documentation for +
-<a href="​https://​www.zotero.org/​blog/​zotero-5-0">​Zotero 5.0</​a>​. Some documentation +
-may be outdated in the meantime. Thanks for your understanding.</​p></​html>​ +
- +
- +
-====== Using Zotero to create COinS so you can embed metadata ​in your website ​======+
  
  
 ===== Introduction ===== ===== Introduction =====
  
-At times users wish to make references they have collated available to others when they visit their website or blogThis can be done by incorporating special codecalled ​COinS, in your webpageWhen COinS are detected by Zotero ​book, chapter, article or collection icon appears in the address bar of the browser. Just as normal, users can click on the icon to capture the reference data and place it in their reference library.+Although the [[http://​scholar.google.com/​intl/​en/​scholar/​inclusion.html|Google/​Highwire key-value system]] is generally preferred for embedding bibliographic metadata into a webpageanother possible format is COinS. ​Zotero can [[https://​www.zotero.org/​support/​adding_items_to_zotero#​via_your_web_browser|automatically import ​COinS metadata from website]].
  
-===== What are COinS? =====+COinS is an abbreviation for "​[[http://​ocoins.info/​|ContextObjects in Spans]]"​. Spans in this context refers to the html tag <​span></​span>​. Spans allow you to add the bibliographic metadata to your webpage without it being visible to people browsing the page.
  
-COinS is an abbreviation for "​[[http://​ocoins.info/​|ContextObjects in Spans]]"​. Spans in this context refers to the html tag <​span></​span>,​ and is the means by which your reference data can be inserted into a webpage without it being rendered as text (i.e. it is hidden). +The format of COinS is relatively simple, ​but creating them by hand is difficult because ​certain characters ​need to be converted ​to URL format. For examplespace character needs to be represented by '​%20'​.
- +
-Although the format of COinS is relatively simple, ​their creation ​is problematic as it is necessary to convert ​certain characters to URL format. For example a blank character ​or space needs to be represented by '​%20'​. This makes reading and editing COinS difficult, although not impossible, for website developers. +
- +
-===== How to create COinS ===== +
- +
-Zotero provides a simple means of creating COinS from the references in your library. +
- +
-First, you need to set your 'Quick Copy' preferences. This is done by opening your Zotero Preference dialog using the menu option - '​Actions > Preferences...'​ then selecting the '​Export'​ tag (#1) and changing the '​Default Output Format'​ to COinS (#2). Close the dialog to return to your library. +
- +
-{{ :​zotero_001.png?​317x327 }} +
- +
-Once you are back in your library select a reference or a collection of references and drag-and-drop them into a receptive application (e.g. text editor). The references are converted and inserted as a COinS object. +
- +
-For example, below I have selected three references from my main library (#1). Then using the mouse, clicked on the selection and without releasing the button dragged the selection (#2) to gEdit, a text editor used in Ubuntu. Alternatively you can use Ctrl-Shift-C (Windows/​Linux) or Cmd-Shift-C (Mac) to copy and Ctrl-V(Mac: Cmd-V to paste in a document. +
- +
-{{ :​zotero_002.png?​489x106 }} +
- +
-The resulting output in gEdit is shown below. You can see what I mean about being difficult to read. +
- +
----- +
-<span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Ajournal&​amp;​rft.genre=article&​amp;​rft.atitle=Thelymitra%20epipactoides%20F.%20Muell.%20(Orchidaceae)%3A%20The%20morphology%2C%20biology%20and%20conservation%20of%20an%20endangered%20species&​amp;​rft.jtitle=Proceedings%20of%20the%20Royal%20Society%20of%20Victoria&​amp;​rft.volume=101&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.au=D.%20M.%20Calder&​amp;​rft.au=D.%20Tonkinson&​amp;​rft.date=1989&​amp;​rft.pages=89-101&​amp;​rft.spage=89&​amp;​rft.epage=101'></​span>​ +
-<span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_id=urn%3Aisbn%3A0%207306%202243%206&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&​amp;​rft.genre=book&​amp;​rft.btitle=A%20census%20of%20Victorian%20bryophytes&​amp;​rft.place=East%20Melbourne&​amp;​rft.publisher=The%20Department%20of%20Conservation%20and%20Environment&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.au=D.%20A.%20Tonkinson&​amp;​rft.au=G.%20A.%20M.%20Scott&​amp;​rft.date=1991&​amp;​rft.tpages=56&​amp;​rft.isbn=0%207306%202243%206'></​span>​ +
-<span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_id=urn%3Aisbn%3A0%20643%2005533%209&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&​amp;​rft.genre=book&​amp;​rft.btitle=Management%20of%20endangered%20plants&​amp;​rft.place=East%20Melbourne&​amp;​rft.publisher=CSIRO%20Publishing&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.date=1993&​amp;​rft.tpages=182&​amp;​rft.isbn=0%20643%2005533%209'></​span>​ +
----- +
- +
-Here is a formatted version, with some syntax highlighting,​ that you can more easily review. Note however, even with syntax highlighting the title attribute is just one continuous text string.+
  
 +Example COinS code is shown below:
 <code html> <code html>
 <span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Ajournal&​amp;​rft.genre=article&​amp;​rft.atitle=Thelymitra%20epipactoides%20F.%20Muell.%20(Orchidaceae)%3A%20The%20morphology%2C%20biology%20and%20conservation%20of%20an%20endangered%20species&​amp;​rft.jtitle=Proceedings%20of%20the%20Royal%20Society%20of%20Victoria&​amp;​rft.volume=101&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.au=D.%20M.%20Calder&​amp;​rft.au=D.%20Tonkinson&​amp;​rft.date=1989&​amp;​rft.pages=89-101&​amp;​rft.spage=89&​amp;​rft.epage=101'></​span>​ <span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Ajournal&​amp;​rft.genre=article&​amp;​rft.atitle=Thelymitra%20epipactoides%20F.%20Muell.%20(Orchidaceae)%3A%20The%20morphology%2C%20biology%20and%20conservation%20of%20an%20endangered%20species&​amp;​rft.jtitle=Proceedings%20of%20the%20Royal%20Society%20of%20Victoria&​amp;​rft.volume=101&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.au=D.%20M.%20Calder&​amp;​rft.au=D.%20Tonkinson&​amp;​rft.date=1989&​amp;​rft.pages=89-101&​amp;​rft.spage=89&​amp;​rft.epage=101'></​span>​
Line 48: Line 17:
 </​code>​ </​code>​
  
-The references copied are shown below. The COinS for these references have been inserted ​in the html of this webpage and should appear as a collection ​in the address bar of your browser (see image below and your browser'​s address bar).+Zotero can automatically create ​COinS from items in your library. Select ​the items in Zotero, right click, and choose "​Export Items…"​. Then choose COinS from the dropdown menu. Open the exported file to see the COinS metadata. Copy and paste this code into your web page editor.
  
 +You can also set Zotero to use COinS as your default "Quick Copy" export format. Open the [[preferences:​export|Export]] pane of Zotero preferences and select "​COinS"​ as the Default Format. Then, you can drag and drop items from your library to your web page editor to insert COinS code. You can also copy COinS to your clipboad by pressing Ctrl/​Cmd-Shift-C.
  
-{{:​dev:​exposing_metadata:​zotero_003.png|}} 
- 
- 
-Cropper, S.C., Calder, D.M. & Tonkinson, D. (1989) Thelymitra epipactoides F. Muell. (Orchidaceae):​ The morphology, biology and conservation of an endangered species. Proceedings of the Royal Society of Victoria 101: 89-101. 
- 
-Cropper, S.C., Tonkinson, D.A. & Scott, G.A.M. (1991) “A census of Victorian bryophytes” (The Department of Conservation and Environment;​ East Melbourne). 
- 
-Cropper, S.C. (1993) “Management of endangered plants” (CSIRO Publishing; East Melbourne). 
- 
- 
-<​html>​ 
-<span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Ajournal&​amp;​rft.genre=article&​amp;​rft.atitle=Thelymitra%20epipactoides%20F.%20Muell.%20(Orchidaceae)%3A%20The%20morphology%2C%20biology%20and%20conservation%20of%20an%20endangered%20species&​amp;​rft.jtitle=Proceedings%20of%20the%20Royal%20Society%20of%20Victoria&​amp;​rft.volume=101&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.au=D.%20M.%20Calder&​amp;​rft.au=D.%20Tonkinson&​amp;​rft.date=1989&​amp;​rft.pages=89-101&​amp;​rft.spage=89&​amp;​rft.epage=101'></​span>​ 
-<span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_id=urn%3Aisbn%3A0%207306%202243%206&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&​amp;​rft.genre=book&​amp;​rft.btitle=A%20census%20of%20Victorian%20bryophytes&​amp;​rft.place=East%20Melbourne&​amp;​rft.publisher=The%20Department%20of%20Conservation%20and%20Environment&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.au=D.%20A.%20Tonkinson&​amp;​rft.au=G.%20A.%20M.%20Scott&​amp;​rft.date=1991&​amp;​rft.tpages=56&​amp;​rft.isbn=0%207306%202243%206'></​span>​ 
-<span class='​Z3988'​ title='​url_ver=Z39.88-2004&​amp;​ctx_ver=Z39.88-2004&​amp;​rfr_id=info%3Asid%2Fzotero.org%3A2&​amp;​rft_id=urn%3Aisbn%3A0%20643%2005533%209&​amp;​rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&​amp;​rft.genre=book&​amp;​rft.btitle=Management%20of%20endangered%20plants&​amp;​rft.place=East%20Melbourne&​amp;​rft.publisher=CSIRO%20Publishing&​amp;​rft.aufirst=S.%20C.&​amp;​rft.aulast=Cropper&​amp;​rft.au=S.%20C.%20Cropper&​amp;​rft.date=1993&​amp;​rft.tpages=182&​amp;​rft.isbn=0%20643%2005533%209'></​span>​ 
-</​html>​ 
  
 {{tag>​kb}} {{tag>​kb}}
dev/exposing_metadata/coins.1510534411.txt.gz · Last modified: 2020/06/14 13:18 (external edit)