<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>

Related Elements

Use the <collab> element for contributions by organizations or groups of people. Use the <on-behalf-of> element within the contributor information to indicate that a person has written as a representative of (on behalf of) an organization or group.

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

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 &#8212; 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 &#8212; Original Draft"
vocab-term-identifier="http://dictionary.casrai.org/Contributor_Roles/Writing_%E2%80%93_original_draft" 
degree-contribution="lead">Writing &ndash; 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&#x2019;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">&ast;&ast;</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>
...