content-type Type of Content

Subject or type of content that makes this element semantically distinct.

Usage/Remarks

The values for this attribute may include information classes, semantic categories, or functions for grouping elements. This attribute could identify: the name of a drug, company, or product; systematics terms such as genus, species, or family; or biological systems components, such as gene, protein, or peptide. The attribute could also be used to record that the content of a table cell is a total or subtotal amount, that a sidebar (<boxed-text>) contains a case study, or that a <statement> is a theorem or a proof.
Conversion Note
This attribute can be used to preserve semantic tagging that can’t be captured directly with an element in this Tag Set.
Display/Formatting Note
The presence of a @content-type attribute may be used to treat its element in a distinct way, for example, giving the word, phrase, or structure a different look in print or on display. This type of formatting may be guided by the value of the attribute, for example, making all circulatory system words (identified by a <named-content> element) red or putting a background image behind case studies.
Historical Note
In the redesign of this Tag Set that led to NISO JATS, a @content-type attribute was added to more than 60 elements because “type” attributes are viewed as a useful tool for preserving publisher semantics without extending the Tag Set. The attribute was added according to the following rationale:
  • Unless there was a conflicting rule, a @content-type attribute was added.
  • Elements that cannot repeat (such as <body> and <title-group>) were not given a @content-type attribute. This includes all the “-meta” elements and most top-level structural elements (such as <front> and <back>).
  • Elements that can appear more than once (either by being repeatable in an element content model or by virtue of being part of a #PCDATA OR-group) were given a @content-type attribute.
  • Elements that already had a “type” or “style” attribute were not given a second such attribute.
  • Elements concerning glyph characters were not given a @content-type attribute.
  • EMPTY elements (such as all the counts) were not given a @content-type attribute.
OPTIONAL on element: <contrib-group>
Value Meaning
Text, numbers, or special characters Names the shared role for the contributors within the <contrib-group> element (in the same way that the attribute @contrib-type does for a single contributor>).
Restriction @content-type is an optional attribute; there is no default.

Suggested usage

Taxonomy Best Practice: The @content-type attribute on <contrib-group> was designed to name the role of the contributors in the group and accepts any text as its value. This can be useful in combining contributors into groups such as “Editors”. However, if the role of the contributors is taken from a controlled vocabulary, such as the NISO CRediT Contributor Roles Taxonomy, Best Practice is not to tag the @content-type attribute, but rather to tag the CRediT terms using the <role> element inside the <contrib-group> (or inside each individual contributor [<contrib>]). The major advantages of using the <role> element instead of an attribute are the ability to tie the content of the role to the formal vocabulary using the four JATS vocabulary attributes and the ability for a contributor or group to play more than one role in the creation of an article.
Use of the NISO CRediT, Contributor Roles Taxonomy (http://credit.niso.org//) or any other formal ontology with @content-type is discouraged. At user discretion, free text @content-type values such as “deep sea diver” may be used.
OPTIONAL on element: <role>
Value Meaning
Text, numbers, or special characters Names/describes a distinct semantic role of the contributor (person or collaboration) in the research behind the article or in the article itself. If the contributor played more than one role in the creation of an article, the <role> element should be repeated with a different value for this attribute.
Restriction @content-type is an optional attribute; there is no default.

Suggested usage

Taxonomy Best Practice: The @content-type attribute on <role> was designed to name the role of a contributor or group of contributors, and it accepts any text as its value. This can be useful in assigning contributors groups such as “Editors”. However, if the role of a contributor or group of contributors is from a controlled vocabulary, such as the NISO CRediT Contributor Roles Taxonomy, Best Practice is not to tag the @content-type attribute, but rather to tag the CRediT terms using the vocabulary attributes.
Use of the NISO CRediT, Contributor Roles Taxonomy (http://credit.niso.org//) or any other formal ontology with @content-type is discouraged. At user discretion, free text @content-type values such as “deep sea diver” may be used.
OPTIONAL on element: <related-object>
Value Meaning
Text, numbers, or special characters May be used to name stages in the lifecycle of a related object such as a book, with values such as “preprint” or “version-of-record”. Note that these are lifecycle values describing a related object that is not a journal article, for example, a dataset, book, podcast, or chart.
Restriction @content-type is an optional attribute; there is no default.

Suggested usage

For Clinical Trials: When using <related-object> to tag mentions of Clinical Trials, some suggested values for the @content-type attribute on the <related-object> element include:
  • pre-result
  • result
  • post-result
REQUIRED on element: <named-content>
Value Meaning
Text, numbers, or special characters Names/describes the semantic function for the particular <named-content> element. These elements mark up material that cannot otherwise be described semantically by the elements in this Suite. For example, a medical article might use a @content-type value “body-system” or “gene” while a management article might use a @content-type value “product-name” or “stock-code”.
Restriction @content-type is required; it must be provided if the element is used.
OPTIONAL on many elements; click for list and usage

<abbrev>, <access-date>, <ack>, <addr-line>, <address>, <aff>, <ali:free_to_read>, <ali:license_ref>, <alt-text>, <annotation>, <answer>, <answer-set>, <app>, <app-group>, <array>, <article-version>, <author-comment>, <bio>, <boxed-text>, <caption>, <chem-struct>, <chem-struct-wrap>, <city>, <col>, <colgroup>, <comment>, <compound-kwd>, <compound-kwd-part>, <compound-subject>, <compound-subject-part>, <conf-acronym>, <conf-date>, <conf-loc>, <conf-name>, <conf-num>, <conf-sponsor>, <conf-theme>, <conference>, <contrib-id>, <copyright-holder>, <copyright-statement>, <copyright-year>, <corresp>, <country>, <custom-meta-group>, <data-title>, <date-in-citation>, <day>, <degrees>, <disp-formula>, <disp-formula-group>, <disp-quote>, <edition>, <elocation-id>, <email>, <era>, <explanation>, <fax>, <fig-group>, <fixed-case>, <fn-group>, <fpage>, <glossary>, <gov>, <graphic>, <index-term>, <inline-formula>, <inline-graphic>, <inline-media>, <inline-supplementary-material>, <institution>, <institution-id>, <isbn>, <issn>, <issue>, <issue-id>, <issue-part>, <issue-sponsor>, <issue-subtitle>, <issue-title>, <issue-title-group>, <journal-subtitle>, <journal-title>, <journal-title-group>, <kwd>, <license-p>, <long-desc>, <lpage>, <media>, <milestone-end>, <milestone-start>, <month>, <name>, <nested-kwd>, <note>, <object-id>, <option>, <p>, <page-range>, <patent>, <phone>, <postal-code>, <prefix>, <price>, <publisher>, <question>, <question-preamble>, <question-wrap>, <question-wrap-group>, <rb>, <ref>, <ref-list>, <resource-id>, <resource-name>, <rt>, <ruby>, <season>, <see>, <see-also>, <self-uri>, <series>, <series-text>, <series-title>, <sig>, <sig-block>, <source>, <speaker>, <speech>, <state>, <statement>, <std>, <std-organization>, <string-conf>, <string-date>, <string-name>, <subject>, <subtitle>, <suffix>, <supplementary-material>, <table>, <table-wrap>, <table-wrap-group>, <tbody>, <td>, <tex-math>, <tfoot>, <th>, <thead>, <time-stamp>, <title>, <tr>, <trans-source>, <trans-title>, <trans-title-group>, <uri>, <verse-group>, <verse-line>, <version>, <volume>, <volume-id>, <volume-issue-group>, <volume-series>, <x>, <year>

Value Meaning
Text, numbers, or special characters Names/describes any distinct semantics of the associated element. This may be used to preserve the semantic intent of prior tagging, for example, to record that a table cell was a total or subtotal amount. This may also be used to attach information classes to an element for retrieval purposes.
Restriction @content-type is an optional attribute; there is no default.
Tagged Samples
Non-JATs semantic distinction
...
<collab>
 <named-content content-type="program">Joint United
  Nations Program on HIV/AIDS (UNAIDS)</named-content>,
 <institution>World Health Organization</institution>,
  Geneva, <country>Switzerland</country>
</collab>
...
<compound-kwd-part>
...
<kwd-group kwd-group-type="Inspec-class">
 <compound-kwd>
  <compound-kwd-part content-type="code">B0260</compound-kwd-part>
  <compound-kwd-part content-type="text">Optimisation
   techniques</compound-kwd-part>
 </compound-kwd>
 ...
</kwd-group>
...
<issue-id>
...
<article-meta>
 ...
 <title-group>
  <article-title>The Indian Medical Gazette</article-title>
 </title-group>
 <pub-date pub-type="ppub" iso-8601-date="1866-01-01">...</pub-date>
 <volume>1</volume>
 <volume-id pub-id-type="barcode" 
   assigning-authority="nlm">NLM015999052</volume-id>
 <issue>1</issue>
 <issue-id pub-id-type="archive" content-type="scantrac-id" 
   assigning-authority="nlm">70184</issue-id>
 <fpage>1</fpage>
 <lpage>1</lpage>
 ...
</article-meta>
...
<date-in-citation>
...
<date-in-citation content-type="copyright-year"
  iso-8601-date="1990">1990</date-in-citation>
...
<string-name>
...
<name-alternatives>
  <string-name content-type="display">
    <given-names>Le Thi Tuyet</given-names> <surname>Lan</surname>
  </string-name>
  <string-name content-type="index">
    <surname>Lan</surname> <given-names>Le TT</given-names>
  </string-name>
</name-alternatives>
...
<name>
...
<name content-type="patronymic">
 <surname>H&#246;skuldsd&#243;ttir</surname>
 <given-names>Hallger&#240;ur</given-names>
</name>

<name content-type="matronymic">
 <surname>M&#237;nervud&#243;ttir</surname>
 <given-names>Gu&#240;r&#250;n Eva</given-names>
</name>
...