Include DOIs in lessons

[mdlincoln]

Once we have established a DOI registration workflow #1683 we need to edit the Jekyll layouts to have a field for DOI in the YAML header and to display the DOI on the lesson page & citation.

[mdlincoln]

The first part of this work is to produce crossref XML files for each fo the journals. I've started that branch now.

One question for @programminghistorian/spanish-team @programminghistorian/english-team @programminghistorian/french-team : crossref allows us to set the following contributor roles:

<xsd:attribute name="contributor_role" use="required">
  <xsd:simpleType>
    <xsd:restriction base="xsd:NMTOKEN">
      <xsd:enumeration value="author"/>
      <xsd:enumeration value="editor"/>
      <xsd:enumeration value="chair"/>
      <xsd:enumeration value="reviewer"/>
      <xsd:enumeration value="review-assistant"/>
      <xsd:enumeration value="stats-reviewer"/>
      <xsd:enumeration value="reviewer-external"/>
      <xsd:enumeration value="reader"/>
      <xsd:enumeration value="translator"/>
    </xsd:restriction>
  </xsd:simpleType>
</xsd:attribute>

I trust it's acceptable that both the original reviewers as well as the translation reviewers both get the role reviewer, and the editor and translation editors both get the role editor?

[arojascastro]

yup!

(such a beautiful piece of xml :)

[mdlincoln]

I've submitted a first draft of the XML back to Sussex along with a few technical questions for their review.

[drjwbaker]

Woo! Great job @mdlincoln. Feels like we are making real progress.

[mariajoafana]

Have you heard from them @mdlincoln ?

[mdlincoln]

on May 3 2020:

Hi Matthew,
Annette is chasing up with Crossref as we are still waiting for the new DOI range. Once received we will first need to create DOIs for the journals followed by a test run before adding DOIs to the 3 journal article xml files... will keep you posted

Best,
Tim

[drjwbaker]

To add, with no slight on my colleagues at Sussex, I don't expect this will come together super quick. They have a lot on, I suspect this isn't top priority, and CrossREF is a large infrastructure that - we can assume - is working below capacity right now.

[mdlincoln]

We've gotten reserved DOIs back from Sussex (they're reserved but not yet active). I'm going to add them into our lesson files and set the doi to display with the citation info.

Will update once we hear back on whether CrossRef happily accepted our data

[mdlincoln]

🎺

Our DOIs are now live!

They're listed in the suggested citation section of lessons at the bottom of e.g. https://programminghistorian.org/en/lessons/working-with-batches-of-pdf-files

And you'll see that DOI now resolves back to PH! We'll be double checking the linked metadata as it propagates out from crossref, but the back catalog should be uploaded now.

I'll follow up with Sussex for our first "new lesson" DOI for #1769 workflow tomorrow once they're awake.

[jenniferisasi]

Sorry to be informal but this deserves this gif right here:

[arojascastro]

Thank you @mdlincoln and great job!