WG8 DTD documentation.
This document is available as a Word 6 file (dtddoc.doc) or ASCII text (README)

General Organization

This DTD is derived from the Oak Ridge Technical Report DTD. It also uses the math section from 
the ISO/IEC TR9573-11 DTD and the CALS Tables subset.
The WG8 document has a traditional <front><body><back> organization.

Front Matter

The <front> element of a WG8 document begins with a <titleblock> containing specialized 
frontmatter required by SC18 and JTC1 rules, followed by optional material from typical technical 
documents:

front		titleblk , (acknowl? & abstract? & (preface | foreword)? & 
		(execsum | summary)? & recommen?)

titleblock	docnum , revision? , title , source , project , projedit , status , action , 
		date, distrib , summary? , referto , supersed , replyto


The titleblock elements have the following semantics and content:

docnum		WG8 number of this document			#PCDATA

revision		Optional REV, REV2, etc.			#PCDATA

title		Document title					%text (i.e., almost anything)

source		Originator of document (e.g., WG8, an editor)	#PCDATA

project		JTC1 project number (or "All WG8 projects)	#PCDATA

projedit		Project editor					#PCDATA

status		Status of paper (e.g., "Draft", "Approved Liaison"	#PCDATA | p+

action		Requested action (e.g., "For information)		#PCDATA | p+

date		Date of document				#PCDATA

distrib		Distribution (typically "WG8 and liaisons")		#PCDATA | p+

summary	Optional summary of major points			p+

referto		Other documents (by number) referred to		#PCDATA | p+

supersed		Documents (by number) superseded by this one	#PCDATA | p+

replyto		Normally the convenor (&convenor;)		#PCDATA 


The rest of the <front> elements (which will probably be used very rarely) have the general model 
"p+".

Body

The body has the model "title? , abstract? , sect1+ , (referenc | bibliog)?". "Title" and "abstract" are 
as above. "Referenc" and "bilbiog", for reference lists or bibliographies, consist of a title followed by a 
complex list of optional elements of a bibliographic citation. The rest of the body consists of hierarchical 
sections:

<!ELEMENT  sect1  - O  (title , ((p+ , (sect2 , sect2+)?) | (sect2, 
		sect2+)) , (referenc | bibliog)? , appendix*)>
<!ATTLIST  sect1
            id          ID     #IMPLIED 
            rev-date    CDATA  #IMPLIED >

The bulk of the body is paragraphs:

<!ELEMENT p  - O (%paratxt;)   -- paragraphs -->

<!ENTITY % paratxt "(%text | %floats | %list | (df | dfg | math) | 
	%sppara)*"  -- paragraph text, "df" for sgml-tagged display formula, 
	"math" for displayed formula in TeX -->

<!ENTITY % text "(#PCDATA | acro-defn  | chem | citation | computer-
		code | emphasis | (f | eqn) | ftnote  | keyword | %crosref | q | 
		supscrpt | subscrpt | variable | refer)*"     -- text items, (use f 
		for sgml-tagged formula,eqn for formula in TeX notation) -->

The rest of the text items are other typical text components:

<!ENTITY % sppara "warning | caution | note | disclaim | precaut | 
		sptext"      -- special paragraphs -->

<!ENTITY % list "(list | deflist | steps) "           -- lists -->

<!ENTITY % floats "graphic | figure | table | exhibit " >

Lists are simple:

<!ELEMENT list   - -    (title? , (item , item+)) >

<!ATTLIST list
                prefix     (alpha | numeric |
                 bullet | dash | none)      #IMPLIED >

<!ELEMENT item   - O    ((%text; , (%list;)?) | p+) >

<!ATTLIST item
                id           ID               #IMPLIED
                label        CDATA               #IMPLIED >

<!ELEMENT deflist   - -    (term ,  def)+    -- definition list -->

A special function of use to WG8 writers is the handling of acronyms and references to them:

<!ELEMENT acronym   - -    (#PCDATA) >

<!ELEMENT  acro-defn  - -    (acronym , def+) >
<!ATTLIST  acro-defn 
                ID  ID  #IMPLIED >
<!ELEMENT (acro-ref)     - O  (#PCDATA)     >

<!ATTLIST (acro-ref)
                idref    IDREFS     #CONREF  >  

That is, while it is possible to put data in a reference to an acronym, the preferred processing is to 
supply an idref value to link back to the definition. In most cases, the id/idref can be the actual acronym. 
SoftQuad Panorama can display the attribute value and follow the link. The Oak Ridge publishing 
application actually compiles acronym lists and supplies the acronym from the defenition.




Components of the DTD:
The following are portions of the SGML Open Catalog file for the DTD:
General Document Structure
PUBLIC "-//ISO IEC JTC1 SC18 WG8//DTD Committee Paper//EN"  
	"wg8.dtd"
PUBLIC "-//Martin Marietta Energy Systems//DTD Entities//EN" 
	"entities.dtd"
PUBLIC -//ISO IEC JTC1 SC18 WG8//DTD General Elements//EN" 
	"wg8gen.dtd"
PUBLIC  "-//Martin Marietta Energy Systems//DTD Sections//EN" 
	"sections.dtd"
PUBLIC  "-//Martin Marietta Energy Systems//DTD Lists//EN" 
	"lists.dtd"
PUBLIC  "-//Martin Marietta Energy Systems//DTD Math//EN" 
	"math.dtd"
PUBLIC  "-//Martin Marietta Energy Systems//DTD Chemistry//EN" 
	"chem.dtd"
PUBLIC "-//USA-DOD//ELEMENTS CALS Table//EN"
       "calstbl.ent"
PUBLIC  "-//Martin Marietta Energy Systems//DTD Procedural 
Steps//EN" 
	"steps.dtd"
Character entities
These files 
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN//HTML" 
	"iso-lat1.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN"
       "iso-lat1.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 2//EN"
       "iso-lat2.ent"
PUBLIC "ISO 8879-1986//ENTITIES Numeric and Special Graphic//EN"
       "iso-num.ent"
PUBLIC "ISO 8879-1986//ENTITIES Publishing//EN"
       "iso-pub.ent"
PUBLIC "ISO 8879-1986//ENTITIES Greek Symbols//EN"
       "iso-grk3.ent"
PUBLIC "ISO 8879-1986//ENTITIES Diacritical Marks//EN"
       "iso-dia.ent"
PUBLIC "ISO 8879-1986//ENTITIES General Technical//EN"
       "iso-tech.ent"
PUBLIC "ISO 8879-1986//ENTITIES Russian Cyrillic//EN"
       "iso-cyr1.ent"
PUBLIC "ISO 8879-1986//ENTITIES Non-Russian Cyrillic//EN"
       "iso-cyr2.ent"
PUBLIC "ISO 8879-1986//ENTITIES Greek Letters//EN"
       "iso-grk1.ent"
PUBLIC "ISO 8879-1986//ENTITIES Monotoniko Greek//EN"
       "iso-grk2.ent"
PUBLIC "ISO 8879-1986//ENTITIES Box and Line Drawing//EN"
       "iso-box.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Math Symbols: Arrow 
Relations//EN"
       "iso-amsa.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Math Symbols: Negated 
Relations//EN"
       "iso-amsn.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Math Symbols: Binary 
Operators//EN"
       "iso-amsb.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Math Symbols: Relations//EN"
       "iso-amsr.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Math Symbols: Delimiters//EN"
       "iso-amsc.ent"
PUBLIC "ISO 8879-1986//ENTITIES Added Math Symbols: Ordinary//EN"
       "iso-amso.ent"

