peerj / jats-conversion Goto Github PK

Currently hard-coded to "1.0".

Need to decide which tag to use for the version number in the JATS article XML.

Convert to <aside> in HTML

Replace <div class="table-wrap"> with <figure class="table-wrap">.

http://www.w3.org/TR/html5/common-idioms.html#footnotes

Currently

<preformat preformat-type="code">…</preformat>

will be converted to

<pre><code>…</code></pre>

To specify the language, e.g. for code highlighting, the output should contain a class="language-* attribute on the code element, e.g. <code class="language-python">.

I receive two errors with the NLM style checker that I don't understand:

• <ext-link ext-link-type="doi"> validates only if DOI is not given as URL (i.e. with http://dx.doi.org prefix). This is conflicting with the CrossRef DOI display guidelines.
• Publication dates in a <date> element in <element-citation> raise a warning: date check: date inside history should have date-type attribute with value from [accepted received rev-request rev-recd ], not [].

Both errors are probably not directly related to your tool, but I wanted to check here first (especially feedback regarding the first item).

The CrossRef schema only allows a certain number of characters in the edition_number field, and it must be a number.

The edition element may contain text like "Deuxieme edition", etc.

The designator attribute allows the edition number to be preserved when putting text in the edition element.

e.g. <media mimetype="video" mime-subtype="mp4" xlink:href="filename.mp4> should be embedded as a "Download video" link, and converted to a video player with JS if the browser supports this format.

e.g.

  <person-group person-group-type="director">
    <name>
      <surname>Wachowski</surname>
      <given-names>A</given-names>
    </name>
    <name>
      <surname>Wachowski</surname>
      <given-names>L</given-names>
    </name>
  </person-group>

Render in ul.
Use list-style-type:none and display: table.
Use display: table-row for li.
Inside each list item, add a div for the label (if there is one), and a div for the content, each with display: table-cell.

The DOAJ schema only allows one email address per author.

If the contrib element has a xlink:href attribute, use that as the URL.

Shouldn't the README say:

• Run tests/validate.sh filename to validate a JATS XML file.

e.g. testsinstead of scripts?

http://jats.nlm.nih.gov/1.1d1/

Can apply to a single author (inside <contrib>), or to all authors (inside <contrib-group>).

e.g. <uri>http://www.r-project.org</uri>

This field is used when building the citation string, so should contain the name of the publication rather than the publishing company.

Example markup:

<element-citation publication-type="software">
  <person-group person-group-type="author">
    <name>
      <surname>Goddard</surname>
      <given-names>TD</given-names>
    </name>
    <name>
      <surname>Kneller</surname>
      <given-names>DG</given-names>
    </name>
  </person-group>
  <source>SPARKY 3</source>
  <edition>v3.114, Windows</edition>
  <year iso-8601-date="2007">2007</year>
  <publisher-loc>San Francisco</publisher-loc>
  <publisher-name>University of California</publisher-name>
  <comment>Available from: <uri>http://www.cgl.ucsf.edu/home/sparky/</uri></comment>
</element-citation>

alpha-upper
simple
labelled

e.g. a "further reading" list

Rather than including all reference lists when submitting citations to CrossRef, assume that the first ref-list is the list of cited articles and that any others are supplementary and should not be submitted.

It may be possible to specifically include/exclude ref-list elements based on content-type attribute, if needed.

Example:

<edition>2nd Edition</edition>
<part-title>Tome 5, Part 2</part-title>

Currently the output is <span class="p"></span>.

Instead of article > .body > main > section, just have article > section.

Need to assess whether scripts need some indicator of the body of the article.

To allow browsers to choose the most appropriate figure image file to download, add the srcset attribute to specify image file sizes and the sizes attribute to specify rendered image sizes at different screen widths.

back/glossary/def-list

The title and id will be moved from the def-list to the glossary element.

e.g. for <element-citation publication-type="software">, when <source> and <uri> are present, without <article-title> or <comment>:

<element-citation publication-type="software">
  <person-group person-group-type="author">
    <name><surname>Pinheiro</surname><given-names>J</given-names></name>
    <name><surname>Bates</surname><given-names>D</given-names></name>
    <name><surname>DebRoy</surname><given-names>S</given-names></name>
    <name><surname>Sarkar</surname><given-names>D</given-names></name>
    <collab>R Core Team</collab>
  </person-group>
  <source>nlme: linear and nonlinear mixed effects models</source>
  <edition designator="3.1-121">R package version 3.1-121</edition>
  <uri>http://cran.r-project.org/package=nlme</uri>
  <year>2015</year>
</element-citation>

http://scholar.google.com/scholar_lookup
title
author
year