◇◆

<person-group> Person Group for a Cited Publication

Container element for one or more contributors in a bibliographic reference.

Usage/Remarks

The <person-group> container is typically used to group all the contributors of a particular type (for example, authors, editors, illustrators, data curators, translators) that are named in a reference.

CRediT Best Practice

The @person-group-type attribute was designed to name the type of people in the group and accepts any text as its value. The attribute is typically used as a grouping mechanism: these people are “authors”, these people are “editors”, etc.
However, when the @person-group-type value is taken from a controlled vocabulary, Best Practice is to name the role of the group using the <role> element rather than the @person-group-type attribute. For example, the NISO CRediT, Contributor Roles Taxonomy terms should be described using the <role> element inside <person-group>. Then the links to the CRediT taxonomy can be tied to the <role> using the four JATS vocabulary attributes, and the content of the role can be set to any display value.
Punctuation in Citations (a warning)
This element may be used in bibliographic references (<element-citation> and <mixed-citation>).
This element may also include any punctuation and spacing that is between the names, even when this element is used within an <element-citation>. Therefore, within the context of an element-only <element-citation>, care should be taken not to accidentally allow punctuation and spaces, since an XML parser will not view this as an error.
Attributes
custom-type
person-group-type
specific-use

Base Attributes

id
xml:base
xml:lang
Models and Context
May be contained in
<element-citation>, <mixed-citation>, <nlm-citation>, <product>, <related-article>, <related-object>
Description
Any combination of:
Content Model
<!ELEMENT  person-group %person-group-model;                         >
Expanded Content Model

(#PCDATA | anonymous | collab | collab-alternatives | name | name-alternatives | string-name | aff | aff-alternatives | etal | role)*

Tagged Samples
In citations
Mixed citation
...
<ref-list>
 ...
 <ref>
  <mixed-citation publisher-type="gov">
   <person-group person-group-type="author">
   <string-name><surname>Norman</surname>,
   <given-names>John C</given-names></string-name>, 
   <aff>Texas Heart Institute, Houston, TX</aff>
   </person-group>. <gov>Report No.: NIH-N01-HV-5-3006-4-VI. 
   Contract No. N01-HV-5-3006</gov>. <source>ALVAD: 1980. 
   A comprehensive final report to NHLI</source>. 
   Vol. <volume>1</volume>. <publisher-loc>Bethesda 
   (MD)</publisher-loc>: <publisher-name>National Institutes 
   of Health, National Heart and Lung Institute, Devices 
   and Services Branch</publisher-name>; <month>01</month> 
   <year iso-8601-date="1980-01">1980</year>.
   <size units="pages">340</size> p. <comment>Available 
   from: NTIS, Springfield, VA; PB80-148810</comment>.
  </mixed-citation>
 </ref>
</ref-list>
...
Element citation
...
<ref-list>
 ...
 <ref>
  <element-citation publisher-type="gov">
   <person-group person-group-type="author">
    <name><surname>Norman</surname>
     <given-names>John C</given-names></name>
    <aff>Texas Heart Institute, Houston, TX</aff>
   </person-group>
   <gov>Report No.: NIH-N01-HV-5-3006-4-VI. Contract No.
    N01-HV-5-3006</gov>
   <source>ALVAD: 1980. A comprehensive final report to NHLI</source>
   <volume>1</volume>
   <publisher-loc>Bethesda (MD)</publisher-loc>
   <publisher-name>National Institutes of Health, National Heart and 
    Lung Institute, Devices and Services Branch</publisher-name>
   <month>01</month>
   <year iso-8601-date="1980-01">1980</year>
   <size units="pages">340</size>
   <comment>Available from: NTIS, Springfield, VA;
    PB80-148810</comment>
  </element-citation>
 </ref>
</ref-list>
...
<role> using CRediT terms 
...
<ref>
 <mixed-citation publisher-type="gov">
  <person-group person-group-type="author">
  <string-name><surname>Norman</surname>, 
  <given-names>John C</given-names></string-name>
  (<role vocab="CRediT" 
  vocab-identifier="http://credit.niso.org/"
  vocab-term="Writing &#8212; original draft"
  vocab-term-identifier=
    "http://credit.niso.org/contributor-roles/writing-original-draft/"
  >sole author</role>), <aff>Texas Heart Institute, 
  Houston, TX</aff></person-group>.
  <gov>Report No.: NIH-N01-HV-5-3006-4-VI. Contract No.
  N01-HV-5-3006</gov>. <source>ALVAD: 1980. A 
  comprehensive final report to NHLI</source>.
  Vol. <volume>1</volume>. ...</mixed-citation>
</ref>
...
Related Resource
For a discussion on the use of <person-group>, see Personal Names in Citations.