how to annotate persons
myrmoteras opened this issue · 8 comments
@tcatapano here is the annoation of a person aka contributor in https://zookeys.pensoft.net/article/81125/download/xml/
Can you pleas check the use of ORCID. This seems to be yet another way to annotate a persistent identifier (see other cases in #56
<contrib contrib-type="author" corresp="no"> <name name-style="western"> <surname>Liu</surname> <given-names>Yuxin</given-names> </name> <uri content-type="orcid">https://orcid.org/0000-0002-0241-1036</uri> <xref ref-type="aff" rid="A1">1</xref> </contrib>
This seems to me not correct?!
<contrib-id> should be used. See https://jats.nlm.nih.gov/publishing/tag-library/1.3/element/contrib-id.html
The element holds an external identifier, typically assigned to a person by an agency such as the publisher, ORCID, or other personal identification authority. The contents of this element should not be confused with the @id attribute, which holds an internal document identifier that can be used by software to perform a simple link inside the XML document.
Type of Identifier Best Practice
Best Practice is to use the @contrib-id-type attribute to indicate the type of the external identifier, such as a publisher’s identifier, an ORCID, a SCOPUS identifier, or similar. (See @contrib-id-type for values.)
so
<contrib contrib-type="author" corresp="no">
<name name-style="western"> <surname>Liu</surname> <given-names>Yuxin</given-names> </name>
<contrib-id contrib-id-type="orcid">https://orcid.org/0000-0002-0241-1036</contrib-id>
<xref ref-type="aff" rid="A1">1</xref> </contrib>
@myrmoteras @tcatapano
Yes, this is because the provided example using jats 3.0 (which is used with the current release of taxpub), where the element does not exist. In this case, as work around the orcid is included using element
Probably is good to decide what version of JATS and taxpub all examples should follow, and to state in the article that all recommendations/examples are based on JATS xx (released date), TaxPub yy (coming soon). What do you think?
@teodorgeorgiev I think this is an important additional piece of the puzzle to add to the text. @tcatapano can please add it here and I then add it to the ms.
@tcatapano
is this also correct to annotate a collector in a material citation
(see ID ms page 31)
<contrib contrib-type="author">
<name name-style="western"> <surname>Sharaf</surname> <given-names>M. R.</given-names> </name>
<contrib-id contrib-id-type="orcid">https://orcid.org/0000-0001-8137-0705</contrib-id>
</contrib>
or should this be
<string-name>Sharaf, M.R.</string-name>
or like this example on p 31
<named-content content-type="dwc:recordedBy">Liu Yu-Wei</named-content>
there is also the more general issue, how to annotate persons in the body of an article. row 35 in the table
See https://jats.nlm.nih.gov/publishing/tag-library/1.3/chapter/tag-names.html#pub-tag-names
Basically, names as part of metadata or references have very specific and granular options
Elsewhere, as for instance material-citations, use <named-content> with a string in the content-type attribute describing the type of name