---
title: I4OC open citations implementation in Janeway
layout: post
image: 
    feature: oa.png
---
One of the strongly recommended criteria under Plan S is that journals provide "Openly accessible data on citations according to the standards by the Initiative for Open Citations (I4OC)". This means, essentially, depositing citation data with Crossref and then marking it as open.

This is a tricky task that will be outside of the ability of many smaller publishers. It requires citations to be marked up in a format that distinguishes them from other text. However, for anyone who is producing JATS XML, I have now implemented the ability to deposit citation data in our open-source platform, [Janeway](https://github.com/BirkbeckCTP/janeway).

#How does it work?

1. We generate a standard Crossref DOI template that will work for articles that have, or do not have, XML. Essentially, deposits without JATS XML are unaffected.
2. If there is a JATS XML galley attached as the render galley for an article, we perform an XSL transform that generates the necessary Crossref XML.
3. We deposit the XML with or without citation data.
4. We now also poll Crossref for in progress data on deposit success every 30 minutes if you have a Janeway cron task setup, so you can check on the status of DOIs.

#What JATS is supported?

Any element-citation or mixed-citation is supported.

For example:

<pre><ref id="B1"><label>1</label><mixed-citation publication-type="journal"><string-name><surname>Bishop</surname>, <given-names>S.</given-names></string-name>, <year>2018</year>. <article-title>&#8216;Anxiety, panic and self-optimization: Inequalities and the YouTube algorithm.&#8217;</article-title> <source>Convergence</source>, <volume>24</volume>(<issue>1</issue>): <fpage>69</fpage>&#8211;<lpage>84</lpage>. DOI: <pub-id pub-id-type="doi">10.1177/1354856517736978</pub-id></mixed-citation></ref></pre>

is translated into:
<pre>
	<citation key="keyref_B1">
		<journal_title>Convergence</journal_title>
		<doi>10.1177/1354856517736978</doi>
		<volume>24</volume>
		<issue>1</issue>
		<author>Bishop, S.</author>
		<first_page>69</first_page>
		<cYear>2018</cYear>
		<article_title>
		‘Anxiety, panic and self-optimization: Inequalities and the YouTube algorithm.’
		</article_title>
	</citation>
</pre>

This is then appended to the deposit. Items of an unrecognized type are simply passed through as unstructured citations. So, for instance, a web page might appear as:

<pre>
	<citation key="keyref_B5">
		<unstructured_citation>
			Chan, J., R. Farkas, A. Hirsch, and C. Kinsey, 2012. ‘Becoming Camwhore, Becoming Pizza.’ Mute, 8 November 2012. Available at: http://www.metamute.org/editorial/articles/becoming-camwhore-becoming-pizza [last accessed 26 July 2019].
		</unstructured_citation>
	</citation>
</pre>

Submit 'em all and let Crossref sort them out.

In this way, we hope to support those producing JATS in achieving the Plan S technical requirements. We have verified the deposit system against JATS in the