Certificate page as part of the register

[nuest]

This is then base for an "overlay journal" kind of website, see codecheckers/discussion#29.

New pages needed:

https://codecheck.org.uk/certificate/2020-001 or https://codecheck.org.uk/register/2020-001 or https://cdchck.org/cert/2020-001

• have multi-page JPG or a GIF as preview of the certificate
  • see https://eddelbuettel.github.io/rticles-gallery/ (code at https://github.com/eddelbuettel/rticles-gallery/blob/master/script.R#L60 using convert)
• get the paper abstract via some nice API - Crosscite?
  • https://github.com/ropensci/rcrossref/blob/master/R/cr_abstract.R
  • https://github.com/CrossRef/rest-api-doc/issues/98
• get the full citation from DOI
  • https://github.com/ropensci/rcrossref/blob/master/R/cr_cn.r
• include semantic metadata in the HTML head, cf. https://schema.org/ and how OJS embed Dublin Core metadata
• page has a preview image/rendering
  • https://developer.twitter.com/en/docs/twitter-for-websites/cards/guides/getting-started
  • https://github.blog/2013-01-24-github-now-supports-twitter-cards/

Would probably also solve codecheckers/register#23.

Layout

Somewhere between ReScience C and JOSS:

[nuest]

Should this URL also be used for the link behind the badge? The DOI is certainly more sustainable.

[angelina-momin]

@nuest can you specify how you want to display the multi-page JPEG? The idea I had was having buttons to navigate through the different jpeg images of the certificate. This is the html I created so far. Can you let me know what you and @sje30 think?

Additionally could you specify the following:

• Are you okay with the current placement of the multi-page jpg as I showed
• Where in the page would you like the paper abstract to be displayed? On the right maybe?
• Where in the page would you like the full citation to be displayed?

[sje30]

this looks very cool.

Couple of points in my mind:

1. Going forward, if we switch to having our codecheck package use quarto templates to generate both html and pdf versions of certs, would that be helpful to this process (or make it redundant). I'm wary that our codecheck.Rmd approach works but is very clunky and would like to do something a bit nicer / cross-platform.
2. is it easy to always get the abstract of the underlying paper? If not, I'd suggest not prioritising work on where the abstract goes (it looks nice where it is).

[nuest]

Thanks for the nice mockups!

Re. placement: Looks fine! I think we could, below the abstract, also show the codecheck summary, which we have in the codecheck.yml file. That would give us some nice indexing in search engines, I hope.

Re. full citation: I would put that at the top, because it also takes care of showing the certificate authors. Not sure if #82 would be overkill now or actually easier than coming up with a full citation ourselves.

[nuest]

One more thing re. Stephens comment on switching to Quarto: In that case it might be good now to integrate the preview based on an HTML file that is stored somewhere. For now, the HTML will just show the first page of the PDF as a preview, and later we can simply store the Quarto output in the HTML file (I generously use the term "simple" here ;-) ).

[nuest]

Zenodo has a rate limit, see https://developers.zenodo.org/#update-schedule

Therefor, let's limit our requests to Zenodo to one per second.