Article Authoring Tag Library NISO JATS Draft Version 1.1d2

<role>

Role or Function Title of Contributor

Title or role of a contributor to a work (for example, editor-in-chief, chief scientist, photographer, research associate).

Remarks

Information on the role or type of contribution is collected in two places, in the @contrib-type attribute on the <contrib> element and in the <role> element (which is part of the contributor information inside a <contrib> element). For example, the <contrib> element’s @contrib-type attribute might have a value of “editor”, whereas the content of the <role> element could be “Associate Editor”. As another example, the <contrib> element’s @contrib-type attribute might be “author”, and the <role> element might contain “Principal Author”.
The <role> element is more likely to appear on screen or in print than the <contrib> element’s @contrib-type attribute value.
This element joins the related element <on-behalf-of> in describing the contribution of a contributor. The <role> element will say that a person is an “Editor” or “Associate Editor”, and the <on-behalf-of> element will state that this editing was undertaken as a representative of a group or organization: 
<on-behalf-of>for the Multiple Sclerosis Collaborative Research Group</on-behalf-of>
While not considered best practice, it is also acceptable to tag the example as: 
<contrib>
    <name>
      <surname>Campion</surname>
      <given-names>M</given-names>
    </name>
    <role>for the Multiple Sclerosis Collaborative Research Group</role>
  </contrib>

Related Elements

See discussion about <on-behalf-of> in Remarks.

Attributes

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

Content Model

<!ELEMENT  role         (#PCDATA %role-elements;)*                   >

Expanded Content Model

(#PCDATA)*

Description

Text, numbers, or special characters, zero or more

This element may be contained in:

<collab>, <contrib>, <element-citation>, <mixed-citation>, <person-group>, <product>, <related-article>, <related-object>

Example 1

As part of contributor information:

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



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

Shown in a contributor group in context:
...
<article-meta>
<title-group>
<article-title>Systematic review of day hospital
care for elderly people</article-title>
</title-group>
<contrib-group>
<contrib contrib-type="author">
<name><surname>Forster</surname>
<given-names>Anne Williams</given-names></name>
<role>research physiotherapist</role>
<aff>Department of Health Care for the Elderly, 
St Luke&#x2019;s Hospital, Bradford BD5 0NA</aff>
</contrib>
<contrib contrib-type="author">
<name><surname>Young</surname>
<given-names>John</given-names></name>
<role>consultant physician</role>
<aff>Department of Health Care for the Elderly, 
St Luke&#x2019;s Hospital, Bradford BD5 0NA</aff>
</contrib>
<contrib contrib-type="author">
<name><surname>Langhorne</surname>
<given-names>Peter</given-names></name>
<role>senior lecturer</role>
<aff>Academic Section of Geriatric Medicine, Royal 
Infirmary, Glasgow G4 0SF</aff>
<author-comment>
<p>on behalf of the Day Hospital Group</p>
</author-comment>
</contrib>
</contrib-group>
...
</article-meta>
...

Example 3

In an element-style bibliographic reference (punctuation and spacing removed): 
...
<element-citation>
<person-group person-group-type="director">
<name><surname>Johnson</surname>
<given-names>D. H.</given-names></name>
<name><surname>O&rsquo;Neil</surname>
<given-names>T. A.</given-names></name>
</person-group>
<role>managing directors</role>
<source>Wildlife habitat relationships in Oregon
and Washington</source>
<publisher-loc>Corvallis, Oregon, USA</publisher-loc>
<publisher-name>Oregon State University Press</publisher-name>
<year iso-8601-date="2001">2001</year>
</element-citation>
...

Example 4

In a mixed-style bibliographic reference (punctuation and spacing preserved): 
...
<mixed-citation>
<person-group person-group-type="director">
<string-name><surname>Johnson</surname>
<given-names>D. H.</given-names></string-name>
<string-name><surname>O&rsquo;Neil</surname>
<given-names>T. A.</given-names></string-name>
</person-group>,
<role>managing directors</role>.
<source>Wildlife habitat relationships in Oregon
and Washington</source>.
<publisher-loc>Corvallis, Oregon, USA</publisher-loc>:
<publisher-name>Oregon State University Press</publisher-name>;
<year iso-8601-date="2001">2001</year>.
</mixed-citation>
...

Example 5

In an element-style bibliographic reference (punctuation and spacing removed): 
...
<ref id="B7">
<element-citation publication-type="journal">
<person-group>
<name><surname>Norman</surname>
<given-names>John C</given-names></name>
<role>Researcher</role>
<aff>Texas Heart Institute, Houston, TX</aff>
</person-group>
<article-title>...</article-title>
...
</element-citation>
</ref>
...

Example 6

In an element-style bibliographic reference (punctuation and spacing removed): 
...
<ref id="B7">
<element-citation publication-type="film">
<person-group>
<name><surname>Williams</surname>
<given-names>Dorothy Jean</given-names></name>
<role>Director and Cinematographer</role>
</person-group>
<source>Gone with the Mind</source>
<size specific-use="running time"
units="minutes">95 minutes</size>
...
</element-citation>
</ref>
...

Article Authoring Tag Library NISO JATS Draft Version 1.1d2

Version of December 2014

Back to Top