person-group-type Type of People in the Person Group
Role of the person(s) being named in the <person-group> element (for example, author, editor, curator).
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.).
Semantic Roles Best Practice
When a contributor role is described by a controlled vocabulary, such as the NISO CRediT (Contributor Roles Taxonomy), Best Practice is not to use the @person-group-type attribute to name the formal contributor role. (The attribute may still be useful for informal groupings such as “editors”.)
Best Practice is to use the <role> element inside <person-group> to indicate that all members of the group perform the same function. The vocabulary attributes on <role> should then point directly to the appropriate CRediT term, allowing the content of the <role> element to take any useful display value, while still preserving the CRediT semantics.
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.
Person Group Type Not on the List
When a JATS tagger needs to record a value that is not a named value on the list, they should use the value “custom”. This tells a JATS processor that this @person-group-type is not one of the known types. The attribute @custom-type should then be used to record the type of person group.
<person-group @person-group-type="custom" custom-type="statisticians">
OPTIONAL on element: <person-group>
|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.|
|compiler||Persons who put together a composite work from multiple sources.|
|curator||Person or group responsible for data curation or archival curation|
|custom||Not one of the meanings named in this list. The type can be found as the value of the attribute @custom-type|
|guest-editor||Content editors who 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 work from one language into another.|
|Restriction||@person-group-type is an optional attribute; there is no default.|
@person-group-type identifies contributor groups
... <person-group person-group-type="author"> <name><surname>Lawrence</surname> <given-names>Ruth A</given-names></name> </person-group> ...
Using both @person-group-type and <role>
<role> can describe the function of a contributor using CRediT taxonomy 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="credit.niso.org/" vocab-term="Writing — original draft" vocab-term-identifier= "credit.niso.org/contributor-roles/writing-original-draft/" degree-contribution="lead" >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> ...