<!-- ============================================================= -->
<!--  MODULE:    Bibliographic Reference (Citation) Class Elements -->
<!--  VERSION:   ANSI/NISO JATS Version 1.2d1 (Z39.96-2015)        -->
<!--  DATE:      June 2017                                         -->
<!--                                                               -->
<!-- ============================================================= -->
 
<!-- ============================================================= -->
<!--                    PUBLIC DOCUMENT TYPE DEFINITION            -->
<!--                        TYPICAL INVOCATION                     -->
<!--
"-//NLM//DTD JATS (Z39.96) JATS DTD Suite Bibliographic Reference (Citation) Class Elements v1.2d1 20170631//EN"
Delivered as file "JATS-references1.ent"                           -->
<!-- ============================================================= -->

<!-- ============================================================= -->
<!-- SYSTEM:     JATS DTD Suite                                    -->
<!--                                                               -->
<!-- PURPOSE:    Defines the bibliographic reference elements      -->
<!--                                                               -->
<!-- TAG SET SPONSOR                                               -->
<!--             National Center for Biotechnology                 -->
<!--                Information (NCBI)                             -->
<!--             National Library of Medicine (NLM)                -->
<!--                                                               -->
<!-- CREATED FOR:                                                  -->
<!--             This module was created for the JATS DTD Suite.   -->
<!--             Digital archives and publishers may use the       -->
<!--             DTD as is for markup of journal literature or     -->
<!--             related material for archiving and transferring   -->
<!--             such material between archives or create a        -->
<!--             custom XML DTD from the Suite for                 -->
<!--             these purposes.                                   -->
<!--                                                               -->
<!--             This DTD is in the public domain. An organization -->
<!--             that wishes to create its own DTD from the suite  -->
<!--             may do so without permission from NLM.            -->
<!--                                                               -->
<!--             The suite has been set up to be extended using a  -->
<!--             new DTD file and a new DTD-specific customization -->
<!--             module to redefine the many Parameter Entities.   -->
<!--             Do not modify the suite directly or redistribute  -->
<!--             modified versions of the suite.                   -->
<!--                                                               -->
<!--             In the interest of maintaining consistency and    -->
<!--             clarity for potential users, NLM requests:        -->
<!--                                                               -->
<!--             1. If you create a DTD from the JATS DTD Suite    -->
<!--                and intend to stay compatible with the suite,  -->
<!--                then please include the following statement    -->
<!--                as a comment in all of your DTD modules:       -->
<!--                   "Created from, and fully compatible with,   -->
<!--                    the ANSI/NISO Z39.96 Journal Article Tag   -->
<!--                    Suite (JATS)."                             -->
<!--                                                               -->
<!--             2. If you alter one or more modules of the suite, -->
<!--                then please rename your version and all its    -->
<!--                modules to avoid any confusion with the        -->
<!--                original suite. Also, please include the       -->
<!--                following statement as a comment in all your   -->
<!--                DTD modules:                                   -->
<!--                   "Based in part on, but not fully compatible -->
<!--                    with, the ANSI/NISO Z39.96 Journal Article -->
<!--                    Tag Suite (JATS)."                         -->
<!--                                                               -->
<!-- ORIGINAL CREATION DATE:                                       -->
<!--             December 2002                                     -->
<!--                                                               -->
<!-- CREATED BY: Mulberry Technologies, Inc. for the NISO Z39.96   -->
<!--             Working Group. Mulberry Technologies was          -->
<!--             supported by National Center for Biotechnology    -->
<!--             Information (NCBI), a center of the US National   -->
<!--             Library of Medicine (NLM).                        -->
<!--                                                               -->
<!--             This module is part of the JATS DTD Suite. The    -->
<!--             Suite is a continuation of work done by NCBI,     -->
<!--             Mulberry Technologies, and Inera Inc. on the NLM  -->
<!--             Journal Archiving and Interchange DTD Suite, which-->
<!--             was originally released in December, 2002.        -->
<!--                                                               -->
<!--             NLM thanks the Harvard University Libraries, both -->
<!--             for proposing that a draft archiving NLM DTD for  -->
<!--             life sciences journals be extended to accommodate -->
<!--             journals in all disciplines and for sponsoring    -->
<!--             Inera Inc.'s collaboration with other DTD         -->
<!--             authors in completing NLM Version 1.0. The        -->
<!--             Andrew W. Mellon Foundation provided support for  -->
<!--             these important contributions.                    -->
<!--                                                               -->
<!--             Suggestions for refinements and enhancements to   -->
<!--             this DTD should be sent in email to:              -->
<!--                 jats@ncbi.nlm.nih.gov                         -->
<!-- ============================================================= -->


<!-- ============================================================= -->
<!--                    DTD VERSION/CHANGE HISTORY                 -->
<!-- ============================================================= -->
<!--
Version  Reason/Occasion                   (who) vx.x (yyyy-mm-dd)
    =============================================================
     JATS Version 1.2d1              (DAL/BTU) v1.2d1  (2017-06-31)

     NISO JATS is a continuing maintenance NISO Standard, which
     requires voting by the ANSI and NISO memberships to be changed. 
      
     This draft DTD represents an interim version of the
     non-normative JATS DTD Suite, as an indication to JATS users
     the decisions that have been made by the JATS Standing
     Committee. This draft has not yet been given public review 
     or voting. The formal public identifiers were changed in the 
     modules and the catalogs.
 
 25. INLINE GRAPHIC and PRIVATE-CHAR- both <inline-graphic> and
     <private-char> added to elements allowed in:
      - <data-title>
      - <std>.
 
 24. PUB-ID-TYPE - @pub-id-type changed from a fixed list to
     CDATA for all usages of the attribute.

 23. SOURCE - Added the following elements to <source>, to more
     closely mirror the model of <article-title>:
        - inline-display class
             alternatives | inline-graphic | private-char
        - inline-math class 
             chem-struct | inline-formula
        - math class
             tex-math | mml:math
        - simple link class
             fn | target |xref 
        - abbrev class
             abbrev
   
 22. JATS became version "1.2d1" and "v1.1d2 20170631" 

     =============================================================
     JATS Version 1.1                (DAL/BTU) v1.1  (2015-12-15)

     JATS is a continuing maintenance NISO Standard, which
     requires voting by the ANSI and NISO memberships to be changed. 
     JATS 1.1 was approved in late 2015, so the formal public 
     identifiers were changed in the modules and the catalogs.
     No model or attribute changes were made at this time. 
 
 21. JATS became version "1.1" and "v1.1 20151215"

     =============================================================
     JATS Version 1.1d3             (DAL/BTU) v1.1d3  (2015-03-01)
   
     The changes in this release are in response to NISO 
     License and Indicators Recommended Practice.

     NISO JATS is a continuing maintenance NISO Standard, which 
     requires voting by the NISO membership to be changed. This
     Committee Draft 1.1d3 will be sent to the NISO voting
     membership, to become (if approved) NISO JATS 1.1.
     
     This draft DTD represents an interim version of the
     non-normative JATS DTD Suite, as an indication to JATS users
     the decisions that have been made by the JATS Standing
     Committee.

 20. JATS became version "1.1d3" and "v1.1 20150301//EN"

     =============================================================
     JATS Version 1.1d2              (DAL/BTU) v1.1d2 (2014-09-30)
   
     NISO JATS is a continuing maintenance NISO Standard, which 
     requires voting by the NISO membership to be changed. This
     Committee Draft 1.1d2 will be sent to the NISO voting
     membership, to become (if approved) NISO JATS 1.1.
     
     This catalog represents an interim version of the
     non-normative JATS DTD Suite, as an indication to JATS users
     the decisions that have been made by the JATS Standing
     Committee.

 19. ATTRIBUTES FOR PUB-ID
   - Added the linking attributes (optional version) to <pub-id> , 
     so that a <pub-id> that is a DOI, for example, can carry the 
     linking attributes and be made into a live link. In this use
     of <pub-id>, the element is acting both as an identifier
     and as a link.
   - Added new attribute @assigning-authority to <pub-id>, to
     carry new values such as "CrossRef" and to take some of the
     semantic burden off the @pub-id-type attribute, when
     values are organizations such as "Genbank" or "PDB".
 
 18. VERSION FOR DATASETS - Added new element <version>
     for citing datasets and software. Similar to <edition>
     for printed material.
 
 17. DATA TITLE FOR DATASETS - Added new element <data-title>
     to name datasets and parts of datasets. Acts both as an
     <article-title> equivalent and as a <source> equivalent,
     since many levels of data may be cited.

 16. JATS became version "1.1d2" and "v1.1d2 20140930//EN"
   
     =============================================================
     NISO JATS Version 1.1d1           (DAL/BTU) v1.1 (2013-11-15)
   
     ANSI/NISO Z39.96-2012 (pre-release for V1.0 BITS; Version 1.1d1) 

     NISO JATS Standing Committee met and answered the requests and
     suggestions from the NISO request forms.

     Details concerning ANSI/NISO Z39.96-2012 JATS-based DTDs,  
     XSDs, RNGs and supporting documentation are available at
           http://jats.nlm.nih.gov/1.0/

 15. ACCESS DATE ELEMENT
     Added attributes for @calendar and @iso-8601-date. The element is
     deprecated but still in use.

 14. NEW <era> ELEMENT
     Added <era> through date-parts.class to:
      - <date-in-citation>

 13. INSTITUTIONS TO STANDARDS ORGANIZATIONS
     Added the elements <institution-wrap> to the following elements
     through the institution-wrap.class:
      - <std-organization>

 12. GLOBAL ATTRIBUTES - Added the new parameter entity 
         %jats-common-atts;
     to every element in this module. This PE adds (for now) the
     @id attribute and the @xml:base attribute to every element,
     whether metadata or narrative.
     Since the @id in this parameter entity is optional, a second
     parameter entity jats-common-atts-id-required was also added.
     The two are kept in sync with the jats-base-atts parameter 
     entity.
   
     =============================================================
     NISO JATS Version 1.0             (DAL/BTU) v1.0 (2012-xx-xx)
   
     ANSI/NISO Z39.96-2012 (Version 1.0) 

     Details concerning ANSI/NISO Z39.96-2012 JATS-based DTDs,  
     XSDs, RNGs and supporting documentation are available at
           http://jats.nlm.nih.gov/1.0/
   
 11. EDITION 
       a) Changed the long name of the <edition> element
          ("Edition, Cited)") to "Edition Statement, Cited" to
          indicate that element MAY contain more than just the
          edition number.
       b) Changed the definition of <edition> to include the full
          edition statement and not just the edition number.
       c) Added new element @designator to hold the edition
          number, since the definition of edition is changing.
          (through %edition-atts).
   
 10. DATE IN CITATION ATTRIBUTES - Added to the attributes for
     <date-in-citation> (through @date-in-citation-atts):
       a) ISO 8601 standard date format attribute (@iso-8601-date) 
          Format  YYYY-MM-DDThh:mm:ss 
       b) Name of the calendar used (@calendar), to hold values
          such as "Gregorian", "Japanese" (Emperor years), or
          "Islamic".
   
  9. STANDARD ORGANIZATION - Added new element for the name of
     the standards body that created or that promulgates a
     standard. <std-organization> may be used as part of the
     description of a cited standard inside a citation.
     (New PEs: std-organization-atts; std-organization-elements)
   
  8. STANDARD MODEL - Updated the model for <std>, the description
     of a cited standard in side a citation to include several
     elements:
         - <source> contains the name of the standard
         - <pub-id> contains the standard designator
         - date elements <month>, <day>, and <year> name the 
              official date
         - <std-organization> (new element) names the standards 
             body
         - <named-content> takes anything else a publisher/archive 
             wishes to record, such as the standard status, et al.
      The following elements were retained form the older model
      and so will also be allowed inside <std:>

         - <styled-content> because archives cannot always know the
             reason behind a typographic change
         - the emphasis elements (all face markup)
         - <sub> and <sup>
   
 7.  Updated the DTD-version attribute to "1.0" and the formal
     public identifier to the date: "v1.0 20120330//EN".

     =============================================================
     Version 0.4                       (DAL/BTU) v0.4 (2011-01-31)
   
     This Tag Set is in the process of becoming a NISO standard.
     The version numbers are starting over from 0.4", as a Trial
     Use Draft, to be made into "Version 1.0" when the Tag Suite 
     becomes a NISO standard. Thus, the version number that would
     have been "NLM Version 3.1 Draft" has become NISO JATS
     "Version 0.4".

     Details on NISO Trial Use Draft Version 0.4 are available at
           http://jats.nlm.nih.gov/JATS-0.4.
   
  6. Updated the DTD-version attribute to "0.4" 
   
  5. Updated the public identifier to "v0.4 20110131", 
     modified the formal public identifier to include "JATS (Z39.96)",
     and the filename as delivered to include "JATS" and the
     new version number "0".

  4. @SPECIFIC-USE and @XML:LANG - Added the @specific-use and
     @xml:lang to the following elements:
      - access-date through access-date-atts (only @specific-use)
      - annotation through annotation-atts (both)
      - chapter-title through chapter-title-atts (both) NEW PE
      - comment through comment-atts (both)
      - date-in-citation through date-in-citation-atts (both)
      - edition through edition-atts (both)
      - gov through gov-atts (both)
      - note through note-atts (both)
      - part-title through part-title-atts (both) NEW PE
      - patent through patent-atts (both)
      - person-group through person-group-atts (both)
      - pub-id through pub-id-atts (@specific-use only)
      - ref through ref-atts (both)
      - ref-list through ref-list-atts (@specific-use only)
      - series through series-atts (both)
      - source through source-atts (@specific-use only;
          @xml:lang already)
      - std through std-atts (both)
      - time-stamp through time-stamp-atts (@specific-use only)
      - trans-source through trans-source-atts (@specific-use only;
          @xml:lang already)

  3. PERSON GROUP - Changed the model of <person-group> to mixed
     content. This entailed: creating new PE %person-group-elements;
     that contained the elements to be used and Changing PE
     %person-group-model to (#PCDATA %person-group-elements;)*.
     The PE person-group-model has been retained in this module for
     compatibility, but has been set to the mixed model using
     person-group-elements.

  2. ANNOTATION - Changed to content model to use the parameter
     entity %annotation-model; Content model unchanged.

     =============================================================
     Version 3.0                       (DAL/BTU) v3.0 (2007-10-31)

     Version 3.0 is the first non-backward-compatible release.
     In addition to the usual incremental changes, some
     elements and attributes have been renamed and/or remodeled
     to better meet user needs and to increase tag set consistency.
     All module change histories are available through the Tag Suite
     web site at http://dtd.nlm.nih.gov.

     Details on version 3.0 are available at
           http://dtd.nlm.nih.gov/3.0.

  1. Updated public identifier to "v3.0 20080202//EN"              -->

<!-- ============================================================= -->
<!-- Details concerning 
     ANSI/NISO Z39.96-2015 JATS-based DTDs, XSDs, 
     RNGs and supporting documentation are available at
           http://jats.nlm.nih.gov/1.1/                            -->

<!-- ============================================================= -->
<!--                    PARAMETER ENTITIES FOR #PCDATA MODELS      -->
<!-- ============================================================= -->


<!--                    SOURCE ELEMENTS                            -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        a <source> or <trans-source>.              -->
<!ENTITY % source-elements
                        "| %abbrev.class; |
                         %address-link.class; |%emphasis.class; |
                         %inline-display.class; |
                         %inline-math.class; | %math.class; |
                         %phrase-content.class; | 
                         %simple-link.class; | %subsup.class;"       >


<!-- ============================================================= -->
<!--                    PARAMETER ENTITIES FOR ATTRIBUTE LISTS     -->
<!-- ============================================================= -->


<!--                    ACCESS DATE ATTRIBUTES                     -->
<!--                    Attributes for the <access-date> element   -->
<!ENTITY % access-date-atts
            "%jats-common-atts;                                       
             iso-8601-date
                        CDATA                             #IMPLIED
             calendar   CDATA                             #IMPLIED
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED"  >


<!--                    ANNOTATION ATTRIBUTES                      -->
<!--                    Attributes for the <annotation> element    -->
<!ENTITY % annotation-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    CHAPTER TITLE ATTRIBUTES                   -->
<!--                    Attributes for the <chapter-title> element -->
<!ENTITY % chapter-title-atts
            "%jats-common-atts;                                       
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    COMMENT ATTRIBUTES                         -->
<!--                    Attributes for the <comment> element       -->
<!ENTITY % comment-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    DATA TITLE ATTRIBUTES                      -->
<!--                    Attributes for the <data-title> element    -->
<!ENTITY % data-title-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    DATE IN CITATION ATTRIBUTES                -->
<!--                    Attributes for the <date-in-citation>
                                                         element   -->
<!ENTITY % date-in-citation-atts
            "%jats-common-atts;                                       
             iso-8601-date
                        CDATA                             #IMPLIED
             calendar   CDATA                             #IMPLIED
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    EDITION ATTRIBUTES                         -->
<!--                    Attributes for the <edition> element       -->
<!ENTITY % edition-atts
            "%jats-common-atts;                                       
             designator CDATA                             #IMPLIED
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    GOVERNMENT ATTRIBUTES                      -->
<!--                    Attributes for the <gov> element           -->
<!ENTITY % gov-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    NOTE ATTRIBUTES                            -->
<!--                    Attributes for the <note> element          -->
<!ENTITY % note-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    PART TITLE ATTRIBUTES                      -->
<!--                    Attributes for the <part-title> element    -->
<!ENTITY % part-title-atts
            "%jats-common-atts;                                       
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    PATENT ATTRIBUTES                          -->
<!--                    Attributes for the <patent> element        -->
<!ENTITY % patent-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             country    CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    PERSON GROUP ATTRIBUTES                    -->
<!--                    Attributes for the <person-group> element  -->
<!ENTITY % person-group-atts
            "%jats-common-atts;                                       
             person-group-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    PUBLICATION IDENTIFIER ATTRIBUTES          -->
<!--                    Attributes for the <pub-id> element        -->
<!ENTITY % pub-id-atts
            "%jats-common-atts;                                       
             pub-id-type
                        CDATA                              #IMPLIED
             assigning-authority                
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             %might-link-atts;"                                      >


<!--                    REFERENCE ATTRIBUTES                       -->
<!--                    Attributes for the <ref> element           -->
<!ENTITY % ref-atts
            "%jats-common-atts;                                       
              content-type
                        CDATA                             #IMPLIED
              specific-use
                        CDATA                             #IMPLIED
              xml:lang  NMTOKEN                           #IMPLIED"  >


<!--                    REFERENCE LIST ATTRIBUTES                  -->
<!--                    Attributes for the <ref-list> element      -->
<!ENTITY % ref-list-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    SERIES ATTRIBUTES                          -->
<!--                    Attributes for the <series> element        -->
<!ENTITY % series-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    SOURCE ATTRIBUTES                          -->
<!--                    Attributes for the <source> element        -->
<!ENTITY % source-atts
            "%jats-common-atts;                                       
             content-type
                       CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    STANDARDS ATTRIBUTES                       -->
<!--                    Attributes for the <std> element           -->
<!ENTITY % std-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    STANDARDS ORGANIZATION ATTRIBUTES          -->
<!--                    Attributes for the <std-organization> 
                        element                                    -->
<!ENTITY % std-organization-atts
            "%jats-common-atts;                                       
             content-type
                       CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    TIME STAMP ATTRIBUTES                      -->
<!--                    Attributes for the <time-stamp> element    -->
<!ENTITY % time-stamp-atts
            "%jats-common-atts;                                       
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED"  >


<!--                    TRANSLATED SOURCE ATTRIBUTES               -->
<!--                    Attributes for the <trans-source> element  -->
<!ENTITY % trans-source-atts
            "%jats-common-atts;                                       
             content-type
                       CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!--                    VERSION ATTRIBUTES                         -->
<!--                    Attributes for the <version> element       -->
<!ENTITY % version-atts
            "%jats-common-atts;                                       
             designator CDATA                             #IMPLIED
             content-type
                        CDATA                             #IMPLIED
             specific-use
                        CDATA                             #IMPLIED
             xml:lang   NMTOKEN                           #IMPLIED"  >


<!-- ============================================================= -->
<!--                    BIBLIOGRAPHIC REFERENCE LIST ELEMENTS      -->
<!-- ============================================================= -->


<!--ELEM   article-title
                        Defined in %common.ent;                    -->
<!--ELEM   collab       Defined in %common.ent;                    -->
<!--ELEM   conf-date    Defined in %common.ent;                    -->
<!--ELEM   conf-loc     Defined in %common.ent;                    -->
<!--ELEM   conf-name    Defined in %common.ent;                    -->
<!--ELEM   day          Defined in %common.ent;                    -->
<!--ELEM   elocation-id Defined in %common.ent;                    -->
<!--ELEM   email        Defined in %common.ent;                    -->
<!--ELEM   fpage        Defined in %common.ent;                    -->
<!--ELEM   issn         Defined in %common.ent;                    -->
<!--ELEM   issn-l       Defined in %common.ent;                    -->
<!--ELEM   issue        Defined in %common.ent;                    -->
<!--ELEM   lpage        Defined in %common.ent;                    -->
<!--ELEM   month        Defined in %common.ent;                    -->
<!--ELEM   publisher-loc
                        Defined in %common.ent;                    -->
<!--ELEM   publisher-name
                        Defined in %common.ent;                    -->
<!--ELEM   season       Defined in %common.ent;                    -->
<!--ELEM   title        Defined in %common.ent;                    -->
<!--ELEM   trans-title  Defined in %common.ent;                    -->
<!--ELEM   volume       Defined in %common.ent;                    -->
<!--ELEM   year         Defined in %common.ent;                    -->


<!--                    REFERENCE LIST MODEL                       -->
<!--                    Content model for the <ref-list> element   -->
<!ENTITY % ref-list-model
                        "(label?, title?, (%para-level;)*, ref*,
                         (%ref-list.class;)* )"                      >


<!--                    REFERENCE LIST (BIBLIOGRAPHIC REFERENCE LIST)
                                                                   -->
<!--                    List of references (citations) for the
                        article.  Often called "References",
                        "Bibliography", or "Additional Reading". No
                        distinction is made between lists of cited
                        references and lists of suggested references.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=ref-list
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=ref-list
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=ref-list
                                                                   -->
<!ELEMENT  ref-list     %ref-list-model;                             >
<!ATTLIST  ref-list
             %ref-list-atts;                                         >


<!--                    REFERENCE ITEM MODEL                       -->
<!--                    Content model for the <ref> element        -->
<!ENTITY % ref-model    "(label?,
                         (%citation.class; | %note.class;)+ )"       >


<!--                    REFERENCE ITEM                             -->
<!--                    One item in a bibliographic list, typically
                        a citation describing a referenced work, but
                        some journals may place notes in this list as
                        well as citations.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=ref
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=ref
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=ref
                                                                   -->
<!ELEMENT  ref          %ref-model;                                  >
<!ATTLIST  ref
             %ref-atts;                                              >


<!--ELEM   element-citation
                        Defined in %common.ent;                    -->
<!--ELEM   mixed-citation
                        Defined in %common.ent;                    -->


<!--                    NOTE IN A REFERENCE LIST MODEL             -->
<!--                    Content model for a note in a reference
                        list element                               -->
<!ENTITY % note-model   "(label?,
                          (%just-para.class; | %product.class;)+ )"  >


<!--                    NOTE IN A REFERENCE LIST                   -->
<!--                    Used to tag non-citation material that
                        sometimes within a reference list, for
                        example, used to tag end note material when
                        such a note is placed within a reference
                        list.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=note
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=note
                                                                   -->
<!ELEMENT  note         %note-model;                                 >
<!ATTLIST  note
             %note-atts;                                             >


<!-- ============================================================= -->
<!--                    BIBLIOGRAPHIC REFERENCE CLASS              -->
<!-- ============================================================= -->


<!--                    ACCESS DATE ELEMENTS                       -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        the Access Date <access-date> element      -->
<!ENTITY % access-date-elements
                        ""                                           >


<!--                    ACCESS DATE FOR CITED WORK                 -->
<!--                    The date on which the work which is cited
                        was examined. Some online resources are
                        changing so quickly that a citation to the
                        resource is not complete without the date
                        on which the cited resource was examined,
                        since a day before or a day later the
                        relevant material might be different.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=access-date
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=access-date
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=access-date
                                                                   -->
<!ELEMENT  access-date  (#PCDATA %access-date-elements;)*            >
<!ATTLIST  access-date
             %access-date-atts;                                      >


<!--                    ANNOTATION MODEL                           -->
<!--                    The content model for the <annotation>
                        element                                    -->
<!ENTITY % annotation-model
                        "((%just-para.class;)+)"                     >


<!--                    ANNOTATION IN A CITATION                   -->
<!--                    Most citations just provide the bibliographic
                        information for a cited reference but a few
                        describe or comment upon the nature or
                        quality of the reference or summarize its
                        findings.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=annotation
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=annotation
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=annotation
                                                                   -->
<!ELEMENT  annotation   %annotation-model;                           >
<!ATTLIST  annotation
             %annotation-atts;                                       >


<!--                    CHAPTER TITLE ELEMENTS                     -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        the <chapter-title> element                -->
<!ENTITY % chapter-title-elements
                        "%source-elements;"                          >


<!--                    CHAPTER TITLE IN A CITATION                -->
<!--                    Within a citation (such as a <mixed-citation>
                        or an <element-citation>), the title of a
                        cited book is tagged as <source> and the
                        title of a chapter within that book is tagged
                        as <chapter-title>.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=chapter-title
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=chapter-title
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=chapter-title
                                                                   -->
<!ELEMENT  chapter-title
                        (#PCDATA %chapter-title-elements;)*          >
<!ATTLIST  chapter-title
             %chapter-title-atts;                                    >


<!--                    COMMENT ELEMENTS                           -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        the Comment in a Citation <comment> element.
                        Design Note: All inline mixes begin with an
                        OR bar, but since %simple-phrase; is an
                        inline mix, the OR bar is already there.   -->
<!ENTITY % comment-elements
                        "%simple-phrase;"                            >


<!--                    COMMENT IN A CITATION                      -->
<!--                    Used to mark unstructured text within an
                        otherwise element structured reference.
                        In an unstructured reference, this text would
                        merely be data characters.
                        Typical comments could include:
                          <comment>[Abstract]</comment>
                          <comment> translated from Russian</comment>
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=comment
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=comment
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=comment
                                                                   -->
<!ELEMENT  comment      (#PCDATA %comment-elements;)*                >
<!ATTLIST  comment
             %comment-atts;                                          >


<!--                    DATA TITLE ELEMENTS                        -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        a <data-title>.                            -->
<!ENTITY % data-title-elements
                        "| %address-link.class; |      
                           %inline-display-noalt.class; | 
                           %emphasis.class; | 
                           %phrase-content.class; | %subsup.class;"  >


<!--                    DATA TITLE IN A CITATION                   -->
<!--                    Within a citation (such as a <mixed-citation>
                        or an <element-citation>), the title of a
                        cited data source such as a dataset or
                        spreadsheet. 
                        REMARKS: Since datasets can contain very
                        complex relationships, for citing data, this 
                        element may describe different levels, taking
                        the place of both <article-title> and <source>
                        when citing data.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=data-title
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=data-title
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=data-title
                                                                   -->
<!ELEMENT  data-title
                        (#PCDATA %data-title-elements;)*             >
<!ATTLIST  data-title
             %data-title-atts;                                       >

<!--                    DATE IN CITATION ELEMENTS                  -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        the Date Inside Citation <date-in-citation>
                        element                                    -->
<!ENTITY % date-in-citation-elements
                        "| %date-parts.class;"                       >


<!--                    DATE INSIDE CITATION                       -->
<!--                    A container element for any date that may be
                        referenced in a citation, other than the
                        publication date of the cited work.
                        The "content-type" attribute should be used
                        to identify the purpose/type of date. For
                        example, if the element contains the date
                        on which the article contributor examined the
                        cited work, the attribute might be
                        "access-date".
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=date-in-citation
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=date-in-citation
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=date-in-citation
                                                                   -->
<!ELEMENT  date-in-citation
                        (#PCDATA %date-in-citation-elements;)*       >
<!ATTLIST  date-in-citation
             %date-in-citation-atts;                                 >


<!--                    EDITION ELEMENTS                           -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <edition>
                        Design Note: -%just-rendition; begins with
                        an OR bar, so this inline mix begins with
                        an OR bar.                                 -->
<!ENTITY % edition-elements
                        "%just-rendition;"                           >


<!--                    EDITION STATEMENT, CITED                   -->
<!--                    The full edition statement for a cited or
                        referenced publication. This may include
                        textual words ("Third print edition revised"),
                        ordinals ("3rd"), superscripted ordinals
                        ("3<sup>rd</sup>), or simply the edition number
                        ("3"). 
                        Remarks: The @designator attribute may be used
                        to record the alphabetic or numerical 
                        edition number.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=edition
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=edition
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=edition
                                                                   -->
<!ELEMENT  edition      (#PCDATA %edition-elements;)*                >
<!ATTLIST  edition
             %edition-atts;                                          >


<!--                    GOVERNMENT REPORT ELEMENTS                 -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <gov>
                        Design Note: -%rendition-plus; begins with
                        an OR bar, so this inline mix begins with
                        an OR bar.                                 -->
<!ENTITY % gov-elements "%rendition-plus;"                           >


<!--                    GOVERNMENT REPORT, CITED                   -->
<!--                    The identification information (typically the
                        title and/or an identification number) for
                        a cited governmental report or other
                        government publication
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=gov
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=gov
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=gov
                                                                   -->
<!ELEMENT  gov          (#PCDATA %gov-elements;)*                    >
<!ATTLIST  gov
             %gov-atts;                                              >


<!--                    PART TITLE ELEMENTS                        -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        the <part-title> element                   -->
<!ENTITY % part-title-elements
                        "%source-elements;"                          >


<!--                    PART TITLE IN A CITATION                   -->
<!--                    Within a citation (such as a
                        <mixed-citation> or an <element-citation>),
                        when books are divided into Parts (which
                        may then contain smaller units such as
                        chapters), this element can be used to
                        record the title of the cited Part.
                        The book is tagged as <source>.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=part-title
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=part-title
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=part-title
                                                                   -->
<!ELEMENT  part-title   (#PCDATA %part-title-elements;)*             >
<!ATTLIST  part-title
             %part-title-atts;                                       >


<!--                    PATENT NUMBER ELEMENTS                     -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <patent>
                        Design Note: -%just-rendition; begins with
                        an OR bar, so this inline mix begins with
                        an OR bar.                                 -->
<!ENTITY % patent-elements
                        "%just-rendition;"                           >


<!--                    PATENT NUMBER, CITED                       -->
<!--                    The identification information (typically the
                        patent number or number and name) for a
                        cited patent
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=patent
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=patent
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=patent
                                                                   -->
<!ELEMENT  patent       (#PCDATA %patent-elements;)*                 >
<!ATTLIST  patent
             %patent-atts;                                           >


<!--                    PERSON GROUP ELEMENTS                      -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <person-group>                             -->
<!ENTITY % person-group-elements
                        "| %name.class; |
                          %person-group-info.class;"                 >


<!--                    PERSON GROUP MODEL                         -->
<!--                    Content model for the Person Group element -->
<!ENTITY % person-group-model
                        "(#PCDATA %person-group-elements;)*"         >


<!--                    PERSON GROUP FOR A CITED PUBLICATION       -->
<!--                    Wrapper element for one or more authors,
                        editors, translators, etc. named in a cited
                        reference.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=person-group
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=person-group
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=person-group
                                                                   -->
<!ELEMENT  person-group %person-group-model;                         >
<!ATTLIST  person-group
             %person-group-atts;                                     >


<!--                    PUBLICATION IDENTIFIER FOR A CITED PUBLICATION
                                                                   -->
<!--                    The identifier of a publication such as a
                        related journal article that is listed
                        within a citation (such as a <mixed-citation>
                        or an <element-citation>) inside the
                        bibliographic reference list <ref-list> of
                        an article.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=pub-id
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=pub-id
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=pub-id
                                                                   -->
<!ELEMENT  pub-id       (#PCDATA)                                    >
<!ATTLIST  pub-id
             %pub-id-atts;                                           >


<!--                    SERIES ELEMENTS                            -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <series>
                        Design Note: -%rendition-plus; begins with
                        an OR bar, so this inline mix begins with
                        an OR bar.                                 -->
<!ENTITY % series-elements
                        "%rendition-plus;"                           >


<!--                    SERIES                                     -->
<!--                    Container element for any series information
                        used in a citation (such as a <mixed-citation>
                        or an <element-citation>). For example,
                        within a citation to a non-journal item that
                        spans multiple volumes, this element could
                        contain the unique title of the entire series:
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=series
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=series
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=series
                                                                   -->
<!ELEMENT  series       (#PCDATA %series-elements;)*                 >
<!ATTLIST  series
             %series-atts;                                           >


<!--                    STANDARD ELEMENTS                          -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <std>
                        Design Note: -%rendition-plus; begins with
                        an OR bar, so this inline mix begins with
                        an OR bar.                                 -->
<!ENTITY % std-elements "| %emphasis.class; | 
                           %inline-display-noalt.class; |
                           %phrase-content.class; | %std.class; | 
                           %subsup.class;"                           >


<!--                    STANDARD, CITED                            -->
<!--                    The identification information (typically the
                        standard number, organization, and name) for
                        a cited standard, where "standard" is defined
                        as a document produced by a recognized
                        standards body such ISO, IEEE, OASIS, ANSI,
                        etc.
                        The elements that can be used in the mixed
                        content model of a <std> include:
                          <source> contains the name of the standard
                          <pub-id> contains the standard designator
                          date elements name the official date
                          <std-organization> names the standards body
                          <named-content> takes anything else a 
                            publisher/archive needs.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=std
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=std
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=std
                                                                   -->
<!ELEMENT  std          (#PCDATA %std-elements;)*                    >
<!ATTLIST  std
             %std-atts;                                              >


<!--                    STANDARDS ORGANIZATION ELEMENTS            -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <std-organization>.                        -->
<!ENTITY % std-organization-elements 
                        "| %emphasis.class; | 
                         %institution-wrap.class; | %subsup.class;"  >


<!--                    STANDARDS ORGANIZATION                     -->
<!--                    The name of the standards body that created 
                        or that promulgates a standard, such as
                        NISO, ISO, ANSI, or industry standards
                        organizations.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=std-organization
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=std-organization
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=std-organization
                                                                   -->
<!ELEMENT  std-organization
                        (#PCDATA %std-organization-elements;)*       >
<!ATTLIST  std-organization
             %std-organization-atts;                                 >


<!--                    SOURCE                                     -->
<!--                    Within a citation, this is the title of a
                        journal, book, conference proceedings, etc.
                        that is the source of the cited material.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=source
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=source
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=source
                                                                   -->
<!ELEMENT  source       (#PCDATA %source-elements;)*                 >
<!ATTLIST  source
             %source-atts;                                           >


<!--                    TIME STAMP ELEMENTS                        -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        a <time-stamp>.                            -->
<!ENTITY % time-stamp-elements
                        ""                                           >


<!--                    TIME STAMP FOR CITED WORK                  -->
<!--                    Used to record any time stamp that was
                        found on the cited resource when it was
                        examined, for resources such as databases
                        that may use a time signature to identify
                        different versions.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=time-stamp
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=time-stamp
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=time-stamp
                                                                   -->
<!ELEMENT  time-stamp   (#PCDATA %time-stamp-elements;)*             >
<!ATTLIST  time-stamp
             %time-stamp-atts;                                       >


<!--                    TRANSLATED SOURCE                          -->
<!--                    Within a citation, this is the title of a
                        journal, book, conference proceedings, etc.
                        that is the source of the cited material,
                        but with the source name given in a different
                        language from the source as given in the
                        <source> element. For example, if an article
                        is originally in French, the <source> name
                        would be the French name and the
                        <trans-source> might be in English.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=trans-source
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=trans-source
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=trans-source
                                                                   -->
<!ELEMENT  trans-source (#PCDATA %source-elements;)*                 >
<!ATTLIST  trans-source
             %trans-source-atts;                                     >


<!--                    VERSION ELEMENTS                           -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        <version>.
                        Design Note: -%just-rendition; begins with
                        an OR bar, so this inline mix begins with
                        an OR bar.                                 -->
<!ENTITY % version-elements
                        "%just-rendition;"                           >


<!--                    VERSION STATEMENT, CITED                   -->
<!--                    The version number for a cited dataset or
                        software package. This is similar to an
                        edition statement for a publication, in that it
                        may include textual words ("9th"), superscripted 
                        ordinals ("3<sup>rd</sup>), or simply the 
                        version number ("16.2"). 
                        Remarks: The @designator attribute may be used
                        to record the alphabetic or numerical 
                        version number, when the version number contains
                        more than just a number, so the numeric version
                        can be preserved for search and comparison.
                        Details at:
                        http://jats.nlm.nih.gov/archiving/tag-library/1.2d1/index.html?elem=version
                        http://jats.nlm.nih.gov/publishing/tag-library/1.2d1/index.html?elem=version
                        http://jats.nlm.nih.gov/articleauthoring/tag-library/1.2d1/index.html?elem=version
                                                                   -->
<!ELEMENT  version      (#PCDATA %version-elements;)*                >
<!ATTLIST  version
             %version-atts;                                          >


<!-- ================== End Bibliographic Class Module =========== -->
