◇◆

<event> Event in Publishing History

An event in the publication history of an article, for example, reprinting or publishing a revised online edition. This element may contain information such as a description of the event (<event-desc>), copyright information for a reprint or edition, a publication date, a URI for the article, etc.

Usage/Remarks

An <event> can be the description of a pre- or post-publication event including dates, link(s), an article version, and/or descriptive commentary. An <event> element can also be used to describe earlier versions of an article. As an example, one publisher has an article that was posted on a preprint server, then one version of the author’s accepted manuscript was published, then a subsequent version revising this document was published, then the version of record was published, and then an updated version of record was published. No official “corrections” were published with any of these documents, but each new document can be described with an <event> element.
Related Elements
An <event> provides a more complete description of a date in the lifecycle of an article than can be provided by merely putting a <date> element inside <history>.
Role of <date>: Inside both <history> and <event>, the <date> element can identify the type of date using the attribute @date-type (“received”, “accepted”) and the format of the publication using the @publication-format attribute (“print”, “electronic”).
Role of <event>: In addition to one or more dates, the <event> inside <pub-history> can provide:
  • a human readable description of the publishing event,
  • article version and article identification numbers,
  • the publication date associated with the event,
  • and ISSN or linking ISSN,
  • copyright and licensing information,
  • one or more URIs, and
  • additional notes.
Best Practice: An <event> may include those things that are usually handled by <history>, such as when the manuscript was received or accepted, but an <event> need not be recorded for any particular date in history. However, the JATS Standing Committee recommends that, within a single XML document, either the <history> or the <pub-history> element be used. In other words, if some of your significant dates need to be described as events, all your dates should be inside <event> in <pub-history> and any existing <date> elements within <history> made into pub-history/event dates.
Attributes
event-type
specific-use

Base Attributes

id
xml:base
xml:lang
Models and Context
May be contained in
<pub-history>
Description
The following, in order:
Content Model
<!ELEMENT  event        %event-model;                                >
Expanded Content Model

(event-desc?, article-id*, (article-version | article-version-alternatives)?, ((pub-date)* | pub-date-not-available?), (date)*, issn*, issn-l?, isbn*, permissions?, notes*, self-uri*)

Tagged Samples
Simple events
Using <pub-history> and <event>s for an elaboration of or a replacement for <date> elements inside <history>. 
...
<article-meta>
 ...
 <pub-history>
  <event event-type="received">
   <event-desc>Received: <date date-type="received" iso-8601-date="2017-09-12">
    <day>12</day><month>September</month><year>2017</year></date></event-desc>
  </event>

  <event event-type="accepted">
   <event-desc>Accepted: <date date-type="accepted" iso-8601-date="2018-05-26">
    <day>26</day><month>May</month><year>2018</year></date></event-desc>
  </event>

  <event event-type="pub">
   <event-desc>Accepted Manuscript published: <pub-date date-type="pub" iso-8601-date="2018-05-30">
    <day>30</day><month>May</month><year>2018</year></pub-date> (version 1)</event-desc>
  </event>

  <event event-type="pub">
   <event-desc>Version of Record published: <pub-date date-type="pub" iso-8601-date="2018-06-13">
    <day>13</day><month>June</month><year>2018</year></pub-date> (version 2)</event-desc>
  </event>
 </pub-history>
</article-meta>
...
Detailed event description 
...
<article-meta>
 ...
 <pub-history>
  <event event-type="revision">
   <event-desc>The first version of this article was 
    enhanced considerably between versions of the XML 
    instance. These changes can be seen <ext-link
    ext-link-type="uri" 
    xlink:href="https://elifesciences.org/content/5/e00666v3">
    here</ext-link>.</event-desc>
   <date date-type="accepted-manuscript-r1" 
     iso-8601-date="2016-07-29">
    <day>29</day>
    <month>07</month>
    <year>2016</year>
   </date>
   <self-uri content-type="accepted-manuscript"
     xlink:href="https://elifesciences.org/content/5/e00666v2"/>
  </event>
  ...
 </pub-history>
</article-meta>
...
Related Resources