<!– ============================================================= –> <!– MODULE: Section Class Elements –> <!– VERSION: 1.0 –> <!– DATE: December 2002 –> <!– –> <!– ============================================================= –>

<!– ============================================================= –> <!– PUBLIC DOCUMENT TYPE DEFINITION –> <!– TYPICAL INVOCATION –> <!– “-//NLM//DTD Archiving and Interchange DTD Suite Section Class Elements v1.0 20021201//EN”

Delivered as file "section.ent"                               -->

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

<!– ============================================================= –> <!– SYSTEM: Archiving and Interchange DTD Suite –> <!– –> <!– PURPOSE: Defines the member of the sec.class, that is, –> <!– names all section-level elements in the –> <!– Archiving and Interchange DTD Suite –> <!– –> <!– At the time of the initial DTD creation –> <!– there is only one such element, Section itself –> <!– <sec>, but future expansion to named sections –> <!– (such as <methodology> or <materials> or any –> <!– new section-level structures would be added here. –> <!– –> <!– CONTAINS: 1) Default definition of the section class –> <!– 2) Defaults for attribute lists –> <!– 3) Section <sec> –> <!– –> <!– 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 VERSIONCHANGE HISTORY –> <!– ============================================================= –> <!–

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

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

-->

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

Requires the following parameter entities
be defined before calling this module. 
The content-model Parameter Entities are
defined in %common.ent; but may be
redefined in the Customization Module for
the specific DTD:
  %sec-model; - Content model for section-like 
                elements  
                                           -->

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

<!– ============================================================= –> <!– DEFAULT DEFINITION OF THE LINK CLASS –> <!– ============================================================= –>

<!– SECTION CLASS ELEMENTS –> <!– Information for the reader that is at the

same structural level as a Section, which is
a headed structure full of smaller elements
such as paragraphs.                        -->

<!ENTITY % sec.class “sec” >

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

<!– SECTION ATTRIBUTES –> <!– Attribute list for Section element –> <!ENTITY % sec-atts

"id         ID                                 #IMPLIED
 xml:lang   NMTOKEN                            #IMPLIED
 sec-type   CDATA                              #IMPLIED 
 disp-level CDATA                              #IMPLIED" >

<!– ============================================================= –> <!– SECTION ELEMENTS –> <!– ============================================================= –>

<!– SECTION –> <!– A headed group of material; the basic

structural unit of the article             -->

<!ELEMENT sec (%sec-model;) > <!– id Unique identifier, so the Section can be

           referenced                   
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). 
sec-type   Conversion Note: This attribute may be used
           to retain information on the semantic
           content of a section where that is known.
           Authoring Note: Top-level sections (those 
           that are not nested inside other sections)
           may be assigned a "type" attribute for 
           indexing purposes. This attribute should be
           used only if the section is one of the listed
           types and should otherwise be omitted. A
           section that contains content of more than 
           one type should have the type IDs combined.
           (e.g., "Materials and Methods" would be
           type="materials|methods").  
           Types values are:         
             intro     Introduction/Synopsis
             materials Materials
             methods   Methods/Methodology/Procedures
             subjects  Patients/Participants/Subjects
             cases     Cases/Case Reports
             results   Results/Statement of Findings
             discussion  Discussion/Interpretation
             conclusions Conclusions/Comment
disp-level Sometimes in print or on screen, the display
           or apparent hierarchical level of a section
           is not the same as its real position in the
           hierarchy.  For example, in some styles,
           the "Clinical Finding" Section or the 
           'Methodology" Section always looks like a 
           particular level heading (say a level 2 head),
           wherever it falls in the hierarchy (say a 
           level 1 head or a level 3 head). This
           attribute can be used to record the needed
           display level. (Rare)                      -->

<!ATTLIST sec

%sec-atts;                                              >

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