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

Attributes

content-type Type of Content
specific-use Specific Use
xml:lang Language

Related Elements

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

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

Inside article metadata:

               
...
<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-group>
...
</article-meta>
...


            

Example 2

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>2001</year>
</element-citation>
...


            

Example 3

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>2001</year>.
</mixed-citation>
...


            

Example 4

In an element-style bibliographic reference (punctuation and spacing preserved):

               
...
<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>
<source>Gerontology Clinic</source>
...
</element-citation>
</ref>
...


            

Example 5

In an element-style bibliographic reference (punctuation and spacing preserved):

               
...
<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 units="running time">95 minutes</size>
...
</element-citation>
</ref>
...


            

Module

JATS-common0.ent