person-group-type
Type of People in the Person Group
Role of the persons being named in <person-group> element (for example, author, editor, curator).
Usage
Attribute Contents:
The @person-group-type attribute was designed to name the role of the contributor inside a <person-group>. This tag set has a fixed list of types such as (“allauthors”,
“assignee”,
“compiler”,
“curator”,
“director”, etc.).
Remarks
Best Practice: When to Use @person-group-type - The person-group types values are an older and restricted set of contributor roles. Best Practice is to name the role using the <role> element inside <person-group>, rather than to use @person-group-type. Suggested practice is to tag the CRediT contributor role taxonomy term using the <role> element.
The major advantages of using <role> instead of @person-group-type are:
- The ability to tie the content of the role to a formal vocabulary using the four JATS vocabulary attributes, and
- the ability for a contributor to play more than one role in the creation of an article.
Roles defined by the CRediT taxonomy may include, for example, “Conceptualization” (ideas; formulation or evolution of overarching research goals and aims),
“Data curation” (management activities to annotate [produce metadata], scrub data and maintain research data [including software code, where it is necessary for interpreting the data itself] for initial use and later reuse), or
“Writing – original draft” (creation and/or presentation of the published work, specifically writing the initial draft).
Used on Element: <person-group>
| Value | Meaning |
|---|---|
| allauthors | Used to identify a complete list of authors when a subset of the author group is used elsewhere in the citation. This may occur, for example, when a citation identifies both a book and a chapter within the book. |
| assignee | Persons to whom a patent is awarded. |
| author | Content creators. |
| compiler | Persons who put together a composite work from multiple sources. |
| curator | Person or group responsible for data curation or archival curation. |
| director | Directors. |
| editor | Content editors. |
| guest-editor | Content editors that have been invited to edit all or part of a work. |
| illustrator | Creator of the pictures, drawings, or other illustrations (includes photographer) |
| inventor | Idea, software, or machine creators. |
| research-assistant | Assisted with the scientific research that is the basis for a work |
| transed | Editors of a translated version of a work. |
| translator | Persons who translated the cited work from one language into another. |
| Restriction | @person-group-type is an optional attribute; there is no default. |
Example 1
...
<person-group person-group-type="author">
<name><surname>Lawrence</surname>
<given-names>Ruth A</given-names></name>
</person-group>
...Example 2
Using @person-group-type as well as the <role> element, which describes the function of the contributor 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>...