Bibliographic Reference (Citation) Class Elements



<!-- ============================================================= -->
<!--  MODULE:    Bibliographic Reference (Citation) Class          -->
<!--               Elements                                        -->
<!--  VERSION:   1.1                                               -->
<!--  DATE:      November 1, 2003                                  -->
<!--                                                               -->
<!-- ============================================================= -->

<!-- ============================================================= -->
<!--                    PUBLIC DOCUMENT TYPE DEFINITION            -->
<!--                        TYPICAL INVOCATION                     -->
<!--
"-//NLM//DTD Archiving and Interchange DTD Suite Bibliographic Reference (Citation) Class Elements v1.1 20031101//EN"
Delivered as file "references.ent"                                 -->
<!-- ============================================================= -->

<!-- ============================================================= -->
<!-- SYSTEM:     Archiving and Interchange DTD Suite               -->
<!--                                                               -->
<!-- PURPOSE:    Defines the bibliographic reference elements      -->
<!--                                                               -->
<!--                                                               -->
<!-- CONTAINS:   1) Default definition of the references class     -->
<!--             2) Parameter Entities for attribute lists         -->
<!--             3) Models for the bibliographic reference         -->
<!--                class elements in alphabetical order           -->
<!--                                                               -->
<!-- CREATED FOR:                                                  -->
<!--             Digital archives and publishers who wish to       -->
<!--             create a custom XML DTD for original markup of    -->
<!--             journal literature, books, and related material,  -->
<!--             or for archiving and transferring such material   -->
<!--             between archives.                                 -->
<!--                                                               -->
<!--             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 Archiving and     -->
<!--                Interchange 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 Archiving and Interchange DTD Suite."  -->
<!--                                                               -->
<!--             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 Archiving and Interchange DTD    -->
<!--                    Suite."                                    -->
<!--                                                               -->
<!--             Suggestions for refinements and enhancements to   -->
<!--             the DTD suite should be sent in email to:         -->
<!--                 archive-dtd@ncbi.nlm.nih.gov                  -->
<!--                                                               -->
<!-- ORIGINAL CREATION DATE:                                       -->
<!--             December 2002                                     -->
<!--                                                               -->
<!-- CREATED BY: Jeff Beck       (NCBI)                            -->
<!--             Deborah Lapeyre (Mulberry Technologies, Inc.)     -->
<!--             Bruce Rosenblum (Inera Inc.)                      -->
<!--                                                               -->
<!--             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    -->
<!--             Bruce Rosenblum's collaboration with other DTD    -->
<!--             authors in completing Version 1.0. The Andrew W.  -->
<!--             Mellon Foundation provided support for these      -->
<!--             important contributions.                          -->
<!--                                                               -->
<!-- ============================================================= -->


<!-- ============================================================= -->
<!--                    DTD VERSION\CHANGE HISTORY                 -->
<!-- ============================================================= -->
<!--

     =============================================================

Version  Reason/Occasion                   (who) vx.x (yyyy-mm-dd)

     =============================================================
     Version 1.1                           (TRG) v1.1 (2003-11-01)

  2. Added element <page-count> to parameter entity
     %references.class;
     Rationale:  Permit tagging of page count where included in
     references.

     =============================================================
     Version 1.0 Post Publishing DTD Change (dal) v 1.0 2003-02-10

  1. Removed <other-ref>, since the Publishing (authoring) DTD did
     not need it and that is what it had been made for. It was
     never to be used for conversion or interchange, so it's gone.
     Removed %other-ref-elements; as well. It did not need to be
     removed from any context, as it was never used.
                                                                   -->


<!-- ============================================================= -->
<!--                    PARAMETER ENTITY DEPENDENCIES
                        Requires the following parameter entities
                        be defined before calling this module,
                        usually accomplished in the Customization
                        Module for the specific DTD:
                          %emphasis.class;
                          %ext-links.class;
                          %just-rendition;
                          %label.class;
                          %para-level;
                          %rendition-plus;
                          %simple-phrase;
                          %simple-text;
                          %subsup.class;                           -->
<!-- ============================================================= -->


<!-- ============================================================= -->
<!--                    DEFAULT REFERENCES CLASS                   -->
<!-- ============================================================= -->


<!--                    BIBLIOGRAPHIC REFERENCE (CITATION) CLASS   -->
<!--                    The elements that may be included inside a
                        Citation (bibliographic reference)         -->
<!ENTITY % references.class
                        "access-date | annotation | article-title |
                         collab | comment |
                         conf-date | conf-loc | conf-name |
                         day | edition | email | elocation-id |
                         etal | fpage |  gov | issn | isbn |
                         issue | lpage | month | name | page-count |
                         patent | person-group | pub-id |
                         publisher-loc | publisher-name | season |
                         series | source | std | supplement |
                         time-stamp | trans-source | trans-title |
                         volume | year"                              >


<!--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   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;                    -->


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


<!--                    PERSON GROUP ATTRIBUTES                    -->
<!--                    Attributes for the <person-group> element  -->
<!ENTITY %  person-group-atts
             "person-group-type
                        CDATA                             #IMPLIED"  >


<!--                    PUBLICATION IDENTIFIER ATTRIBUTES          -->
<!--                    Attributes for the <pub-id> element        -->
<!ENTITY %  pub-id-atts
             "pub-id-type
                        (%pub-id-types;)                  #IMPLIED"  >


<!--         xml:lang   The language in which the value of the
                        element is expressed.  Recommended best
                        practice is to use values as defined in
                        RFC 1766, typically 2-letter language
                        codes such as "FR" (French), "EN" (English),
                        and "DE" (German). These values are NOT
                        case sensitive, so "EN" = "en". The values
                        may include hyphenated differentiators such
                        as "EN-AU" (Australian English) and "EN-US"
                        (United States English).                   -->


<!--                    SOURCE ATTRIBUTES                          -->
<!--                    Attributes for the <source> and
                        <trans-source> elements                    -->
<!ENTITY %  source-atts
             "xml:lang   NMTOKEN                           #IMPLIED" >

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


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


<!--                    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.
                        Authoring Note: The optional paragraph-level
                        elements after the title allow for those rare
                        cases where there is explanatory material
                        inside the list, before the references. There
                        may also be similar explanatory material
                        inside each reference group. Explanatory
                        material preceding a citation will need to
                        be placed inside the citation.             -->
<!ELEMENT  ref-list     (%ref-list-model;)                           >


<!--                    REFERENCE ITEM MODEL                       -->
<!ENTITY % ref-model    "label?, (citation | note)+"                 >


<!--                    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.
                        Conversion Note: There is usually a number or
                        other label preceding each citation, which
                        the tagger may choose to preserve using the
                        label attribute.                           -->
<!ELEMENT  ref          (%ref-model;)                                >
<!--         id         Unique identifier so that citation can be
                        referenced                                 -->
<!ATTLIST  ref
             id         ID                                 #IMPLIED  >


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


<!--                    NOTE IN A REFERENCE LIST MODEL             -->
<!ENTITY % note-model   "label?, p+"                                 >


<!--                    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.
                        Authoring Note: For conversion use only. For
                        creating new reference lists, notes should
                        not be intermingled with citations.        -->
<!ELEMENT  note         (%note-model;)                               >
<!--         id         Unique identifier so that citation can be
                        referenced                                 -->
<!ATTLIST  note
             id         ID                                 #IMPLIED  >


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


<!--                    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.
                        Related Elements: The related element
                        <time-stamp> is used to record not the time
                        when a cited resource was examined, but the
                        time stamp that was found on the resource
                        when it was examined, for time-stamped
                        resources.                                 -->
<!ELEMENT  access-date  (#PCDATA)                                    >
<!--ELEMENT  access-date  (#PCDATA | day | month | year)*     -->


<!--                    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.
                        Display Note: All of the other reference
                        elements are inline elements. In contrast,
                        an Annotation may be considered a block
                        element, with space before it and after it.-->
<!ELEMENT  annotation   (p+)                                         >


<!--                    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>
                        Design Note: The <comment> element is defined
                        here largely for the sake of conversion, to
                        preserve the semantic markup when translating
                        from other DTDs.
                        Authoring and Conversion Note: The Comment
                        element should be used to mark substantive
                        text only; it should NOT be used to markup
                        punctuation that occurs between elements.
                        Display Note: Comments should appear inline
                        with other reference elements.  This is a
                        very different rendering from that given the
                        similar element Annotation, which is
                        typically a longer commentary concerning a
                        citation that is rendered as a block
                        element.                                   -->
<!ELEMENT  comment      (#PCDATA | %simple-phrase;)*                 >


<!--                    EDITION, CITED                             -->
<!--                    The edition number of a cited publication  -->
<!ELEMENT  edition      (#PCDATA %just-rendition;)*                >


<!--                    GOVERNMENT REPORT, CITED                   -->
<!--                    The identification information (typically the
                        title and/or an identification number) for
                        a cited governmental report or other
                        government publication                     -->
<!ELEMENT  gov          (#PCDATA %rendition-plus;)*                  >


<!--                    ISBN                                       -->
<!--                    International Standard Book Number         -->
<!ELEMENT  isbn         (#PCDATA)                                    >


<!--                    PATENT NUMBER, CITED                       -->
<!--                    The identification information (typically the
                        patent number or number and name) for a
                        cited patent                               -->
<!ELEMENT  patent       (#PCDATA %just-rendition;)*                  >


<!--                    PERSON GROUP FOR A CITED PUBLICATION       -->
<!--                    Wrapper element for one or more authors,
                        editors, translators, etc. named in a cited
                        reference.
                        Remarks: Similar to the <contrib-group>
                        element in the metadata, but could not use
                        the same name (as this is a DTD not a schema)
                        since the content is different.            -->
<!ELEMENT  person-group (name | aff |etal)*                          >
<!--         person-group-type
                        Identifies the "role" of the persons being
                        named, a group of authors, a group of
                        editors, members of the G&S chorus, etc.
                        Valid Types include:
                          author - Content creators
                          editor - Content editors
                          guest-editor
                                 - Content editor that has been
                                   invited to edit all or part of
                                   a work
                          inventor
                                 - Idea, software, or machine creator
                          assignee
                                 - Person to whom a patent is awarded
                          translator
                                 - Translated the cited work from
                                   one language into another
                          trans-editor
                                 - Editor of a translated version of
                                   a work
                          all-authors
                                 - Used to identify a complete list
                                   of authors when a subset of the
                                   author group is used elsewhere
                                   in the citation. This may occur,
                                   for example, when a citation
                                   identifies both a book and a
                                   chapter within the book.
                          complier
                                 - Put together a composite work
                                   from multiple sources
                                                                   -->
<!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 <citation> inside the
                        bibliographic reference list <ref-list> of
                        an article.                                -->
<!ELEMENT  pub-id       (#PCDATA)                                    >
<!--         pub-id-type
                        The "pub-id-type" attribute names the
                        type of identifier, or the organization or
                        system that defined this identifier for the
                        identifier of the journal article or a
                        cited publication.
                           Used on the <article-id> element, which
                        holds an identifier for the entire article.
                           Also used on the <pub-id> element, which
                        is an identifier for a publication cited in
                        a bibliographic reference (citation).
                        Valid Types include:
                          coden  - Obsolete PDB/CCDC identifier, may
                                   be present on older articles
                          doi    - Digital Object Identifier for
                                   the publication being referenced
                          medline- NLM Medline identifier
                          other  - None of the named identifiers
                          pii    - Publisher Item Identifier, see
                                    /epub/piius.htm
                          pmid   - PUBMED ID (see
                                   www.ncbi.nlm.nih.gov/entrez/
                                   query.fcgi?db=PubMed)
                          publisher-id -
                                   Publisher's identifying number
                                   such as an 'article-id', 'artnum',
                                   'identifier', 'article- number',
                                   etc.
                          sici   - Serial Item and Contribution
                                   Identifier (SICI). A journal
                                   article may have more than one
                                   SICI, one for a print version and
                                   one for an electronic version.  -->
<!ATTLIST  pub-id
             %pub-id-atts;                                           >


<!--                    SERIES                                     -->
<!--                    Container element for any series information
                        used in a 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:
                          <citation citation-type="book">
                          <name>...</name> and <name>...</name>
                          <year>1989</year>. <series>The Birds of
                          South America</series>. <volume>1</volume>.
                          <source>The Oscine Passerines</source>.
                          <publisher-name>University of Texas
                          Press</publisher-name>
                          , <publisher-loc>Austin</publisher-loc>
                          </citation>
                                                                   -->
<!ELEMENT  series       (#PCDATA %rendition-plus;)*                  >

<!--                    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.                                       -->
<!ELEMENT  std          (#PCDATA %rendition-plus;)*                >


<!--                    SOURCE ELEMENTS                            -->
<!--                    The elements that can be included along with
                        data characters inside the content model of
                        a source.                                  -->
<!ENTITY % source-elements
                        "| %emphasis.class; | %ext-links.class; |
                         %subsup.class;"                             >


<!--                    SOURCE                                     -->
<!--                    Within a citation, this is the title of a
                        journal, book, conference proceedings, etc.
                        that is the source of the cited material.  -->
<!ELEMENT  source       (#PCDATA %source-elements;)*                 >
<!--         xml:lang   The language in which the value of the
                        element is expressed.  Recommended best
                        practice is to use values as defined in
                        RFC 1766, typically 2-letter language
                        codes such as "FR" (French), "EN" (English),
                        and "DE" (German). These values are NOT
                        case sensitive, so "EN" = "en". The values
                        may include hyphenated differentiators such
                        as "EN-AU" (Australian English) and "EN-US"
                        (United States English).                   -->
<!ATTLIST  source
             %source-atts;                                           >


<!--                    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. Note: This is not the
                        time when the cited resource was examined,
                        but rather the time it was produced,
                        distributed, whatever milestone the resource
                        creators chose to stamp time stamp.
                        Related Element: <access-date> is the date
                        on which the cited work was examined. Some
                        online resources are changing so quickly
                        that a citation to the resource is not
                        complete without the date.                 -->
<!ELEMENT  time-stamp   (#PCDATA)                                    >


<!--                    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.        -->
<!ELEMENT  trans-source (#PCDATA %source-elements;)*                 >
<!--         xml:lang   The language in which the value of the
                        element is expressed.  Recommended best
                        practice is to use values as defined in
                        RFC 1766, typically 2-letter language
                        codes such as "FR" (French), "EN" (English),
                        and "DE" (German). These values are NOT
                        case sensitive, so "EN" = "en". The values
                        may include hyphenated differentiators such
                        as "EN-AU" (Australian English) and "EN-US"
                        (United States English).                   -->
<!ATTLIST  trans-source
             %source-atts;                                           >


<!-- ================== End Bibliographic Class Module =========== -->
http://dtd.nlm.nih.gov/publishing/tag-library/1.1/n-zdy0.html
dtd.nlm.nih.gov
crawl=CC-MAIN-2018-05
34780
application/http; msgtype=response
sha1:JUCAFJKXE36U4C7RVY5UPRFMHEB4XCAG
<urn:uuid:4ef689c2-3908-4e26-86f2-75ac422b20ba>
2018-01-21T00:39:32Z
130.14.29.119
text/html
sha1:F2GH4EAJMCQH2EWIO77QLBARCM2C7LRL
<urn:uuid:eba78110-26ef-4f77-99ec-7cff138d8b1a>
http://dtd.nlm.nih.gov/publishing/tag-library/1.1/n-zdy0.html
response
<urn:uuid:e7e7e08d-ffa5-4c11-811a-128a179f9998>
robots: classic
hostname: ip-10-239-184-55.ec2.internal
software: Nutch 1.6 (CC)
isPartOf: CC-MAIN-2018-05
operator: Common Crawl Admin
description: Wide crawl of the web for January 2018
publisher: Common Crawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf