This is an old revision of the document!
Exposing Your Metadata
Whether you are a publisher of a scientific journal, operate a news site, or are a blogger, Zotero users will be eternally grateful if you expose bibliographic metadata on your website.
In your decision to expose metadata, it is important to identify the object of interest: this can be the webpage itself (e.g. a page on a newspaper's website showing a article), or the resources described on the webpage (e.g. a page of a library catalog showing bibliographic records).
Zotero-Ready Web Applications
The easiest way to expose bibliographic metadata is to use a web application that comes with this feature, or offers it through a plugin or minimal configuration. Examples are the content management systems WordPress (together with a WordPress metadata plugin) and Omeka, and the web-based bibliographic managers refbase and Bebop BibTeX publisher.
Zotero-compatible OPAC (Online Public Access Catalog) software packages for libraries, archives, and museums include:
- Voyager (WebVoyage)
These OPACs are used by tens of thousands of libraries around the world; SIRSI alone is used by almost 7000 libraries. If you are using one of these and Zotero doesn't work with the library's catalog interface, post to the Zotero forums to see what changes can be made to make Zotero work with the OPAC installation.
Using an Open Standard for Exposing Metadata
Alternatively you can directly edit your HTML code of your webpage, using one of the following open standards, to expose your metadata:
- Embedded Metadata The <META> tags in the header of many webpages will be parsed and used by Zotero. This fairly standard embedding of RDF metadata can use any RDF vocabularies; Zotero supports most major RDF vocabularies used for bibliographic metadata. For details on this approach, see the Dublin Core description. The translator will also interpret metadata expressed in the Google/Highwire key-value system.
- COinS The COinS website defines COinS (ContextObjects in Spans) as “a simple, ad hoc community specification for publishing OpenURL references in HTML.” Although somewhat limited in the number of metadata categories, using COinS is a relatively easy and lightweight option for embedding reference metadata into a webpage or blog.
- Individual COinS can be manually generated using the COinS Generator and inserted into your webpage or blog;
- Alternatively, Zotero can be used to create COinS from references in your library, and these can dragged-and-dropped into your website or blog;
- Note also, that when you right-click a selection of references in your Zotero library and choose 'Create bibliography from Selected Items', choose the 'Citation Style', check 'Save as HTML' then click on 'OK', that the webpage created contains COinS, which theoretically can be extracted or that page directly linked to from you website or blog.
- unAPI. As described on the unAPI website, “unAPI is a tiny HTTP API for the few basic operations necessary to copy discrete, identified content from any kind of web application.” For our purposes, unAPI allows you to serve up bibliographic information in a variety of different bibliographic formats for Zotero to automatically ingest. If you use unAPI, you can use one of the following standard and documented file formats:
- MODS XML. Developed by the Library of Congress, MODS XML is one of the richest standard formats available.
- MARC. An older, flat format, MARC is only recommended if your application can already generate it.
- Bibliontology/Dublin-Core-like/Zotero RDF. Bibliontology RDF can store any information that Zotero can save. Dublin Core is standardized and extremely common, but is limited in its expressive abilities. The legacy Zotero RDF format is also supported.
- Note that the unAPI website appears to be no longer maintained, but sites built using the unAPI specification will still work with Zotero. See here for a discussion.
Force Zotero to refresh metadata
Websites for which metadata changes without a page reload should fire a ZoteroItemUpdated event to tell Zotero to re-detect metadata on the page. This is supported in Zotero 3.0 and later.
var ev = document.createEvent('HTMLEvents'); ev.initEvent('ZoteroItemUpdated', true, true); document.dispatchEvent(ev);
Zotero Web Translators
Exposing bibliographic metadata through an open standard is very powerful (and also benefits non-Zotero users!). However, if you have little control over the way your website is built, you may have to create a Zotero web translator for Zotero-compatibility. Translators have some downsides: apart from the fact that they are a Zotero-specific solution, translators can break easily if the structure of the targeted website changes.