README.TXT March 2003

This README names the modules delivered as Version 1.0 of the Journal Publishing DTD, including the necessary portions of Version 1.0 of the Archiving and Interchange DTD Suite.

The rest of this README contains notes concerning:

1.0 File Names
2.0 Modules Specific to the Journal Publishing DTD
3.0 Archiving and Interchange DTD Suite Modules Used
      in this DTD
    3.1 Element Class Modules
    3.2 Math Modules 
    3.3 Table Modules
    3.4 Notations and Special Characters

1.0 File Names

catalog.ent - OASIS SOCAT catalog of the formal public

identifier (fpi) and file names for each
DTD and module.
Not part of the DTD or the Suite proper, but 
used to implement a system using the suite.

2.0 Modules Specific to the Journal Publishing DTD

journalpublishing.dtd

- The DTD file for the Journal Publishing 
  DTD. The DOCTYPE in this DTD 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 Archiving 
  and Interchange DTD Suite, changing their
  element contents and attributes as necessary
  using the Customization module

journalpubcustomize.ent

- The customization module. This is the
  secondary DTD module that, with the DTD
  itself, makes up the Journal Publishing
  DTD. This module defines the classes, 
  mixes, and Parameter Entities for 
  this specific journal authoring and first
  XML tagging DTD. (Called as the second 
  module in the DTD, after the module that 
  names the modules, modules.ent.)

3.0 Archiving and Interchange DTD Suite Modules Used

in this DTD

modules.ent - Names all the modules in the

Archiving and Interchange DTD Suite.
(Called as the first module by
the Journal Publishing DTD.)

common.ent - Defines all elements, attributes,

entities, attribute values that are
used by more than one module in the
full Suite. (Called as the third 
module by the Journal Publishing DTD.)

These modules are invoked before all other modules in this DTD. Other modules can usually be invoked in any order, and are invoked in alphabetical order.


3.1 Element Class Modules (define elements, attributes

for a single element 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 - Suite-defined math elements such as

Display Equation

para.ent - Paragraph-level elements such as

Paragraph and Display 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


3.2 Math Modules (Define MathML tagging, used in math.ent)

mathml2.dtd mathmlsetup.ent

And inside the mathml subdirectory:

mathml2-qname-1.mod
mmlalias.ent
mmlextra.ent

3.3 Table Modules (Define XHTML Table Model)

Using the XHTML table model requires two modules: one to set up the Parameter Entities necessary to use the model, and the second to define the table model itself (as defined publicly).

Archiving and Interchange DTD Suite version (no namespaces) of the XHTML Table Model

XHTMLtablesetup.ent (setup module)
htmltable.dtd       (PUBLIC module)

3.4 Notations and Special Characters

notat.ent - Names all notations used xmlspecchars.ent - Names all the standard special character

entity sets to be used by the DTD. The
MathML characters sets were used,
unchanged

chars.ent - Definitions of DTD-specific and custom

special characters (as general entities
defined as hexadecimal or decimal character
entities - Unicode numbers or using the
<private-char> element.)

All the MathML special character entity sets (inside the xmlchars subdirectory)

isoamsa.ent
isoamsb.ent
isoamsc.ent
isoamsn.ent
isoamso.ent
isoamsr.ent
isobox.ent
isocyr1.ent
isocyr2.ent
isodia.ent
isogrk1.ent
isogrk2.ent
isogrk3.ent
isogrk4.ent
isolat1.ent
isolat2.ent
isomfrk.ent
isomopf.ent
isomscr.ent
isonum.ent
isopub.ent
isotech.ent

———— document end —————————-