<!– ============================================================= –> <!– MODULE: Subject Phrase Class Elements –> <!– VERSION: 2.3 –> <!– DATE: February 2007 –> <!– –> <!– ============================================================= –>

<!– ============================================================= –> <!– PUBLIC DOCUMENT TYPE DEFINITION –> <!– TYPICAL INVOCATION –> <!– “-//NLM//DTD Archiving and Interchange DTD Suite Subject Phrase Class Elements v2.3 20070202//EN”

Delivered as file "phrase.ent"                                -->

<!– ============================================================= –>

<!– ============================================================= –> <!– SYSTEM: Archiving and Interchange DTD Suite –> <!– –> <!– PURPOSE: Defines the phrase.class, that is, names the –> <!– inline, subject-specific elements –> <!– –> <!– If more specific subject words (such as “gene”) –> <!– are added to later version of this DTD, they –> <!– should be added to the %phrase.class; entity and –> <!– defined in this module or in %common.ent; –> <!– –> <!– CONTAINS: 1) Definition of the phrase class –> <!– 2) Subject Emphasis –> <!– –> <!– 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 2.3                       (DAL/BTU) v2.3 (2007-02-02)

    Enhancement Release (2.3) following the Working Group meetings 
    of Oct-Nov/2006-Jan/2007. No backward-incompatible changes.
    Archiving loosened even more. New structures for all the DTDs. 

10. NEW TYPE ATTRIBUTES - Added new "content-type" attribute to the
    following elements, to preserve or add semantic distinctions\
    between different examples of the same element:
    - abbrev

 9. NEW PARAMETER ENTITIES - Added parameter entities for the
    attribute lists of:
    - abbrev

 8. MILESTONES - Added new elements for milestone start and 
    milestone end because sometimes in the real world, the
    proper OCHO (Ordered Hierarchy of Content Objects) hierarchy
    does not always exist.

 7. Updated public identifier to "v2.3 20070202//EN"          

    =============================================================
    Version 2.0                       (DAL/BTU) v2.0 (2004-08-30)

    Major requirement changes led to the new release, producing
    DTD version "2.0":
      a) The splitting of the Archival and Interchange Tag Set 
         DTDs into three DTDs from two: an authoring DTD, an
         archive regularization and interchange DTD (the
         current Blue Publishing DTD), and a preservationist 
         archive DTD (the current Green Archiving and Interchange 
         DTD).
      b) AIT Working Group suggestions from the June 04 meeting 
         and June/July 2004 followup discussions
      c) Suite remodularization to meet new (and newly articulated)
         modularization requirements
      d) New or renamed classes and mixes to make modifications
         easier and more consistent

 6. REGULARIZE USE OF CLASSES
    a. LINK CLASSES - Replaced %link.class; in the PE
       %named-content-elements; with the following classes 
       via inclusion of %all-phrase;
       (no DTD change, just reparameterization):
        - %address-link.class;   (links for journal article)
        - %article-link.class;   (links for journal article)
        - %simple-link.class;    (the internal links, same)

    b. NAMED CONTENT ELEMENTS - To make potential changes easier,
       replaced the Parameter Entity %emphasized-text; with its
       constituent classes

    c. RENAME EXISTING CLASSES
       ### Customization Alert ###
       Some classes did not have the ".class" suffix. Changed the 
       names to add the class suffix:
       - %block-math.class; (used in -%named-content-elements;)

    d. ABBREV - Changed content model to use new %def.class;

 5. DEFAULT CLASSES - Were moved from this module to 
    %default-classes.ent;

 4. Updated public identifier to "v2.3 20070202" 

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

 3. Added following parameter entities to the content model for
    <named-content>:
       - %block-display.class;
       - %block-math.class;
       - %emphasized-text;
       - %inline-display.class;
       - %list.class;
       - %rest-of-para.class;
    Rationale: To expand content model of <named-content> to 
    encompass most of the other phrase-level structures, which
    will allow preservation of phrase-level semantic information
    in content converted to this format.

 2. Added ID attribute to parameter entity %named-content-atts;  
    Rationale: Provide unique identifier so <named-content>
    element can be linked to. 

 1. Added ID attribute to element <abbrev>. 
    Rationale: Provide unique identifier so <abbrev> element 
    can be linked to. 
                                                                  -->

<!– ============================================================= –> <!– PARAMETER ENTITY DEPENDENCIES

Requires that the following parameter 
entities be defined before calling this
module, usually accomplished in the 
Customization Module for the specific DTD:
  - %might-link-atts;  
                                           -->

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

<!– ABBREVIATION ATTRIBUTES –> <!– Attributes for the <abbrev> element –> <!ENTITY % abbrev-atts

"id         ID                                 #IMPLIED
 content-type
            CDATA                              #IMPLIED
 %might-link-atts;"                                     >

<!– NAMED CONTENT ATTRIBUTES –> <!– Attributes for the <milestone-start> and

<milestone-end> elements                   -->

<!ENTITY % milestone-atts

"id         ID                                 #IMPLIED  
 rationale  CDATA                              #IMPLIED
 rid        IDREF                              #IMPLIED" >

<!– NAMED CONTENT ATTRIBUTES –> <!– Attributes for the <named-content> element –> <!ENTITY % named-content-atts

"content-type   
            CDATA                            #REQUIRED 
 id         ID                                #IMPLIED
 %might-link-atts;"                                      >

<!– ============================================================= –> <!– PHRASE-LEVEL ELEMENTS –> <!– ============================================================= –>

<!– ABBREVIATION ELEMENTS –> <!– Elements for use in the <abbrev> element –> <!ENTITY % abbrev-elements

"| %def.class;"                              >

<!– ABBREVIATION OR ACRONYM –> <!– Used to identify an abbreviation or acronym

DTD Design Note: We have not seen this much 
in the world of STM journal publishing.
This element was added explicitly to
meet "Checkpoint 4.3[3.5] Annotate complex, 
abbreviated, or unfamiliar information with 
summaries and definitions" from the W3C Web
Content Accessibility Guidelines 2.0.
Remarks: The linking attributes can be used
to provide a live link to an expansion,
definition, or additional explanation.     -->

<!ELEMENT abbrev (#PCDATA %abbrev-elements;)* > <!– id Unique identifier so the element may be

           referenced                                 
content-type
           "type" attributes provide a way to preserve
           or add semantic distinctions, for example,
           saying that this <abbrev> is an acronym.
xlink:href Provides an address or identifier of the
           object to which the link points, for
           example a URI or a filename                -->

<!ATTLIST abbrev

%abbrev-atts;                                           >

<!– MILESTONE MODEL –> <!– Model for the both the <milestone-start> and

<milestone-end> elements                   -->

<!ENTITY % milestone-model

"EMPTY"                                      >

<!– MILESTONE START –> <!– Used to mark the start of a non-hierarchically

nested object, that is, a textual component
which cannot be expressed in the normal 
non-overlapping, OCHO structure of an XML
document. When this element is used, it is
assumed that the end of the textual
component will be marked with a 
<milestone-end> element.                   -->

<!ELEMENT milestone-start

%milestone-model;                            >

<!– id Unique identifier so the element may be

           referenced                                 
rationale  Why does this milestone exist or what object
           cannot be modeled using the regular hierarchy?
           Best Practice Note: Although the DTD does 
           not require, this should be treated as a
           required attribute and a value always 
           provided when milestones are used.
rid        Pointer to the corresponding <milestone>   -->

<!ATTLIST milestone-start

%milestone-atts;                                        >

<!– MILESTONE END –> <!– Used to mark the end of a non-hierarchically

nested object, that is, a textual component
which cannot be expressed in the normal 
non-overlapping, OCHO structure of an XML
document. When this element is used, it is
assumed that the start of the textual
component was marked with a <milestone-start>
element.                                   -->

<!ELEMENT milestone-end

%milestone-model;                            >

<!– id Unique identifier so the element may be

           referenced                                 
rationale  Why does this milestone exist or what object
           cannot be modeled using the regular hierarchy?
           Best Practice Note: Although the DTD does 
           not require, this should be treated as a
           required attribute and a value always 
           provided when milestones are used.
rid        Pointer to the corresponding <milestone>   -->

<!ATTLIST milestone-end

%milestone-atts;                                        >

<!– NAMED CONTENT ELEMENTS –> <!– The elements that can be included along with

data characters inside the content model of
the <named-content> element                -->

<!ENTITY % named-content-elements

"| %address-link.class; |
 %article-link.class; |
 %block-display.class; | %block-math.class;|
 %emphasis.class;  | %inline-math.class; | 
 %inline-display.class; | 
 %list.class; | %math.class; | 
 %phrase.class; | %simple-link.class; | 
 %subsup.class; |  %rest-of-para.class;"     >

<!– NAMED SPECIAL (SUBJECT) CONTENT –> <!– A word or phrase within the text that should

be treated differently, often given a
special typographic style or look, because
the content/subject matter is distinct. For
example, the word is a drug name or a 
gene or the phrase identifies an organism 
genus/species.                             -->

<!ELEMENT named-content

(#PCDATA %named-content-elements;)*          >

<!– content-type

                       Identification of the subject or type of
                       content that makes this word or phrase
                       semantically special, usually to be treated 
                       differently, for example, given a different 
                       look in print or display.
                          As an example, this attribute could be 
                       used to identify a drug name, company name, 
                       or product name.  It could be used to define 
                       systematics terms such as genus, family, 
                       order,  or suborder. It could be used to 
                       identify biological components such as 
                       gene, protein, or peptide. Therefore 
                       values may include information classes, 
                       semantic categories, or types of nouns, 
                       such as "generic-drug-name", "genus-species",
                       "gene", "peptide", "product", etc.  
            id         Unique identifier so the element may be
                       referenced                                 
            xlink:href Provides an address or identifier of the
                       object to which the link points, for
                       example a URI or a filename                --> 
<!ATTLIST  named-content
            %named-content-atts;                                    >

<!– ================== End Phrase Class Module ================== –>