<contrib-group>

Contributor Group

Container element for one or more contributors and information about those contributors.

Remarks

Use of Contributor Group: Inside the element <article-meta>, the <contrib-group> element holds individual contributors to a document such as authors, researchers, or photographers. Inside the element <journal-meta>, the <contrib-group> element holds contributors to the whole journal or at least above the level of an article, such as section editors, journal editors, or special issue editors.
Contributor groups may name primary authors, editors, sponsors, translators, illustrators, etc. The members of the group are contributors who worked individually, not as a group. The @content-type attribute should be used to name the type of contributor in the group, “authors”, “editors”, “translators”, etc.
If issue contributors (as opposed to contributors to a particular article), are part of the metadata for an article, they should be listed in a separate <contrib-group> with a @content-type attribute value such as “issue-editors”, typically inside the <journal-meta>.
Naming the Role of Contributors: The @content-type attribute on <contrib-group> was designed to name the role of the contributors in the group and was also designed to accept any text as its value. However, if the @content-type value is to be taken from a controlled vocabulary, such as CRediT, Best Practice is not to name the role using @content-type. Best Practice (when possible) is to tag the CRediT contributor role taxonomy terms by using the <role> element inside the <contrib-group> or inside individual contributors (<contrib>). 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 or group to play more than one role in the creation of an article.

Related Elements

The element <contrib-group> is a metadata element. The <person-group> element performs a similar function of grouping individual contributors, such as authors and editors, within a bibliographic reference (<element-citation> or <mixed-citation>).
The <contrib-group> should not be confused with the element <collab>, in which individuals are not named as contributors because the contribution was made by the group as a whole, for example, a report which has a laboratory or department as the official author.

Attributes

content-type Type of Content
id Document Internal Identifier
specific-use Specific Use
xml:base Base

Content Model

<!ELEMENT  contrib-group
                        %contrib-group-model;                        >

Expanded Content Model

(contrib | address | aff | aff-alternatives | author-comment | bio | email | etal | ext-link | fn | on-behalf-of | role | uri | xref | x)+

Description

One or more of any of:

This element may be contained in:

<article-meta>, <collab>, <front-stub>, <journal-meta>, <sec-meta>, <supplement>

Example 1

A <contrib-group> element with a single author:
...
<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 2

A <contrib-group> element with a single author and his affiliation:
...
<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 3

A <contrib-group> element with a single editor:
...  
<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 4

A <contrib-group> element with several authors:
...
<contrib-group>
<contrib contrib-type="author">
<name><surname>Forster</surname>
<given-names>Anne Williams</given-names></name>
<role>research physiotherapist</role>
<xref ref-type="aff" rid="StLukes"/>
<xref ref-type="aff" rid="RoyalInf"/>
</contrib>
<contrib contrib-type="author">
<name><surname>Young</surname>
<given-names>John G.</given-names></name>
<role>consultant physician</role>
<xref ref-type="aff" rid="RoyalInf"/>
</contrib>
<aff id="StLukes">Department of Health Care for the
Elderly, St Luke&#x2019;s Hospital, Bradford BD5 0NA</aff>
<aff id="RoyalInf">Academic Section of Geriatric
Medicine, Royal Infirmary, Glasgow G4 0SF</aff>
</contrib-group>
...

Example 5

Three contributors with alternative names:
...
<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>
...

Journal Archiving and Interchange Tag Library NISO JATS Version 1.2 (ANSI/NISO Z39.96-2019)

Version of May 2019

Back to Top