<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)*
Description
Any combination of:
- Text, numbers, or special characters
- Contributor Naming Elements
- <aff> Affiliation
- <aff-alternatives> Affiliation Alternatives
- <etal> Et Al.
- <role> Role or Function Title of Contributor
This element may be contained in:
Example 1
In an element-style bibliographic reference (punctuation and spacing removed):
...
<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>
...
Example 2
In a mixed-style bibliographic reference (punctuation and spacing preserved):
...
<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>
<comment>Available from: NTIS, Springfield, VA;
PB80-148810</comment>.</mixed-citation>
</ref>
</ref-list>
...
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 — 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>...