<person-group>

Person Group for a Cited Publication

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

Remarks

The container can be used to group all the contributors of a particular type (for example, authors, editors, illustrators, 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 was also designed to accept any text as its value. However, if the @person-group-type value would be taken from a controlled vocabulary, such as CRediT, Best Practice is not to name the role using @person-group-type. Best Practice (when possible) is to tag the CRediT contributor role taxonomy terms by using the <role> element inside <person-group>. The major advantage of using <role> is the ability to tie the content of the role to the formal vocabulary using the four JATS vocabulary attributes.
Related Essay: For a discussion on the use of <person-group>, see Personal Names in Citations.
Usage: 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

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 | x)*

Description

This element may be contained in:

Example 1

In an element-style bibliographic reference (punctuation and spacing removed):
<article dtd-version="1.2">
<front>...</front>
<body>...</body>
<back>
<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="page">340</size>
<comment>Available from: NTIS, Springfield, VA;
PB80-148810</comment>
</element-citation>
</ref>
</ref-list>
</back>
</article>

Example 2

In a mixed-style bibliographic reference (punctuation and spacing preserved):
<article dtd-version="1.2">
<front>...</front>
<body>...</body>
<back>
<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="page">340</size> p.
<comment>Available from: NTIS, Springfield, VA;
PB80-148810</comment>.</mixed-citation>
</ref>
</ref-list>
</back>
</article>

Example 3

Using the <role> element to describe the function of the author using a CRediT taxonomy term:
...
<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://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"
>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>...