<history>

History: Document History

Definition

Used as a container for dates related to the processing history of the document, such as received date and accepted date

Conversion Note: The dates inside the <history> element are used to preserve events other than publication date(s) in the life cycle of the article. Publication dates are considered to be an important part of the article metadata. History dates include received date, accepted date, reviewed date, and other dates that may be important to the publisher, but are not a likely part of the article metadata for searching, building a DOI, etc.

Remarks

The <history> element contains one more <date> and/or <string-date> elements; the <date> element has specific parts, such as day and year, inside it and the <string-date> has a textual description of a date. Best practice for the history element is to use to use <date> as much as possible and tag the date components. The <string-date> element should be used only when necessary, for example, when the date does not divide into year and month components. If an archive chooses to make greater use of <string-date>, for example to save money during conversion, it is still considered best practice to tag the year of publication inside the textual date using a +<year> element.

The Archiving DTD allows <string-date> both inside date and at the same level as date. This is the most flexible for allowing the archive to preserve any publisher’s structure. The tighter DTDs created from the base Suite may choose to use one or the other in preference.

Model Information

Content Model

<!ELEMENT  history      %history-model;                              >

Description

Any combination of:

This element may be contained in:

<article-meta> Article Metadata; <front-stub> Stub Front Metadata

Tagged Examples

Example 1

    

With various types of publication dates tagged (best practice):

    
...
<article-meta>
<article-id pub-id-type="pmid">...</article-id>
<title-group>...</title-group>
<contrib-group>...</contrib-group>
<aff id="StLukes">...</aff>
<pub-date pub-type="pub">
<day>27</day><month>03</month>
<year>1999</year>
</pub-date>
<volume>318</volume>
<issue>7187</issue>
<fpage>837</fpage>
<lpage>841</lpage>
<history>
<date date-type="accepted">
<day>29</day>
<month>01</month>
<year>1999</year></date>
</history>
<permissions>
<copyright-statement>Copyright &#x00A9; 1999, British
Medical Journal</copyright-statement>
<copyright-year>1999</copyright-year>
<copyright-holder>British Medical Journal</copyright-holder>
</permissions>
<abstract>
<p>To examine the effectiveness of day hospital 
attendance in prolonging independent living for 
elderly people.</p>
</abstract>
</article-meta>
...


    

Example 2

        

With publication date information treated as character data:

        
...
<article-meta>
...
<supplementary-material>...</supplementary-material>
<history>Paper submitted August 22, 2000; pending government agency 
review/approval, revised manuscript accepted June 12, 2002.</history>
<permissions>
<copyright-statement>...</copyright-statement>
</permissions>
...
</article-meta>
...


    

Module

articlemeta.ent