<contrib>
Contributor
Container element for information about a single author, editor, or other contributor.
Remarks
Types of Contributors: The element <contrib> can be used for many roles besides authors, for example, editors, special issue editors, photographers, illustrators, directors, etc. The @contrib-type attribute placed on the <contrib> element, or the <role> element used within the <contrib> element, may be used to describe the contribution.
Role Best Practice: The @contrib-type attribute placed on the <contrib> element, or the <role> element used within the <contrib> element, may be used to describe the type of contribution made by an individual.
Although the @contrib-type attribute was designed to name the role of the contributor and was also designed to accept any text as its value, the <role> element is preferred. When the @contrib-type value is to be taken from a controlled vocabulary, such as CRediT, Best Practice is not to name the role using @contrib-type. Best Practice (when possible) is to tag the CRediT contributor role taxonomy terms by using the <role> element inside <contrib> or <contrib-group>. The major advantages of using the <role> element are the ability to tie the content of the role to the formal vocabulary using the four JATS vocabulary attributes and the ability for a contributor to play more than one role in the creation of an article.
Linking Best Practice: Use <xref> to point to the institution (<aff>), the corresponding information (<corresp>), or any author footnotes in the author note group.
Anonymous: The name of a contributor that is being withheld or is not known may be recorded using the EMPTY element <anonymous>, which is expected to cause text such an “Anonymous” or “anon.” to be generated for display or print.
Elsevier Conversion Note: For users of the Elsevier Tag Sets, when the ranking or importance of authors has been marked as a note (for example, using <ranking>), the ranking information may be encoded in the <role> element. Thus, the Elsevier-tagged text:
<ranking><sup>*</sup></ranking>
would be converted to:
<role><sup>*</sup></role>
Attributes
Content Model
<!ELEMENT contrib %contrib-model; >
Expanded Content Model
((contrib-id)*, (anonymous | collab | collab-alternatives | name | name-alternatives | string-name)*, (degrees)*, (address | aff | aff-alternatives | author-comment | bio | email | ext-link | on-behalf-of | role | uri | xref)*)
Description
The following, in order:
- <contrib-id> Contributor Identifier, zero or more
- Any combination of:
- <degrees> Degree(s), zero or more
- Any combination of:
This element may be contained in:
Example 1
Each contributor names the affiliation inside the <contrib-group> element:
...
<contrib-group>
<contrib contrib-type="author">
<name name-style="western">
<surname>McCrohan</surname>
<given-names>John</given-names>
<prefix>Capt.</prefix>
</name>
</contrib>
<aff>Center for Devices and Radiological Health, Food and
Drug Administration, Rockville, Maryland 20857</aff>
</contrib-group>
...
...
<contrib-group>
<contrib contrib-type="author">
<name name-style="western">
<surname>Nüsslin</surname>
<given-names>Fridtjof</given-names>
<prefix>Dr.</prefix>
</name>
</contrib>
<aff>Klinik für Strahlentherapie und Radiologische Onkologie,
<institution>Technische Universität München</institution>,
Munich, Germany (Tel: 49-89-41404517, E-mail:
<ext-link ext-link-type="email" xlink:href="mailto:nuesslin@lrz.tum.de">
nuesslin@lrz.tum.de</ext-link>)</aff>
</contrib-group>
...
Example 2
Contributors with assigned roles using CRediT taxonomy terms:
... <contrib-group> <contrib> <string-name><given-names>Barbara</given-names> <surname>Johnston</surname></string-name> <role vocab="CRediT" vocab-identifier="http://dictionary.casrai.org/Contributor_Roles" vocab-term="Conceptualization" vocab-term-identifier="http://dictionary.casrai.org/Contributor_Roles/Conceptualization" degree-contribution="lead">study designer</role> </contrib> <contrib> <string-name><given-names>Brooke</given-names> <surname>Jackson</surname></string-name> <role vocab="CRediT" vocab-identifier="http://dictionary.casrai.org/Contributor_Roles" vocab-term="Writing — Original Draft" vocab-term-identifier="http://dictionary.casrai.org/Contributor_Roles/Writing_%E2%80%93_original_draft" degree-contribution="lead">writer</role> </contrib> </contrib-group> ...
Example 3
Special characters in CRediT attribute values need to be given as Unicode character references. In narrative text, Unicode character references, general entities, or characters may be used.
...
<contrib-group>
<contrib>
<string-name><given-names>Anne</given-names> <surname>Berns</surname></string-name>
<role vocab="CRediT"
vocab-identifier="http://dictionary.casrai.org/Contributor_Roles"
vocab-term="Writing — Original Draft"
vocab-term-identifier="http://dictionary.casrai.org/Contributor_Roles/Writing_%E2%80%93_original_draft"
degree-contribution="lead">Writing – Original Draft</role>
</contrib>
</contrib-group>
...
Example 4
A single contributor with a non-CRediT role:
...
<contrib-group>
<contrib contrib-type="author">
<name name-style="western">
<surname>Foster</surname>
<given-names>Bill</given-names>
<prefix>Rep.</prefix>
</name>
<role>(IL-14)</role>
</contrib>
</contrib-group>
...
Example 5
A collaboration as a contributor:
...
<article-meta>
...
<contrib-group>
<contrib contrib-type="author">
<collab collab-type="committee">Accredited Standards Committee S3,
Bioacoustics</collab>
</contrib>
</contrib-group>
...
<fpage seq="1">1</fpage>
<lpage>44</lpage>
<supplementary-material mime-subtype="zip" mimetype="application"
xlink:href="ASASTD.ANSI.ASA.S3.50.supplementary-material.zip"/>
...
</article-meta>
...
...
<article-meta>
...
<contrib-group>
<contrib contrib-type="author">
<collab collab-type="committee">Technical Committee ISO/TC 108,
Subcommittee SC 2</collab>
</contrib>
</contrib-group>
...
<fpage seq="1">1</fpage>
<lpage>23</lpage>
<history>
<date date-type="approved" iso-8601-date="2012-06-01">
<day>01</day>
<month>06</month>
<year>2012</year>
</date>
</history>
...
</article-meta>
...
Example 6
Issue editors as <contrib>s:
... <contrib-group> <contrib contrib-type="issue-editor"> <name><surname>Madison</surname> <given-names>Taylor</given-names></name> <role>Special Issue Editor</role> </contrib> <contrib contrib-type="issue-editor"> <name><surname>McKinley</surname> <given-names>Grant</given-names></name> <role>Special Issue Editor</role> </contrib> </contrib-group> ...
Example 7
A conference editor as a <contrib>:
...
<contrib-group content-type="conference-editors">
<contrib contrib-type="editor">
<name name-style="western">
<surname>Herrera</surname>
<given-names>Gerardo</given-names>
</name>
<role>Conference Editor</role>
</contrib>
</contrib-group>
...
Example 8
An author writing on behalf of a group:
...
<article-meta>
...
<contrib-group>
<contrib contrib-type="author">
<name><surname>Forster</surname>
<given-names>Anne</given-names></name>
<on-behalf-of>for the Multiple Sclerosis Collaborative
Research Group</on-behalf-of>
<role>research physiotherapist</role>
<xref ref-type="aff" rid="StLukes">
<sup><italic>a</italic></sup></xref>
</contrib>
</contrib-group>
<aff id="StLukes">
<sup><italic>a</italic></sup>Department of Health
Care for the Elderly, St Luke’s Hospital,
Bradford BD5 0NA</aff>
...
</article-meta>
...
Example 9
The name of a contributor given in several script/language combinations, with associated affiliations:
...
<article-meta>
<title-group>...</title-group>
<contrib-group>
<contrib contrib-type="author">
<name-alternatives>
<name name-style="eastern" xml:lang="ja-Jpan">
<surname>中西</surname>
<given-names>秀彦</given-names>
</name>
<name name-style="western" xml:lang="en">
<surname>Nakanishi</surname>
<given-names>Hidehiko</given-names>
</name>
<name name-style="eastern" xml:lang="ja-Kana">
<surname>ナカニシ</surname>
<given-names>ヒデヒコ</given-names>
</name>
</name-alternatives>
<xref ref-type="aff" rid="aff2">**</xref>
</contrib>
<aff-alternatives id="aff2">
<aff>
<institution xml:lang="ja-Jpan">国立言語学博物館</institution>
</aff>
<aff>
<institution xml:lang="en">National Museum of Linguistics</institution>
</aff>
</aff-alternatives>
</contrib-group>
...
</article-meta>
...
... <article-meta> ... <contrib-group> <contrib contrib-type="author"> <name-alternatives> <name name-style="western"><surname>Zhang</surname> <given-names>Y. P.</given-names></name> <string-name name-style="eastern" xml:lang="zh">张轶泼</string-name> </name-alternatives> <xref ref-type="aff" rid="a1">1</xref> <xref ref-type="author-notes" rid="n1">a)</xref> </contrib> <contrib contrib-type="author"> <name-alternatives> <name name-style="western"><surname>Isobe</surname> <given-names>M.</given-names></name> <string-name name-style="eastern" xml:lang="zh">磯部光孝</string-name> </name-alternatives> <xref ref-type="aff" rid="a2">2</xref> </contrib> <contrib contrib-type="author"> <name-alternatives> <name name-style="western"><surname>Liu</surname> <given-names>Yi</given-names></name> <string-name name-style="eastern" xml:lang="zh">刘仪</string-name> </name-alternatives> <xref ref-type="aff" rid="a1">1</xref> </contrib> </contrib-group> <aff id="a1">...</aff> <aff id="a2">...</aff> <author-notes id="n1">...</author-notes> ... </article-meta> ...
Example 10
A <contrib> with an <author-comment> because there is no affiliation:
...
<contrib contrib-type="author">
<name>
<surname>Crutchley</surname>
<given-names>Alison Claire</given-names>
</name>
<author-comment>
<p>Independent scholar</p>
</author-comment>
</contrib>
...