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