xml_jats_resolver 0.0.1

data/lib/dtd/archiving_dtd/2.1/dtd/ArchiveReadme.txt

@@ -0,0 +1,283 @@
+DELIVERY LETTER FOR THE DRAFT ARCHIVING AND INTERCHANGE DTD
+               (Archiving (Green) Version 2.1 June 30, 2005)
+
+                                               September 2005
+
+------------------------------------------------------
+
+This README describes:
+
+   1.0 The Archiving DTD Version 2.1
+   2.0 Files in this delivery:
+       2.1  Catalog Files
+       2.2  Modules Specific to the NLM Journal Archiving DTD
+       2.3  DTD Suite: Critical Base Modules
+       2.4  DTD Suite: Element Class Modules
+       2.5  DTD Suite: Math Modules 
+       2.6  DTD Suite: Table Modules
+       2.7  DTD Suite: Notations and Special Characters
+       2.8  Sample files for testing
+
+------------------------------------------------------
+
+1.0 ARCHIVING (GREEN) DTD VERSION 2.1 JUNE 2005
+
+
+In Version 2.1, the Archiving (Green) DTD and the Archiving
+and Interchange DTD Suite modules were modified to: 
+  * Use the latest (spring 2005) W3C MathML DTD;
+  * Use the latest (spring 2005) W3C MathML sets of general 
+      character entities;
+  * Make changes requested by the AIT Working Group; and
+  * Fix typos, alignment errors, element order in parameter 
+    entities, and miscellaneous infelicities of the wording
+    in comments.
+
+Implementor's Note: The new collections of general entities 
+have a new directory structure! There are two new directories,
+iso8879 and iso9573-13, as well as the character set 
+directory, xmlchars.
+
+------------------------------------------------------
+
+2.0 FILES IN THIS DELIVERY
+
+------------------------------------------------------
+
+2.1 Catalog Files
+
+These files are not part of the DTD Suite proper, but 
+are provided as a convenience to implementors.
+
+catalog-v2.xml - XML catalog made according to the
+                 OASIS DTD Entity Resolution XML Catalog V2.1
+"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"
+
+
+catalog.ent - OASIS SOCAT catalog of the fpi and file names.
+              This is the old style OASIS catalog, similar to
+              SGML catalogs.
+                           
+------------------------------------------------------
+2.2 Modules Specific to the NLM Journal Archiving DTD
+
+archivearticle.dtd          
+             - Main DTD for NLM Journal Archiving DTD;
+               this is the DOCTYPE that covers a journal
+               article and various other non-article
+               journal content such as book and product 
+               reviews. This DTD invokes almost all the 
+               modules in the NLM Archiving and Interchange
+               DTD Suite.
+
+archivecustom-modules.ent 
+             - Names all new modules created specifically
+               for this DTD (therefore not part of the
+               base DTD Suite)
+               
+               This module must be called as the first 
+               module in the DTD, just before the Suite 
+               Module of Modules %modules.ent;, which it
+               supplements.
+
+archivecustom-classes.ent
+             - The DTD-specific class definitions for the 
+               this DTD. Used to over-ride the Suite
+               default classes.
+               
+               Declared in %archivecustom-modules.ent;
+               Must be invoked before the default classes
+               module.
+
+archivecustom-mixes.ent
+             - The DTD-specific mix definitions for the 
+               this DTD. Used to over-ride the Suite
+               default mixes.
+               
+               Declared in %archivecustom-modules.ent;
+               Must be invoked before the default mixes
+               module.
+
+archivecustom-models.ent
+             - The DTD-specific content model definitions 
+               for this DTD. Used to over-ride the Suite
+               default models.
+               
+               Declared in %archivecustom-modules.ent;
+               Must be invoked before all of the DTD Suite
+               modules since it is used to over-ride them.
+            
+               There are two types of such over-rides. Those 
+               that replace a complete content model are
+               named with a suffix "-model". Those that are 
+               OR-groups of elements (intended to be mixed 
+               with #PCDATA inside a particular model) are 
+               named with an "-elements" suffix.
+
+------------------------------------------------------
+
+2.3 DTD Suite: Critical Base Modules
+
+modules.ent      - Names all the modules in the NLM 
+                   Archiving and Interchange DTD Suite
+                                      
+                   Must be called as the second module
+                   by any DTD, after the DTD-specific module
+                   of modules (if any) and before all other 
+                   modules.
+                   
+                   NOTE: May name modules (such as the 
+                   OASIS-Exchange module) that are not called 
+                   by a particular DTD.
+
+common.ent       - Defines all elements, attributes, entities
+                   used by more than one module
+                   
+                   Called after all module-of-modules modules
+                   and all customization (over-ride) modules
+                   but before all the class modules. 
+
+These modules need to be invoked before all other modules 
+in a DTD. Other modules can usually be invoked in any order.
+They are listed below alphabetically.
+
+
+------------------------------------------------------
+
+2.4 DTD Suite: Element Class Modules 
+               (Define elements, attributes for one class)
+
+articlemeta.ent  - Article-level metadata elements 
+backmatter.ent   - Article-level back matter elements
+display.ent      - Display elements such as Table, Figure, Graphic
+format.ent       - Format-related elements such as Bold
+journalmeta.ent  - Journal-level metadata elements
+link.ent         - Linking elements such as X(Cross)-Reference
+list.ent         - List elements
+math.ent         - NLM-defined math elements such as Display Equation
+para.ent         - Paragraph-level elements such as Paragraph and
+                      Block Quote
+phrase.ent       - Phrase-level content-related elements
+references.ent   - Bibliographic reference list and the elements
+                      that can be used inside a citation
+section.ent      - Section-level elements
+
+
+------------------------------------------------------
+
+2.5 DTD Suite: Math Modules 
+               (Define MathML tagging, used in %math.ent;)
+
+These modules are defined in the Suite and should be invoked
+from the DTD if MathML tagging is desired.
+
+mathmlsetup.ent  - DTD Suite module that sets the parameter
+                   entities for the MathML modules
+
+The top-level MathML modules:
+  mathml2.dtd
+  mathml2-qname-1.mod
+
+And inside the mathml subdirectory:
+  mmlalias.ent
+  mmlextra.ent
+
+ 
+------------------------------------------------------
+
+2.6 DTD Suite: Table Modules 
+               (Define XHTML Table Model)
+
+These modules are defined in the Suite and should be invoked
+from the DTD if table tagging is desired.
+
+XHTML Table Model
+  XHTMLtablesetup.ent
+  htmltable.dtd
+
+
+------------------------------------------------------
+
+2.7 DTD Suite: Notations and Special Characters
+
+notat.ent        - Names all Notations used
+
+chars.ent        - Defines NLM-specific and custom special
+                   characters (as general entities defined
+                   as hexadecimal or decimal character
+                   entities [Unicode numbers] or by using
+                   the <private-char> element).
+
+xmlspecchars.ent - Names all the standard special character
+                   entity sets to be used by the DTD. The
+                   MathML characters sets were used,
+                   unchanged, in the same directory
+                   structure used for MathML.
+
+All the MathML special character entity sets:
+
+(inside the iso8879 subdirectory)
+  isobox.ent
+  isocyr1.ent
+  isocyr2.ent
+  isodia.ent
+  isolat1.ent
+  isolat2.ent
+  isonum.ent
+  isopub.ent
+
+(inside the iso9573-13 subdirectory)
+  isoamsa.ent
+  isoamsb.ent
+  isoamsc.ent
+  isoamsn.ent
+  isoamso.ent
+  isoamsr.ent
+  isogrk3.ent
+  isomfrk.ent
+  isomopf.ent
+  isomscr.ent
+  isotech.ent
+
+Special character entity sets NOT used in MathML
+(included as part of the DTD for backwards compatibility)  
+
+(inside the xmlchars subdirectory)
+  isogrk1.ent
+  isogrk2.ent
+  isogrk4.ent
+ 
+ 
+------------------------------------------------------
+
+2.8 Sample files for testing Green (Archiving)
+
+samplesmall-archive.xml - Minimal document used to test the 
+                          archiving DTD
+
+sample-archive-mathml   - Minimal document used to test the 
+                          MathML modules as used by Green
+                       
+-------------  document end -------------------------------
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

data/lib/dtd/archiving_dtd/2.1/dtd/XHTMLtablesetup.ent

@@ -0,0 +1,320 @@
+<!-- ============================================================= -->
+<!--  MODULE:    XHTML Table Setup Module                          -->
+<!--  VERSION:   2.1                                               -->
+<!--  DATE:      June 2005                                         -->
+<!--                                                               -->
+<!-- ============================================================= -->
+
+<!-- ============================================================= -->
+<!--                    PUBLIC DOCUMENT TYPE DEFINITION            -->
+<!--                        TYPICAL INVOCATION                     -->
+<!--
+"-//NLM//DTD Archiving and Interchange DTD Suite XHTML Table Setup Module v2.1 20050630//EN"
+     Delivered as file "XHTMLtablesetup.ent"                       -->
+<!-- ============================================================= -->
+
+<!-- ============================================================= -->
+<!-- SYSTEM:     Archiving and Interchange DTD Suite               -->
+<!--                                                               -->
+<!-- PURPOSE:    Provides the organization for using the XHTML 1.1 -->
+<!--             table model                                       -->
+<!--                                                               -->
+<!-- CONTAINS:   1) Overrides to standard parameter entities used  -->
+<!--                in the XHTML 1.1 table model                   -->
+<!--             2) Call to XHTML 1.1 table model                  -->
+<!--                                                               -->
+<!-- MODULES REQUIRED:                                             -->
+<!--             1) htmltable.dtd        XHTML 1.1 table model     -->
+<!--                                                               -->
+<!-- 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.1                       (DAL/BTU) v2.1 (2005-06-30)
+          
+     Changed to MathML 2.0 and MathML 2.0 Character Sets
+     Added new material requested by NCBI   
+          
+  6. Minor, non-functional changes to wording in comments as part 
+     of 2.1 release.
+          
+  5. Updated public identifier to "v2.1 20050630" 
+
+     =============================================================
+     Version 2.0                       (DAL/BTU) v2.0 (2004-07-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
+          
+  4. Updated public identifier to "v2.0 20040830"          
+
+     =============================================================
+     Version 1.1                           (TRG) v1.1 (2003-11-01)
+
+  3. Added attribute "alternate-form-of" to <table> 
+     (by modifying parameter entity %Common.attrib;)
+     Rationale: Where multiple formats of an item (e.g., graphic 
+     file, media object, chemical structure) are available, this 
+     attribute indicates that a format is a secondary one and 
+     provides a link to the primary format, so that only one 
+     format of an item is displayed.
+     
+  2. Added attribute "id" information to parameter entity 
+     %Common-attrib;  
+     Rationale: Provide unique identifier so these elements can be 
+     linked to, especially for one version of a table to be linked 
+     to by alternate versions of the same table.
+      
+  1. Added attribute "content-type" information to <table> 
+     (by modifying parameter entity %Common.attrib;)     
+     Rationale: To identify and preserve the semantic intent of 
+     semantically rich source documents.
+                                                                   -->
+
+
+<!-- ============================================================= -->
+<!--                    PARAMETER ENTITY DEPENDENCIES             
+                        Requires the following parameter entities
+                        be defined before calling this module, 
+                        usually accomplished in the Customization
+                        Module for the specific DTD:
+                          %inside-cell; 
+                                                                   -->
+<!-- ============================================================= -->
+                                                                   
+                                                                   
+<!-- ============================================================= -->
+<!--                    SET UP FOR THE XHTML 1.1 TABLE MODULE      -->
+<!-- ============================================================= -->
+                                                                   
+                                                                   
+<!-- ============================================================= -->
+<!--                    DEFAULTS FOR TABLE ELEMENT NAMES           -->
+<!-- ============================================================= -->
+
+
+<!ENTITY % table.qname  "table"                                      >
+<!ENTITY % caption.qname  
+                        "caption"                                    >
+<!ENTITY % thead.qname  "thead"                                      >
+<!ENTITY % tfoot.qname  "tfoot"                                      >
+<!ENTITY % tbody.qname  "tbody"                                      >
+<!ENTITY % colgroup.qname  
+                        "colgroup"                                   >
+<!ENTITY % col.qname    "col"                                        >
+<!ENTITY % tr.qname     "tr"                                         >
+<!ENTITY % th.qname     "th"                                         >
+<!ENTITY % td.qname     "td"                                         >
+                                                                   
+                                                                   
+<!-- ============================================================= -->
+<!--                    DEFAULTS FOR DATATYPE PARAMETER ENTITIES   -->
+<!-- ============================================================= -->
+
+
+<!ENTITY % Text.datatype  
+                        "CDATA"                                      >
+
+
+<!ENTITY % Number.datatype  
+                        "CDATA"                                      >
+
+
+<!ENTITY % MultiLength.datatype
+                        "CDATA"                                      >
+
+
+<!ENTITY % Length.datatype
+                        "CDATA"                                      >
+
+
+<!ENTITY % Pixels.datatype
+                        "CDATA"                                      >
+
+
+<!ENTITY % Character.datatype
+                        "CDATA"                                      >
+                                                                   
+                                                                   
+<!-- ============================================================= -->
+<!--                    DEFAULTS FOR ATTRIBUTE PARAMETER ENTITIES  -->
+<!-- ============================================================= -->
+
+
+<!--         alternate-form-of
+                        Where multiple formats of an item (e.g., 
+                        graphic file, media object, chemical 
+                        structure) are available, this attribute 
+                        indicates that a format is a secondary 
+                        one and provides a link to the primary 
+                        format, so that only one format of an
+                        item is displayed.
+             content-type   
+                        Identification of the subject, type of
+                        content, or reason that this word or phrase
+                        is considered semantically special, as a 
+                        means of preserving the semantic intent of 
+                        the original tagging.       
+             id         Unique identifier so that the table can
+                        be referenced                              -->
+<!ENTITY % Common.attrib
+              "alternate-form-of
+                        IDREF                             #IMPLIED
+               content-type
+                        CDATA                             #IMPLIED
+               id       ID                                #IMPLIED"  >
+                                                                   
+                                                                   
+<!-- ============================================================= -->
+<!--                    OVER-RIDES TO REMOVE CAPTION               -->
+<!-- ============================================================= -->
+
+
+<!--                   CAPTION FOR A TABLE                         -->
+<!--                   Modification of the standard XHMTL model    
+                       Removed the definition of caption, so the
+                       element would not be multiply defined       -->
+<!ENTITY % caption.element  
+                       "IGNORE"                                      >
+                                                                   
+                                                                   
+<!-- ============================================================= -->
+<!--                    OVER-RIDES FOR CONTENT PARAMETER ENTITIES  -->
+<!-- ============================================================= -->
+
+
+<!--                   INLINE ELEMENTS                             -->
+<!--                   Modification of the standard XHMTL model     
+                       for inline elements used in the <caption>
+                       Set to the null because the <caption>
+                       element is now inside the table wrapper,
+                       not inside the table, as the original XHTML
+                       table intended                              -->
+<!ENTITY % Inline.mix  ""                                            >
+
+
+<!--                   CONTENTS OF A TABLE CELL                    -->
+<!--                   Modification of the standard XHMTL model
+                       used for the content of tables cells <th>
+                       and <td>                                    -->
+<!ENTITY % Flow.mix    "%inside-cell;"                               >
+
+
+<!--                   CONTENTS OF A TABLE                         -->
+<!--                   Modification of the standard XHMTL model    
+                       This has been modified from the XHTML model
+                       to remove the <caption> element from the
+                       <table> model, since in the Archiving and
+                       Interchange DTD Suite modular library, the 
+                       <caption> element is part  of the Table Wrapper 
+                       <table-wrap> element. No other changes were 
+                       made to the XHTML table content model.      -->
+<!ENTITY % table.content
+     "( ( %col.qname;* | %colgroup.qname;* ),
+        ( ( %thead.qname;?, %tfoot.qname;?, %tbody.qname;+ ) | 
+          ( %tr.qname;+ ) 
+        ) 
+      )"                                                             >
+ 
+
+<!-- ============================================================= -->
+<!--                    THE XML TABLE INVOCATION                   -->
+<!-- ============================================================= -->
+
+
+<!--                    XHTML TABLE MODEL                          -->
+<!--                    This module declares element types and 
+                        attributes used to provide table markup 
+                        similar to HTML 4, including features that 
+                        enable better accessibility for non-visual 
+                        user agents. This is the XHTML reformulation 
+                        of HTML as a modular XML application. 
+                        Copyright 1998-2001 W3C (MIT, INRIA, Keio), 
+                        All Rights Reserved.
+                        Revision: $Id: xhtml-table-1.mod,v 4.1 
+                        2001/04/10 09:42:30 altheim Exp $ SMI, using
+                        SYSTEM identifier:
+"http://www.w3.org/TR/xhtml-modularization/DTD/xhtml-table-1.mod"
+                                                                   -->
+%htmltable.dtd;
+
+
+<!-- ================== End XHTML Table Setup Module ============= -->