Version 1.2 Change Report

Changes between JATS 1.1 and 1.2
The ANSI/NISO Z39.96-2019: JATS 1.2 version of the Journal Archiving and Interchange Tag Set is fully backward compatible with JATS version 1.1. Any document valid to JATS 1.1 will be valid to the 1.2 version of the same JATS Tag Set, if the @dtd-version attribute is updated. Changes were made in response to user comments on previous versions.

Changes to Elements

All changes apply to all Tag Sets unless specifically noted below.

Changes to Attributes

The base JATS attributes (@id, @xml:lang), were added to all the new elements. In addition, there were attribute modifications to existing elements.

Article Attributes (on <article>)

  • @dtd-version becomes “FIXED '1.2'” replacing the value “FIXED '1.1'”.
  • Pseudo-attribute xsi:noNamespaceSchemaLocation added to attribute list of <article>, so that it can be edited in XML software. Most modern processors do not require this, but a user with an older processor requested it, so the JATS Standing Committee acquiesced. There are two issues with this pseudo-attribute being defined as an attribute:
    • The pseudo-attribute “xsi:noNamespaceSchemaLocation” cannot be used at the same time as a DOCTYPE declaration. It is the pseudo-attribute many processors use to determine the location of the XSD schema, and is for the use of XSD schema processing only.
    • The pseudo-attribute xsi:noNamespaceSchemaLocation cannot be declared as an attribute in a W3C XSD schema, and many processors will fail to validate a schema that contains it. So when JATS DTDs are converted to XSDs, this is removed as an attribute.

Other Attribute Changes

  • @assigning-authority — Added to the following elements:
    • <article-id>
    • <contrib-id>
    • <institution-id>
    • <issue-id>
    • <journal-id>
    • <object-id>
    • <volume-id>
    (Note: <ext-link> and <pub-id> already took the @assigning-authority attribute.)
  • <article-version> Attributes — Attributes defined for this element are @article-version-type, @designator, @specific-use, @content-type, @iso-8601-date, the four vocabulary attributes, the two JATS base attributes (@id and @xml:base), and all the XLink linking attributes (@xmlns:xlink, @xlink:type, @xlink:href, @xlink:role, @xlink:title, @xlink:show, and @xlink:actuate).
  • <award-id> Attributes — Made the attributes for <award-id> like those of BITS (@id, @xml:base, @rid, @specific-use, @xml:lang, @award-type, and the XLink linking attributes: @xmlns:xlink, @xlink:type, @xlink:href, @xlink:role, @xlink:title, @xlink:show, and @xlink:actuate).
  • @person-group-type — Authoring and Publishing use a restricted list of values. Added the values “illustrator” and “research-assistant” to this value list. Archiving uses an unrestricted CDATA list of values. Added values “illustrator” and “research-assistant” to Archiving’s suggested value list in the non-normative documentation.
  • @pub-id-type — The attribute @pub-id-type for <article-id> and <pub-id> in Publishing and Authoring is a fixed list of values which mixes types and authorities. Although these value lists will not change, the non-normative documentation will specify that for Best Practice, the attribute @pub-id-type should describe the type values and the attribute @assigning-authority should name the responsible agency.
    In Archiving, @pub-id-type is a CDATA attribute instead of as an explicit value list on both <article-id> and <pub-id>.
    Note: The following elements used @pub-id-type as unrestricted CDATA values in version 1.1 in all three tag sets, and are unchanged in version 1.2:
    • <issue-id>
    • <object-id>
    • <volume-id>
  • @style-detail — Added to <styled-content>, <verse-line>, and <verse-group>.
  • <term> Attributes — Added attributes @term-type, @term-status, and the four Vocabulary/Taxonomy attributes described below.
  • @use-type — Added optional CDATA attribute to <mixed-citation> and <element-citation>. The first use-case documented describes cited data usage as “analyzed”, “generated”, etc.
  • Verse Attributes
    • Added @indent-level, @style, @style-detail, and @style-type to <verse-line>.
    • Added @style, @style-detail, and @style-type to <verse-group>.
  • Vocabulary/Taxonomy Attributes — Added four new attributes for naming (and possibly linking to) a general or controlled taxonomy, ontology, vocabulary, index, database, or other source of terms. The four attributes are: @vocab, @vocab-identifier, @vocab-term, and @vocab-term-identifier.
    • Attributes @vocab and @vocab-identifier were added to the elements:
      • <article-version>
      • <compound-kwd>
      • <compound-subject>
      • <inline-media>
      • <institution-id>
      • <kwd>
      • <kwd-group>
      • <named-content>
      • <nested-kwd>
      • <role>
      • <subject>
      • <subj-group>
      • <term>
      • <unstructured-kwd-group>
    • Attributes @vocab-term and @vocab-term-identifier were added to the elements:
      • <article-version>
      • <compound-kwd>
      • <compound-subject>
      • <inline-media>
      • <kwd>
      • <named-content>
      • <nested-kwd>
      • <role>
      • <subject>
      • <term>

Element/Parameter Entity Changes Made to Authoring/Publishing

Element/Parameter Entity Changes Made to Authoring