Link Class Elements



<!-- ============================================================= -->
<!--  MODULE:    Link Element Classes                              -->
<!--  VERSION:   1.0                                               -->
<!--  DATE:      December 2002                                     -->
<!--                                                               -->
<!-- ============================================================= -->


<!-- ============================================================= -->
<!--                    PUBLIC DOCUMENT TYPE DEFINITION            -->
<!--                        TYPICAL INVOCATION                     -->
<!--
"-//NLM//DTD Archiving and Interchange DTD Suite Link Class Elements v1.0 20021201//EN"
     Delivered as file "link.ent"                                  -->
<!-- ============================================================= -->


<!-- ============================================================= -->
<!-- SYSTEM:     NLM Archiving and Interchange DTD Suite           -->
<!--                                                               -->
<!-- PURPOSE:    Names all elements in the link class. These are   -->
<!--             elements that are links (internal or external)    -->
<!--             by definition, such as URLs <uri> and             -->
<!--             Cross(X)-references <xref>.                       -->
<!--                                                               -->
<!-- CONTAINS:   1) Default definitions of the link classes        -->
<!--             2) Default definitions for attribute values       -->
<!--             3) Default definitions for attribute lists        -->
<!--             4) Models for the link class elements, first      -->
<!--             internal links then external links(alphabetically)-->
<!--                                                               -->
<!--             (Note: Links make their links using the XLink     -->
<!--             global attributes. Many elements besides          -->
<!--             explicit links may be made into links using       -->
<!--             these attributes. Such elements are defined in    -->
<!--             the module appropriate to their use and are not   -->
<!--             listed here.)                                     -->
<!--                                                               -->
<!-- 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. However,   -->
<!--             NLM requests that the following statement be      -->
<!--             included as a comment in all derivative DTDs or   -->
<!--             DTD modules:                                      -->
<!--             "Created using the NLM Archiving and Interchange  -->
<!--             DTD suite."                                       -->
<!--                                                               -->
<!--             Suggestions for refinements and enhancements to   -->
<!--             the DTD suite should be sent in email to:         -->
<!--                 pmc@ncbi.nlm.nih.gov                          -->
<!--             The suite has been set up to be extended using a  -->
<!--             new DTD and a customization module to redefine    -->
<!--             the many Parameter Entities. Do not modify the    -->
<!--             suite directly or redistribute modified versions  -->
<!--             of the suite.                                     -->
<!--                                                               -->
<!-- ORIGINAL CREATION DATE:                                       -->
<!--             December 2002                                     -->
<!--                                                               -->
<!-- CREATED BY: Jeff Beck       (NCBI)                            -->
<!--             Deborah Lapeyre (Mulberry Technologies, Inc.)     -->
<!--             Bruce Rosenblum (Inera Inc.)                      -->
<!--                                                               -->
<!--             NLM thanks the Mellon Foundation's e-Journal      -->
<!--             Archiving Program and Harvard University          -->
<!--             Libraries for their contribution to Version 1.0   -->
<!--             of the suite: first, for proposing that a draft   -->
<!--             archiving NLM DTD for life sciences journals be   -->
<!--             extended to accommodate journals in all           -->
<!--             disciplines, and then for funding Bruce           -->
<!--             Rosenblum's collaboration with other DTD authors  -->
<!--             in completing Version 1.0.                        -->
<!--                                                               -->
<!-- ============================================================= -->


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

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

                                                                   -->


<!-- ============================================================= -->
<!--                    PARAMETER ENTITY DEPENDENCIES
                        Requires the following parameter entities
                        be defined before calling this module,
                        usually accomplished in the Customization
                        Module for the specific DTD:
                        %access.class;
                        %emphasis.class;
                        %might-link-atts;                          -->
<!-- ============================================================= -->


<!-- ============================================================= -->
<!--                    DEFAULT DEFINITION OF THE LINK CLASSES     -->
<!-- ============================================================= -->


<!--                    LINKS/CROSS-REFERENCES CLASS ELEMENTS      -->
<!--                    Elements that act as one end of a link or
                        cross-reference, either internal or external
                                                                   -->
<!ENTITY % link.class   "ext-link | fn |
                         inline-supplementary-material |
                         related-article |
                         target | xref"                              >


<!-- ELEM  related-article
                        Defined in %common.ent                     -->


<!--                    SIMPLE LINKS/CROSS-REFERENCES CLASS        -->
<!--                    The smaller and simpler linking elements
                        that might be inside, for example, a
                        Keyword <kwd>                              -->
<!ENTITY % simple-link.class
                        "fn | target | xref"                         >


<!--                    EXTERNAL LINKS CLASS                       -->
<!--                    Just the external link element, for the
                        first round                                -->
<!ENTITY % ext-links.class
                        "ext-link"                                   >


<!-- ============================================================= -->
<!--                    DEFAULTS FOR ATTRIBUTE VALUES              -->
<!-- ============================================================= -->


<!--                    DEFAULT TYPE OF CROSS(X)-REFERENCE         -->
<!--                    Used to say to what the reference is pointing.
                        May be used for type-specific processing or
                        validation. Values are, for example:
                        Affiliation "aff", Figure "fig", and
                        Bibliographic ref (to a Citation <citation> or
                        to a Reference Item <ref>) "bibr"          -->
<!ENTITY % ref-types    "aff | app | author-notes | bibr |
                         boxed-text | chem | contrib | corresp |
                         disp-formula | fig | fn | kwd | list |
                         plate | scheme | sec | statement |
                         supplementary-material |
                         table | table-fn |
                         other"  >


<!-- ============================================================= -->
<!--                    DEFAULTS FOR ATTRIBUTE LISTS               -->
<!-- ============================================================= -->


<!--                    FOOTNOTE ATTRIBUTES                        -->
<!--                    Attribute list for Footnote element        -->
<!ENTITY %  fn-atts
             "id         ID                                #IMPLIED
              symbol     CDATA                             #IMPLIED
              fn-type    CDATA                             #IMPLIED
              xml:lang   NMTOKEN                           #IMPLIED" >


<!--                    X(CROSS) REFERENCE ATTRIBUTES              -->
<!--                    Attribute list for cross references        -->
<!ENTITY %  xref-atts
             "ref-type   (%ref-types;)                     #IMPLIED
              rid        IDREFS                            #IMPLIED" >


<!--                    INLINE SUPPLEMENTARY MATERIAL              -->
<!--                    Attribute list for inline supp material    -->
<!ENTITY %  inline-supplementary-material-atts
             "%might-link-atts;
              file-type  CDATA                             #IMPLIED" >


<!-- ============================================================= -->
<!--                    INTERNAL LINKS                             -->
<!-- ============================================================= -->


<!--                    FOOTNOTE                                   -->
<!--                    Additional information concerning material in
                        a particular location in the text. This
                        material is not considered to be part of the
                        body of the text, but in addition to or a
                        commentary on the body. Such material may be
                        displayed at the bottom of a printed page,
                        onscreen in a separate pop-up window, or in a
                        list at the end of an article.
                        Remarks: A reference (pointer) to a
                        Footnote <fn> is made with the X(Cross)
                        Reference element.
                        The language attribute may be used to note
                        a footnote that is not in the same language
                        as the original document, for example, a
                        Latin or Greek footnote for a document in
                        English.                                   -->
<!ELEMENT  fn           (p+)                                         >
<!--         id         Unique identifier for the element. A cross-
                        reference will point to this ID.
             symbol     If the symbol that was used in the original
                        display to identify the specific footnote
                        is to be preserved, this is the attribute
                        where it may be stored. One might store the
                        symbol to disambiguate mistagged cases, for
                        example, in which the author has stated
                        "see footnote b" or "see footnote 14"  in
                        the text but the mention of the footnote has
                        not been tagged as a cross references.
             fn-type    Type of footnote, for those footnotes that
                        point to a particular type of information
                        and that type is known, this attribute is
                        intended as a way to preserve that
                        knowledge.  For example, some footnotes
                        point to or are used for the purpose of
                        recording:
                          abbr    Abbreviations
                          com     Communicated-by information
                          con     Contributed-by information
                          conflict
                                  Conflict of interest statements
                          equal   Contributed to the creation of
                                  the document equally
                          corresp For use when the corresponding
                                  author information is not
                                  identified separately, but is
                                  merely a footnote
                          current-aff
                                  Contributor's current affiliation
                          deceased
                                  Person has died since article was
                                  written
                          edited-by
                                  Contributor has the role of an
                                  editor
                          financial-disclosure
                                  Statement of funding or denial
                                  of funds received in support of
                                  the research on which this article
                                  is based
                          on-leave
                                  Contributor is on sabbatical or
                                  other leave of absence
                          participating-researchers
                                  Contributor was a researcher for
                                  this article
                          present-address
                                  Contributor's current address
                          presented-at
                                  Conference, colloquium, or other
                                  occasion at which this paper
                                  was presented
                          presented-by
                                  Contributor who presented this
                                  material
                          previously-at
                                  Contributor's previous location
                                  or affiliation
                          reprint Method or place to obtain reprints,
                                  typically the name and address of
                                  a person form whom reprints can be
                                  requested
                          study-group-members
                                  Contributor was a member of the
                                  study group for this research
                          supplementary-material
                                  Points to or describes
                                  supplementary material for this
                                  article
                          supported-by
                                  The research upon which this
                                  article is based was supported by
                          other    Not in the above list of
                                   footnote types
            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  fn
             %fn-atts;                                               >


<!--                    TARGET OF AN INTERNAL LINK                 -->
<!--                    May be placed anywhere within textual
                        material such as a paragraph to provide a
                        location (anchor) to which a cross reference
                        can point                                  -->
<!ELEMENT  target       (#PCDATA %link-elements;)*                   >
<!--         id         Unique identifier so the element may be
                        referenced                                 -->
<!ATTLIST  target
             id         ID                                 #REQUIRED >


<!--                    X(CROSS) REFERENCE                         -->
<!--                    Used for any kind of internal article
                        referencing. The content of the reference
                        (if present) will be displayed as the link.
                        This element may be used to anything that
                        has an "id".  The "ref-type" attribute says
                        what the reference is pointing to.         -->
<!ELEMENT  xref         (#PCDATA %link-elements;)*                   >
<!--        ref-types   Used to say to what the reference is pointing.
                        May be used for type-specific processing or
                        validation.
                        Values are:
                          aff       Affiliation
                          app       Appendix
                          author-note
                                    Author Note
                          bibr      Bibliographic ref (to
                                    a Citation <citation>
                                    or to a Reference
                                    Item <ref>)
                          boxed-text
                                    Textbox or sidebar
                          chem      Chemical Structure
                                    Wrapper or Chemical
                                    Structure
                          contrib   Contributor
                          corresp   Corresponding Author
                          disp-formula
                                    Display Formula
                          fig       Figure or fig-group
                          kwd       Keyword
                          fn        Footnote
                          list      List
                          plate     Plate
                          scheme    Scheme
                          sec       Section
                          statement Statement
                          supplementary-material
                                    Supplementary Information
                          table     Table Group or Table Wrapper
                          table-fn  Table foot Note
                                    A <fn> that is found within a
                                    <table-wrap> element and that
                                    should be displayed with the
                                    table rather than, for example,
                                    at the bottom of the page or
                                    in a window that does not contain
                                    the table.
                          other     Not listed above               -->
<!ATTLIST  xref
             %xref-atts;                                             >


<!-- ============================================================= -->
<!--                    EXTERNAL LINKS                             -->
<!-- ============================================================= -->


<!--                    INLINE SUPPLEMENTARY MATERIAL ELEMENTS     -->
<!--                    Elements for use in the
                       <inline-supplementary-material> element     -->
<!ENTITY % inline-supplementary-material-elements
                        "| %access.class; | %emphasis.class; |
                         %subsup.class;"                             >


<!--                    INLINE SUPPLEMENTARY MATERIAL              -->
<!--                    An in-text link to an external file that
                        provides supplementary information for
                        the document, for example, an audio clip   -->
<!ELEMENT  inline-supplementary-material
                        (#PCDATA
                         %inline-supplementary-material-elements;)*  >
<!--         xlink:href Provides an address or identifier of the
                        object to which the link points, for
                        example a URI or a filename
             file-type  The type of file, if known (jpeg, gif, etc.)           -->
<!ATTLIST  inline-supplementary-material
             %inline-supplementary-material-atts;                    >


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