ISO/IEC TR 9573-11:2003
2nd edition

ISO/IEC JTC 1/SC34 N0427

Information technology — Document Description and Processing Languages — Structure Descriptions and Style Specifications for Standards Document Interchange

Table of Contents

Forword

Introduction

1. Scope

2. References

3. Approach to the harmonized set of ISO DTDs

3.1 Document flow (standards only)

3.2 Required DTDs

3.3 Guidelines for harmonization of DTD

3.4 General guidelines

3.5 Technical approach

3.6 Examples

4. Architecture of Standards

4.1 General considerations

4.2 Normative or informative

4.3 Not "All inside all"

5. Element types description for base DTD

5.1 General convention for element types

5.2 General convention for attributes

5.3 The top-level structure of a standard

5.4 Nested subdivisions of text

5.5 Displayed components

5.6 Terminology

5.7 Inline components

5.8 Referential components

5.9 Float components

5.10 Very specific components

5.11 Possible extensions of the DTD

6. Profile

6.1 Introduction

6.2 Architecture

6.3 Boilerplate text support

6.4 Conclusions

7. Master entity dictionary

7.1 General

7.2 Overall structure

7.3 Base and local groups

7.4 Content models

7.5 Attributes modification

7.6 Modification of formulae component

7.7 Modification of figure component

7.8 Modification of table component

8. Derivation of DTDs from the base DTD

9. Authoring DTDs

9.1 Authoring DTD for native SGML tools

9.2 Authoring DTD for word processors

9.3 Use of HTML for standards development

10. All public entities

11. XML DTD

11.1 XMLization

11.2 Modularization

11.3 Non-ISONET base description

 

Annex A Example of terminology in SGML (informative)

Annex B Example of terminology presentation (informative)

Annex C SGML DTDs (informative)

Annex D XML DTD Modules (informative)

Annex E Schema module by RELAX NG (ISO/IEC 19757-2) (informative)

Annex F XSLT specification for translation to HTML (informative)

Annex G XSL specification for rendering an XML instance (informative)

Annex H DSSSL (ISO/IEC 10179) specification for rendering an SGML instance (informative)

Foreword

ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Committee) together form a system for worldwide standardization as a whole. National bodies that are members of ISO or IEC participate in the development of International Standards through technical committees established by the respective organizations to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, governmental and non-governmental, in liaison with ISO and IEC, also take part in the work.

In the field of information technology, ISO and IEC have established a joint technical committee, ISO/IEC JTC1.

The main task of a technical committee is to prepare International Standards but in exceptional circumstances, the publication of a technical report of one of the following types may be proposed:

• type 1, when the necessary support within the technical committee cannot be obtained for the publication of an International Standard, despite repeated efforts;
• type 2, when the subject is still under technical development requiring wider exposure;
• type 3, when a technical committee has collected data of a different kind from that which is normally published as an International Standard ("state of the art", for example).

This specification (2nd edition) was prepared by ISO/IEC JTC1/SC34, referring to activities of the SGML group of ISO/ITSIG (Information Technology Strategies Implementation Group) and ISO/ITSIG/XML Project.

Introduction

The 1st edition of ISO/IEC TR 9573-11:1992 was published in 1992-09-15. Considering the actual works in the ISO system for standard development, the TR was modified to be the "ITSIG exchange DTD" by activities of the SGML group of ISO/ITSIG (Information Technology Strategies Implementation Group).

Responding to the user requirements for interchanging standards documents in XML environment, ITSIG instructed its XML project to develop XML DTD being based on the SGML DTD.

This 2nd edition of ISO/IEC TR 9573-11 includes both the SGML and XML DTDs. The clauses except 2, 10, Annex C, D, E, F, G, H are almost identical to the corresponding clauses of "ITSIG exchange DTD, version 0.93, 1998-03-03".

ISO/IEC TR 9573-11:2003
2nd edition

Information technology — Document Description and Processing Languages — Structure Descriptions and Style Specifications for Standards Document Interchange

1. Scope

This document describes the harmonized set of ISO DTDs which are designed for use within the ISO system for standards development. The base DTD of this set was created by ITSCG AWG1 during 1994 and 1995. At present, the SGML group of ITSIG is responsible for maintenance of these DTDs.

2. References

The following standards contain provisions that, through reference in this text, constitute provisions of this Technical Report. At the time of publication, the editions indicated are valid. All standards are subject to revision, and parties to agreements based on this Technical Report are encouraged to investigate the possibility of applying the most recent editions of the standards indicated below. Members of IEC and ISO maintain registers of currently valid International Standards.

ISO 8879-1986, Information processing — Text and office systems — Standard Generalized Markup Language (SGML)

ISO/IEC 10744:1997, Information technology — Hypermedia/Time-based Structuring Language (HyTime)

ISO/IEC 10179:1996, Information technology — Processing languages — Document Style Semantics and Specification Language (DSSSL)

ISO/IEC 19757-2:2003, Document Schema Definition Languages (DSDL) — Part 2: Grammar-based validation — RELAX NG

3. Approach to the harmonized set of ISO DTDs

3.1 Document flow (standards only)

The lifecycle of standards comprises three phases: development, publication, and refuse & dissemination. Each phase has different requirements for handling the standards as electronic documents.

The development phase requires simplicity of tools for capturing the content. The experts outside the ISO/CS may use a wide variety of very different tools. The presentation of the standards is of secondary importance; the content and the structure (if feasible) are of primary importance.

The publication phase requires flexibility and automation of routine work. The result must be of a professional publishing quality and enriched for further electronic dissemination.

The refuse & dissemination phase requires independence of a document instance in electronic form from the processing environment. No sophisticated application should be required to reprocess the document. SGML applications are already being used for standards production at the ISO/CS and by many member bodies, and also for the delivery of some commercial electronic products. Some working groups have good experience with SGML. So, it is necessary to define DTDs for use as the interfaces between the various phases.

3.2 Required DTDs

We know that it is not practical to provide a single DTD for everything. It was decided therefore to have a "common" DTD for exchange by published standards and several "in-house" DTDs, i.e. the member bodies could use their own variations of the base DTD (see figure 1).

Figure 1 — SGML applications in our business process

Standards from different member bodies look different and different publishing software is used. By preference, the difference between the exchange DTD and the individual variations should be minimized. Equivalent transformations of DTD fragments will help us to overcome software limitations. For example, we can replace in some cases a "simple" element type by an attribute and vice-versa. Also it is possible to change the names of element types and attributes for the in-house DTDs, e.g. to translate them to German.

To simplify the maintenance of the several very close DTDs, most of them are implemented as a derivation from one base DTD. The authoring DTDs are either simplified versions of the base DTD or widely-used DTDs such as HTML 3.2.

3.3 Guidelines for harmonization of DTD

The guidelines are ordered by the priority (from the highest to the lowest) agreed during the ITSCG AWG1 meeting in Berlin:

• a) Guarantee reusability of electronic documents (e.g. retrieval possibilities).
• b) Support production of Standards.
• c) Be implementable on the modern systems (at least in two independent systems).
• d) Conform with editorial rules.
• e) Be suitable to interactive work.
• f) Respect typographic rules.
• g) Keep element type names given in ISO/IEC TR 9573-11:1992.

3.4 General guidelines

The general guidelines are:

• a) Set of harmonized DTDs. For example, in-house DTDs for publishing and common DTD for exchange, i.e. the SDOs could use their own modifications of the base DTD. Also for authoring system we can provided the specialized versions of DTDs.
• b) Simplified DTD in comparison with ISO/IEC TR 9573-11:1992. We found that the half of the old ISO DTD is not used.
• c) SGML cannot check the everything, e.g. that a title is not empty. Such problems can be covered by "verification procedures" which we can implement as an external post-processing or as a client in a publishing / authoring system. Hope that such tests could be simple.
• d) Equivalent transformations of DTD fragments. It should be possible to change the names of element types and attributes for the in-house DTDs. Also one can replace in some cases a simple element type by an attribute and vice versa.
• e) Management of external references. We are going to freeze a document instance after publishing to prevent any changed by the constantly modified environment. For this reason, all external components such as drawings, boilerplate texts, database extractions should be handled by the public identifiers.
• f) The difference between base DTD and individual variations should be minimized. Reduce (even eliminate at all) the number of inclusions.
• g) Don't allow the tag minimization.

3.5 Technical approach

We expect that there is small number of differences between base and in-house DTDs. For example, the base DTD uses CALS table model, while an in-house DTD uses the application-dependent table model. We would like to handle simple differences by one base DTD which is included with some variations into in-house DTD. The base DTD is considered for exchange by published standards. Of course, document instances shall be converted from base to in- house.

DTD. SGML technique to make such simple modifications is described below. The following DTD contains only one element type abc which is define through parameter entity abcname:

The following DTD uses the previous one, but redefines the name of the element type:

This technique is limited, but it is enough in the most our cases.

3.6 Examples

Replacing (via parameter entity std.table) of the table model is demonstrated in the following example:

4. Architecture of Standards

4.1 General considerations

International Standards are complex technical documents. Their structure, presentation and some guidelines on the contents are given in the ISO/IEC Directives, Part 3, 1997. The table 1 contains the list of components (small building blocks) could be found in the standards. As a rule, a component contains text, special characters, drawings, etc. as well as other components. For example, paragraph and highlighted phrase are components. A component is presented in the DTD as an element type.

Table 1 — Standard's components

a) Only in the running text, but not in tables and figures.

Component	Display	Inline	Referential	Float
paragraph	+
list items (entries)	+
note	+
example	+
warning, remark	+
phrase		+
cross-reference		+	+
formula	+	+
footnotea)	+	+	+	+
figure	+			+
table	+			+

To present the logical structure of the document, the components are placed into so-called "containers". For example, a list is a (ordered or unordered) group of list items (or entries). The clauses and subclauses are another type of containers. They contain components and another containers, but not a text.

4.2 Normative or informative

A standard contains normative and informative provisions. The ISO/IEC Directives, part 3 explains "who is who". To reflect this business rule, some element types in the DTD contain an attribute status which can be either normative or informative. If an element type does not contain this attribute then the status of the element is inherited from the parent element in the document instance.

4.3 Not "All inside all"

Components allowed inside a component are shown in the table 2.

Table 2 — Component (from the first row) inside a component (from the first column)

a) Informative components.

	paragraph	list	note	example	warning	footnote	floats	displayed formula
paragraph	no	yes	yes	yes	no	yes	yes	yes
list item	yes	yes	yes	yes	no	yes	yes	yes
notea)	yes	yes	no	no	no	no	yes	no
example	yes	yes	no	no	no	yes	yes	yes
warnig	yes	yes	no	no	no	yes	no	no
footnotea)	yes	yes	no	no	no	no	no	no
floats	yes	yes	yes	yes	yes	no	no	yes

5. Element types description for base DTD

5.1 General convention for element types

The name on each element type is taken from ISO 8879:1986 and/or ISO/IEC TR 9573-11:1992 for simplicity. Possible approach is to follow architectural forms and "rename" an element type in the following way:

5.2 General convention for attributes

Most of element types have attribute "ID" for internal cross-references. The element types which generate an additional text, e.g. autonumbering, have attribute "GTEXT" which keeps the generated text, e.g.

5.3 The top-level structure of a standard

The top-level structure of a standard

5.3.1 General considerations

The top level structure is very in-house dependent. Imagine a national standard which is approved euronorme, which is approved international standard. Such a document may contain several forewords, endorsement notes, copyrights, etc. We decided to keep top level structure as simple as possible, but bearing in mind the interchange aspect.

5.3.2 International Standard(<STANDARD>)

5.3.2.1 Description

This is a root element in a standard.

5.3.2.2 Attributes

An attribute "LANGUAGE" specifies the language of the standard.

5.3.2.3 Usage guidelines

With two parameter entities (std.name and std.model) one can change the element type name and adjust its content model. See clause 8 for detail.

5.3.3 Document profile (<PROFILE>)

This element type is described in clause 6.

5.3.4 Title (or first cover) page (<TPAGE>)

5.3.4.1 Description

This element type is used as a placeholder for the first cover page. There is no structure for title pages which are different for each organization.

5.3.4.2 Content model

The content model is simple text.

5.3.4.3 Usage guidelines

It is considered that the title page is constructed from the information which is available in the profile. This is mandatory element, i.e. a standard shall contain one title page.

5.3.5 Table of contents (<TOC>)

5.3.5.1 Description

This element type is used as a placeholder for the table of contents generated by the publishing system.

5.3.5.2 Content model

The content model is simple text.

5.3.5.3 Attributes

The attribute "LEVEL" permits control over the level to which the subclauses are entered in the table of contents. The default value is "1" which means only the clauses from the body of the standard and annexes.

5.3.5.4 Usage guidelines

This is an optional element, i.e. a standard may contain one table of content.

5.3.6 Foreword (<FOREWORD>)

5.3.6.1 Description

This element type is used to identify foreword clause of the standard.

5.3.6.2 Content model

The content model is rather simple. It cannot contain any subdivisions and any numbered components like notes, figures, etc. Only paragraphs and lists are allowed in foreword.

5.3.6.3 Usage guidelines

This is mandatory element, i.e. a standard shall contain one foreword. Almost whole foreword is a set of boilerplate texts.

5.3.7 Introduction (<INTRO>)

5.3.7.1 Description

This element type is used to identify introduction clause of the standard.

5.3.7.2 Content model

The content model is rather simple. It can contain any subdivisions - unfortunately, ISO/IEC Directives does allow this. It can't contain any numbered components like notes, figures, etc.

5.3.7.3 Usage guidelines

This is an optional element.

5.3.8 Body of a standard (<BODY>)

5.3.8.1 Description

This element type is used to identify the body of the standard.

5.3.8.2 Content model

A body is structured by top-level (<H1>) titled numbered subdivisions of text, i.e. by clauses. There are four special clauses (<SCOPE>, <CONF>, <REFS> and <DEFS>). The body may contain a "warning statement" at the beginning.

5.3.8.3 Attributes

The attribute "COLS" specifies the number of columns. Only one column and two column (default) page layouts are recommended for monolingual standards. The attribute "STATUS" has fixed value "NORMATIVE".

5.3.8.4 Usage guidelines

This is mandatory element. A standard shall have a body. With a parameter entity (body.model) one can change the content model. See clause 8 for detail.

5.3.9 Normative annex (<ANNEXN>)

5.3.9.1 Description

This element type is used to identify a normative annex.

5.3.9.2 Content model

An annex contains either a mixture of basic components or at least two top-level subdivisions of text.

5.3.9.3 Attributes

The optional attribute "COLS" specifies the number of columns. Only one column and two column (default) page layouts are recommended for monolingual standards. The attribute "STATUS" has fixed value "NORMATIVE".

5.3.9.4 Usage guidelines

This optional and repeatable element, i.e. a standard may contain several normative annexes.

5.3.10 Informative annex (<ANNEXI>)

5.3.10.1 Description

This element type is used to identify an informative annex.

5.3.10.2 Content model

An annex contains either a mixture of basic components or at least two top-level subdivisions of text.

5.3.10.3 Attributes

The optional attribute "COLS" specifies the number of columns. Only one column and two column (default) page layouts are recommended for monolingual standards. The attribute "STATUS" has fixed value "INFORMATIVE".

5.3.10.4 Usage guidelines

This optional and repeatable element, i.e. a standard may contain several informative annexes.

5.3.11 Bibliography (<ANNEXBL>)

5.3.11.1 Description

This element type is used to identify a special informative annex with the bibliography.

5.3.11.2 Content model

Some text and the list of bibliographical references are allowed.

5.3.11.3 Attributes

The optional attribute "COLS" specifies the number of columns. Only one column and two column (default) page layouts are recommended for monolingual standards. The attribute "STATUS" has fixed value "INFORMATIVE".

5.3.11.4 Usage guidelines

This optional element. It is the last annex.

5.3.12 Index (<INDEX>)

5.3.12.1 Description

This element type is used as a placeholder for the index generated by the publishing system.

5.3.12.2 Content model

The content model is simple text.

5.3.12.3 Usage guidelines

This is an optional element, i.e. a standard may contain one index.

5.3.13 Last cover page (<LPAGE>)

5.3.13.1 Description

This element type is used as a placeholder for the last cover page. There is no structure for the last cover pages which are different for each organization.

5.3.13.2 Content model

The content model is simple text.

5.3.13.3 Usage guidelines

It is considered that the last cover page is constructed from the information which is available in the profile. This is mandatory element, i.e. a standard shall contain one last cover page.

5.4 Nested subdivisions of text

5.4.1 Architecture

Six nested levels of subdivisions of text are allowed. The top level of subdivision is clause. Another levels are subclauses. The subdivisions are always numbered. They may or may not contain a title.

5.4.2 Titled subdivisions of text (<H1>, <H2>, <H3>, <H4>, <H5>, <H6>)

5.4.2.1 Description

These element types are used to identify the clauses and subclauses of the standard.

5.4.2.2 Content model

For each titled subdivision contain a title <HT>, optional comment for title <CT> (except for dedicated ones), and a mixture of the basic elements - e.g. paragraphs, notes, various types of lists, figures, tables, etc. - or a lower level of text subdivision (either titled or untitled). These element types are typical containers.

The content model is reflected to the several editorial rules. At first, the empty subdivision is not allowed. At second, lower level subdivision shall appear minimum two times. And, at third, hanging text (i.e. a text without a title) is not allowed. In general, the content model looks as: (ht, ct?, ((text)+|(Hx,Hx+))).

There is a special case - terminology list, which can be alone in a subdivision. Finally, the content model looks terrible.

5.4.2.3 Examples

EXAMPLE 1

5.4.3 Heading title (<HT>)

5.4.3.1 Description

This element type is used to identify the title of titled subdivisions of text.

5.4.3.2 Content model

Only a running text and simple (no exotic) inline components are allowed inside the title.

5.4.3.3 Usage guidelines

This is mandatory element.

5.4.4 Heading title comment (<CT>)

5.4.4.1 Description

This element type is used to identify the comment to the title of titled subdivisions of text.

5.4.4.2 Content model

Only a running text and simple (no exotic) inline components are allowed inside the title comment.

5.4.4.3 Usage guidelines

This is optional element.

5.4.5 Untitled numbered subdivision of text (<P1>, <P2>, <P3>, <P4>, <P5>, <P6>)

5.4.5.1 Description

These element types are used to identify untitled numbered subdivisions which are very similar to the titled numbered subdivisions of text.

5.4.5.2 Content model

For each untitled subdivision contains a mixture of the displayed components - e.g. paragraphs, notes, various types of lists, figures, tables, etc. - as well as a lower level of untitled text subdivision. Again, these element types are containers.

5.4.5.3 Usage guidelines

Do not treat the untitled numbered subdivisions of text like the "numbered paragraphs". The subdivisions are nested, while the paragraphs are sequential.

5.4.6 Special clause with scope of a standard (<SCOPE>)

5.4.6.1 Description

This element type is used to identify the special clause titled "Scope" in English. No more differences with the element type <H1>.

5.4.6.2 Usage guidelines

This element type is mandatory and is the first clause in the body.

5.4.7 Special clause with conformance of a standard (<CONF>)

5.4.7.1 Description

This element type is used to identify the special clause title "Conformance" in English. No more differences with the element type <H1>.

5.4.7.2 Usage guidelines

This element type is optional and is the next after the scope.

5.4.8 Special clause with normative reference(s) (<REFS>)

5.4.8.1 Description

This element type is used to identify the special clause which contains the normative references used in the standard.

5.4.8.2 Content model

This element type consists of the boilerplate text followed by the list of references (see 5.5.15).

5.4.8.3 Usage guidelines

This element type is optional and is the next clause after the conformance, if any.

5.4.9 Special clause with definition(s) (<DEFS>)

5.4.9.1 Description

This element type is used to identify the special clause which contains the definitions used in the standard.

5.4.9.2 Content model

This element type consists of the boilerplate text followed by terminology list (see 5.6.1).

5.4.9.3 Usage guidelines

This element type is optional and is the next clause after the normative references.

5.5 Displayed components

5.5.1 Paragraph (<P>)

5.5.1.1 Description

This element type is used for the several purposes (badly inherited). At first, to identify the display component which is a block of the text and, at second, to identify a container for this text block and another display components. In the last case it serves as an additional lowest level subdivision of text.

5.5.1.2 Content model

This element type can contain a running text (with inline components), float components, all displayed components except paragraph itself.

5.5.2 Note (<NOTE>)

5.5.2.1 Description

This element type is used to identify the notes.

5.5.2.2 Content model

Note shall not contain footnotes.

5.5.2.3 Attributes

The attribute "NUMBER" controls the numbering of a note. The attribute "STATUS" has fixed value "NORMATIVE". That means that this element is always normative.

5.5.2.4 Usage guidelines

A note is attached to the some part of a document, either to a displayed component like paragraph, or to a subdivision. In the first case the note shall be inside the paragraph. In the second case, the note shall be the last "child" in the subdivision.

5.5.3 Example (<XMP>)

5.5.3.1 Description

This element type is used to identify examples.

5.5.3.2 Content model

This element may contain a running text and another display components.

5.5.3.3 Attributes

The attribute "NUMBER" controls the numbering of an example.

5.5.4 Manually formatted text (<MANFMT>)

5.5.4.1 Description

This element type is used to identify a displayed component with "manually formatted text" such as a computer source, listing, etc.

5.5.4.2 Usage guidelines

It is recommended to use proper entities to put nonbreakable spaces and the line breaks inside a text to achieve the desired formatting.

5.5.5 Warnings, cautions and remarks (<WARNING>)

5.5.5.1 Description

This element type is used to identify the display components with warnings, cautions, remarks, etc. to draw readers' attention for a particular text. The reasons may be different - precautions, security, etc. which are distinguished by an attribute "TYPE".

5.5.5.2 Content model

This element may contain a running text and another display components.

5.5.5.3 Attributes

The attribute "TYPE" has the several values for the different presentations.

5.5.5.4 Usage guidelines

Actually such warnings are attached to some piece of a document, e.g. a subdivision (if they are outside a displayed component), or, even, the entire document (general warning in the beginning of the body of the document).

5.5.6 Ordered and unordered lists (<OL> and <UL>)

5.5.6.1 Description

These element types are used to identify two traditional lists.

5.5.6.2 Content model

The list consists of a mixture of the list items and list paragraphs.

5.5.6.3 Attributes

The attribute "FORMAT" controls different presentations of lists. For <OL>:

alpha items are enumerated by lower case Latin characters;

arabic items are enumerated by Arabic digits;

roman items are enumerated by roman digits;

auto automatic selection of the enumeration method.

For <UL>:

bullet items are prefixed by bullet symbol;

emdash items are prefixed by emdash symbol;

sl items are not prefixed;

auto automatic selection of prefix.

5.5.6.4 Usage guidelines

The lists may be nested up to four levels.

5.5.6.5 Examples

EXAMPLE The following markup

resulting is

a) the x-orientation ...;
b) the x-nominal surface stress;
but not on:
c) the y-orientation ...;
d) the y-nominal surface stress;

5.5.7 List item (<LI>)

5.5.7.1 Description

This element type is used to identify the individual items within ordered and unordered lists.

5.5.7.2 Content model

This element may contain a running text and another display components.

5.5.8 List paragraph (<LP>)

5.5.8.1 Description

This element type is used to identify the paragraph which breaks the lists.

5.5.8.2 Content model

This element may contain a running text and another display components.

5.5.9 Description list (<DL>)

5.5.9.1 Description

This element type is used to identify the description list which is a list of pairs of a term and a definition.

5.5.9.2 Content model

This element contains only description list entries.

5.5.9.3 Attributes

The attribute "FORMAT" controls different presentations of list:

ol presentation simulates an ordered or unordered list;

varl presentation simulates a old variation list;

syml presentation simulates a old symbols list;

auto default presentation.

5.5.9.4 Usage guidelines

The description list can mimic complex cases of the ordered list. The interruption of ordered list may be more complex and the part of the list could be repeated several types (so-called "branching").

5.5.9.5 Examples

EXAMPLE 1

resulting in

Tex	The batch typesetting system developed by Prof. D. Knuth. The batch typesetting system developed by Prof. D. Knuth. The batch typesetting system developed by Prof. D. Knuth.
DCF	The batch typesetting system from IBM. The batch typesetting system from IBM. The batch typesetting system from IBM. The batch typesetting system from IBM.

EXAMPLE 2   See ISO 75-1:1993, clause 11:

resulting in

h) The orientation ...;
i) The nominal stress;

resulting in

a) reference to this part ...
b) to m) see ISO 6721-1:1994, clause 12;
n) if a fixed ...

5.5.10 Description list entry (<DLENTRY>)

5.5.10.1 Description

This element type is used to identify an entry in the description list. This is just a container.

5.5.10.2 Content model

This element contains a pair of a term and a definition.

5.5.10.3 Usage guidelines

This element may appear only in the description list.

5.5.11 Description list term (<DT>)

5.5.11.1 Description

This element type is used to identify a term inside description list entry.

5.5.11.2 Content model

This element contains simple text.

5.5.12 Description list definition (<DD>)

5.5.12.1 Description

This element type is used to identify definition inside description list entry.

5.5.12.2 Content model

This element contains running text or others display components.

5.5.13 Bibliography list (<BL>)

5.5.13.1 Description

This element type is used to identify the bibliography list.

5.5.13.2 Content model

This element contains only bibliographical entries.

5.5.13.3 Usage guidelines

This element should appear only in the bibliography.

5.5.14 Bibliography list entry (<BLENTRY>)

5.5.14.1 Description

This element type is used to identify an entry in the bibliographical list. This is just a container.

5.5.14.2 Content model

This element contains only references on external documents.

5.5.14.3 Usage guidelines

This element may appear only in the bibliography list.

5.5.15 Reference list (<RL>)

5.5.15.1 Description

This element type is used to identify the list of normative references.

5.5.15.2 Content model

Only several entries are allowed inside this element type.

5.5.15.3 Usage guidelines

This element should appear only in the clause for normative references (see 5.4.8).

5.5.16 Reference list entry (<RLENTRY>)

5.5.16.1 Description

This element type is used to identify an entry in the reference list. This is just a container.

5.5.16.2 Content model

This element contains only references on external documents.

5.5.16.3 Usage guidelines

This element may appear only in the reference list.

5.5.16.4 Examples

EXAMPLE   The reference list.

5.6 Terminology

5.6.1 Terminology list (<TL>)

5.6.1.1 Description

This element type is used to identify the terminology list. This element type is a simplified version of similar element type to be used for terminological standards. This element type follows ISO 10241:1992.

Terminology list is the set of concepts. The concepts may be organized in the different ways. There are types of relationships between concepts: hierarchy (a concept contains one or many subcontracts) and grouping (many concepts have are grouped with one title). These two type of relationships may be intermixed. So, on each level of hierarchy we can find a mixture of single concepts (element types <C1>, <C2>, <C3>, <C4> and <C5>) and groups of concepts (element types <CC1>, <CC2>, <CC3>, <CC4> and <CC5>).

5.6.1.2 Content model

This element contains several concepts (element type <C1>) or several concept groups (element type <CC1>).

5.6.1.3 Usage guidelines

This element may appear inside element <DEFS> (special clause for definitions), in a clause or in an annex.

5.6.1.4 Presentation

Historically, the terminology list "shares" numbering with subdivisions of text. To avoid the duplication of numbers, we need to restrict the use of <TL>. A numbered subdivision of text can contain either deeper subdivisions or a terminology list.

The heading of subdivisions and terms now have the different presentations. This allows to avoid confusion between them.

5.6.1.5 Examples

EXAMPLE 1   The terminology list without subdivision.

For the real example, see Annex A and Annex B which contain markup and presentation of the terminology for ISO/ IEC Directives, part 3, 1997.

5.6.2 Terminology concepts (<C1>,<C2>, <C3>, <C4> and <C5>)

5.6.2.1 Description

This element type is used to identify a concept on the different level of hierarchy.

5.6.2.2 Content model

Each such element type contains one or several terms, their description (optionally) and deeper single concepts or concept groups.

5.6.3 Terminology concept groups (<CC1>,<CC2>, <CC3>, <CC4> and <CC5>)

5.6.3.1 Description

This element type is used to identify a group of concepts under the same title on the different level of hierarchy.

5.6.3.2 Content model

Each such element type contains group title, text (optionally) and deeper concepts or concept groups.

5.6.4 Term description (<TERMDEF>)

5.6.4.1 Description

This element type is used to identify a term within the terminology list entry.

5.6.4.2 Content model

This element contains a mixture a running text and simple inline components.

5.6.4.3 Usage guidelines

This element may appear only in the concept.

5.6.5 Term description (<TERMDES>)

5.6.5.1 Description

This element type is used to identify a description of a term within the concept.

5.6.5.2 Content model

This element contains a mixture a running text, inline and displayed components.

5.6.5.3 Usage guidelines

This element may appear only in the concept.

5.7 Inline components

5.7.1 Highlighted phrase (<HP>)

5.7.1.1 Description

This element type is used to identify the phrases which are highlighted by different typographical presentations.

5.7.1.2 Content model

This element may contain a running text and all inline components.

5.7.1.3 Attributes

The attribute "FORMAT" specifies the following presentations:

none presentation as for running text;

bold presentation for the bold text;

italic presentation for the italic text;

boldit presentation for the bold italic text;

uline presentation for the underlined text;

oline presentation for the overlined text;

code presentation for the proportional text;

5.7.2 Term (<TERM>)

5.7.2.1 Description

This element type is used to identify a term.

5.7.2.2 Content model

This element may contain a raw text.

5.7.2.3 Attributes

The attribute "LANG" specifies the language of the term, e.g. Latin for biological terms.

5.7.2.4 Usage guidelines

This element may appear in the running text.

5.7.3 Internal cross-references (<XREF>)

5.7.3.1 Description

This element type is used to generate the internal (i.e. within a document) cross-reference such as "see table A.1". From the different possibilities what may be a generated text, e.g. just "A.1" or "table A.1", the shortest form has been chosen.

5.7.3.2 Content model

This element is empty, because it is considered that a cross-reference will be generated by the authoring or publishing system.

5.7.3.3 Attributes

The attribute "REFID" contains an ID of the element to be referenced. Some variations in the presentation are managed by the attribute "FORMAT". The attribute "GTEXT" contains the text generated by the publishing system.

5.7.3.4 Usage guidelines

It was decided to implement this element type as the HyTime architectural form "clink" (contextual link). It is very difficult to create HyTime-compliant document - "only computer will like to write HyTime documents." Right now, there is no publishing or authoring SGML-based system which can work in this way. But, there is document delivery software which can handle HyTime (e.g. SoftQuad Explorer, Panorama and EBT DynaText soon). Nevertheless, HyTime constructs in our case are more or less simple.

5.7.3.5 Examples

EXAMPLE 1   An internal reference on a table:

EXAMPLE 2   To reference on the several elements we need to use indirect addressing via the architectural form "nameloc" which contains the IDs of all referenced elements, e.g. an internal reference on tables:

5.7.4 Graphics (<ARTWORK>)

5.7.4.1 Description

This element type is used to insert external graphic file into the document. The external file is described as an external entity with the public identifier.

5.7.4.2 Content model

It is empty element.

5.7.4.3 Attributes

The attribute "NAME" specifies the entity name. The attribute "POSITION" specifies the position of the graphic relative to the insertion point. With attribute value "INLINE", the left lower corner of the graphic is to be placed at the insertion point. With attribute value "BELOW", the top edge of the graphic is to be placed below the insertion point.

5.7.4.4 Usage guidelines

The graphics may be used to mimic an unusual character inside a running text and as a figure without title.

The commonly agreed notations should be used to specify graphic formats, for example:

5.7.4.5 Examples

EXAMPLE 1   Insert a file in encapsulated PostScript format is:

EXAMPLE 2   Insert a file

EXAMPLE 3   Insert a file

5.7.5 Footnote (<FN>)

5.7.5.1 Description

This element type is used to identify a footnote. It is allowed only in running text, because it produces a footnote reference (i.e. a marker) which should be attach to something. A footnote is informative (as opposite to normative) component of a standard.

5.7.5.2 Content model

Footnote may contain a mixture of the running text and another displayed elements except notes and footnotes.

5.7.5.3 Attributes

The attribute "STATUS" has fixed value "INFORMATIVE".

5.7.5.4 Usage guidelines

But footnotes inside tables (or table notes) and figures (or figure notes) are differ. The use of footnotes in figures and tables will be discussed later.

5.8 Referential components

5.8.1 General considerations

In the DTD we want handle carefully the references on external documents to provide good input to the on-line hypertextual systems. All external documents (in the most cases normative documents) are given with their titles and publication dates either in "Normative references" clause or in the informative annex "Bibliography" (in this case we consider the reference as external). In the text such documents are indicated by their reference number only (in this case we consider the reference as internal). Such separation allows impose some control. To refer to another external documents we can use a bibliographical reference.

5.8.2 Bibliographical reference on an external document (<BIBDOC>)

5.8.2.1 Description

This element type is used to specify the bibliographical reference on an external document. Such a reference is just a text with a document title, etc.

5.8.2.2 Content model

Just a running text with highlighted phrases.

5.8.2.3 Usage guidelines

This element may be used in reference and bibliographical entries as well as in the running text.

5.8.3 Reference on an external document (<EXTDOC>)

5.8.3.1 Description

This element type is the hypertextual reference to an external document as entire. A reference may be represented by some text, which may be generated from in-house database. Actually the problem is focused on public identifiers for all our documents.

5.8.3.2 Content model

Just a running text with highlighted phrases.

5.8.3.3 Usage guidelines

This element type is the HyTime contextual link (architectural form "clink"). The attribute "REFID" is always the indirect reference (i.e. via the name location architectural form "nameloc").

5.8.3.4 Examples

EXAMPLE 1   The element <EXTDOC> always refers to an element <NAMELOC> which must contain an external entity.

Results in: "... ISO 8879: 1986, Information processing - Text and office systems - Standard Generalized Markup Language (SGML) ..."

EXAMPLE 2   The reference to the multi-part standard as a whole should mention all its parts. In the following example the last element <NAMELOC> serves for such a reference. This element contains all IDs of the elements <EXTDOC> and defines so-called aggregated location. In such a way the element <XREF> points simultaneously on the several elements <EXTDOC>.

EXAMPLE 3   A reference to particular elements of an external document, e.g. "conformément à 3.1.1 de l'ISO 1234:1984" is more complicated. The element <NAMELOC ID=x1234> defines the reference to the external document and the element <EXTDOC> uses this reference. The element <NAMELOC ID=y1234> defines the reference to particular element on this external document. The element <NAMELOC ID=z1234> defines the aggregated location which consists of the previous element <NAMELOC> and the element <EXTDOC>. The element <XREF> uses the last element <NAMELOC> to point simultaneously to the external document as a whole and to the particular element of this external document. This is a possible way to guarantee that a referenced external document is "mentioned" via an element <EXTDOC>.

5.9 Float components

5.9.1 Index entry (<IX>)

5.9.1.1 Description

This element type is used to identify an index entry which is attached to some place of a text.

5.9.1.2 Content model

Only a raw text.

5.9.1.3 Usage guidelines

We hope that the index entries will be generated by an authoring or publishing system. Sometimes index entries may be complex to support multilevel indexes, etc. But we decided to consider them as text, for now.

5.9.2 Figure (<FIGURE>)

5.9.2.1 Description

We would like to keep figures as simple as possible. Although ISO/IEC Directives, part 3 do allow logical grouping of figures (only two levels). For example, figures from ISO 10059-1:1992 are not implementable.

   drawing    drawing
a) aaaaaa b) bbbbbbbb
Figure 4 - Bla-bla-bla

Also it is not possible to do physical grouping of figures, i.e. put them together with proper alignment.

5.9.2.2 Content model

The element contains a title and a body (i.e. the rest).

5.9.3 Figure body (<FIGBODY>)

5.9.3.1 Description

This element type is used as container for a figure except its title. As a rule it contains drawing and some text which annotates this drawing.

5.9.3.2 Content model

The element contains a mixture of the running text, inline and displayed components except notes and footnotes.

5.9.4 Figure title (<FIGTITLE>)

5.9.4.1 Description

This element type is used to identify title of a figure.

5.9.4.2 Content model

The element contains a mixture of the running text and inline, except notes and footnotes.

5.9.5 Figure note (<FIGNOTE>)

5.9.5.1 Description

This element type is used to identify footnotes inside a figure to annotate a drawing. Such footnotes (actually, figure notes) are special because they contain the normative information while the ordinary footnotes contain informative information.

5.9.5.2 Content model

The element contains a mixture of the running text, inline and displayed components except notes and footnotes.

5.9.5.3 Usage guidelines

Markers shall appear on the drawing and in the beginning of a figure note. These markers can be the part of the drawing or may be attach to the drawing as annotations. In the first case we need to guarantee that we can use the same marker (e.g. a number in the circle) in the drawing and in the text. In the second case we meet with overlaying components one of them should be described in SGML.

5.9.6 Table (<TABLE>)

5.9.6.1 Description

As simple as possible with CALS tables. One can find their definition in MIL-M-28001B (26 June 1993). This document is available on several FTP sites. The content model for cells allows figures within tables.

5.9.6.2 Content model

The element contains a title, table header (optional), table body, and table footer (optional). This content model is simplified CALS model for tables.

5.9.7 Table title (<TABTITLE>)

5.9.7.1 Description

This element type is used to identify a title of table.

5.9.7.2 Content model

The element contains a mixture of the running text and inline, except notes and footnotes.

5.9.8 Table note (<TABNOTE>)

5.9.8.1 Description

This element type is used to identify footnotes inside a table. Such footnotes (actually, table notes) are useful to attach more text to a cell. They contain the normative information while the ordinary footnotes contain informative information.

5.9.8.2 Content model

The element contains a mixture of the running text, inline and displayed components except notes and footnotes.

5.10 Very specific components

5.10.1 Formulae (<FORMULA> and <DFORMULA>)

5.10.1.1 Description

These element types are used to identify the mathematic formulae.

5.10.1.2 Content model

We decided to use SGML markup for formulae. It was agreed to adopt DTD fragment for mathematics from ISO 12083:1994 as a replacement for the currently used mathematics described in ISO/IEC TR 9573-11:1992.

5.10.2 Tolerance (<TOL>)

5.10.2.1 Description

This element type is used to identify the tolerances. There is no yet a subDTD to markup all possible tolerances as presented in the ISO/IEC Directives, Part 3.The examples below are just a proposal.

5.10.2.2 Retrieval aspects

Of course, such markup is pretty awful, but we are not going to reuse these tolerances in other applications.

5.10.2.3 Examples

The examples are in the following table.

Table 3 — Examples for tolerance markup

Result	<TOL>markup</TOL>
6,3 mm 12,5 %	6,3 mm <symdev>12,5 %</symdev>
6,3 × (1 12,5 %) mm	6,3 &times; (1 <symdev>12,5 %</symdev>) mm
(30 ± 1,5) mm	(30 <symdev>1,5</symdev>) mm
3 mm+0,2 mm -15 %	3 mm <uppdev>+0,2 mm</uppdev><lowdev>-15 %</lowdev>

5.10.3 Chemistry (<CHEM>)

5.10.3.1 Description

Chemistry shall be processed as formulae.

5.10.3.2 Examples

EXAMPLE 1

EXAMPLE 2

EXAMPLE 3

EXAMPLE 4

5.10.4 Designators (<DESIGN>)

5.10.4.1 Description

For designation of internationally standardized items, please, see ISO/IEC Directives, Part 2. Generally, a designation (element type <DESIGN>) consists of a description (textual?), International Standard Number Block and one or more Data Blocks. The current definition of the designation system forces to make a presentational model, e.g. the number of a relevant part of Standard shall be indicated in Data Block, while the number of standard shall be put in International Standard Number Block. The proposed content model joins this information in the element type <EXTDOC> to allow to reference on the standard. But the visual result is the same.

5.10.4.2 Usage guidelines

Individual Data Block can be "linked" to their descriptions, if any.

5.10.4.3 Presentation

See the markup of the example E.7.1 from the Directives, Part 2.

5.10.4.4 Examples

EXAMPLE

5.11 Possible extensions of the DTD

5.11.1 Text block (<TEXTBLK>)

There is a need for text block displayed component to cover some exotic cases, e.g. long quotation.

5.11.2 Modification of element types for formulae component

It is proposed to add attribute(s) to keep the graphical presentation(s) of a formulae.

5.11.3 Modification of element types for figure component

It is proposed to define the figure body as a table.

6. Profile

6.1 Introduction

In the ITSIG exchange DTD for Standards the bibliographical, monitoring, and other information about a document (i.e. metadata) must be attached to the document instance. Roughly speaking, it is catalogue-like description of a document. In standard development business such information appear in the several types of applications:

• electronic publishing of Standards;
• project monitoring databases (PMDB);
• electronic information services like PERINORM or ISO Online;
• catalogues production.

As a rule, this information resides in a particular PMDB and is requested for others PMDBs and applications. New ISONET manual describes more that hundred fields which may be potentially exchanged. The ISONET manual gives two representation - conventional and SGML. The least can be used in ITSIG exchanged DTD to encode metadata. Historically, we call document's metadata as "profile".

This article describes the implementation of profile in the SGML project. As it was decided on the SGML group meeting on December 1997, we have to progress with the use of new ISONET manual for exchange of metadata. At regional and national SDOs there are procedures when an International Standard is endorsed as their standard. It is very important that profile of International Standard would be easily reused by Member bodies' SGML-based production system.

6.2 Architecture

6.2.1 General considerations

We already understood, that it is not convenient to use the same profile in the different applications. For example, ISO reference number is usually presented as "ISO 1234-1:1994", while for SGML publishing system it should be encoded as "ISO&nbsp;1234-1&thinsp;:&thinsp;1994". Another example, special procedure as fast-track is a just a flag in PMDB, but it is a particular boilerplate text to be inserted on the cover page for publishing system.

We separate profile extracted from databases (database-oriented), which we have to encode with conformance with new ISONET manual and profile to be used by publishing system (document-oriented) which should be convenient for publishing needs. Easy extensibility of profile should be taken into account in the implementation.

It is important to emphasize that only database-oriented profile should be used for interchange of data between the different organizations involved. Document-oriented profile is internal choice of each organization. Of course, it may be coincident with database-oriented profile in the simple cases.

6.2.2 Database-oriented profile

In the example of database-oriented profile only four groups are used (see clause A.1 for the DTD):

00   data elements for the file label;

10   data elements for projects;

20   data elements for products (documents in our case);

40   data elements for committee information.

EXAMPLE 1

There are several changes to the latest edition of ISONET manual:

• a) element TITLE (used in E20.200) is structured in the way that is mixed text and title's components; from one hand, the generation of titles becomes simple - one has to remove all tagging only; from another hand there is access to all individual components;
• b) element REFNUM (used in E10.104) is structured also in the mixed way for the same reasons as above;
• c) element E40.145 was added to specify the number of a committee.

As a rule, database-oriented profile contains a lot of information for the main document and just a few elements for the referred documents. An example for referred document is below:

EXAMPLE 2

6.2.3 Document-oriented profile (<DOCPROF>)

Document-oriented profile contains the metadata about the document itself (i.e. the main document) and it may contain the metadata about the documents which are referred in the main document. The database-oriented profile for a particular document has to be embedded in the document-oriented profile. So, the document-oriented profile structure is look in the following way:

At present, document-oriented profile used at ISO/CS is very simple - only three elements are required: <FIELD> to keep a single piece of information, <ISOREF> to keep references like "ISO 1234:1999 - Dummy title", and <XP> to reuse content of previous elements. A unique ID is assigned for the each element.

An example of document-oriented profile for referred document is below.

EXAMPLE 1

Note, that now all elements have SGML unique identifier for internal references. The additional element type (<XP>) is designed for to "copy something from profile by reference". For example, to the reuse of the publication year is "... <XP TYPE=BODY REFID='R0.6.1'> ... ".

The element type (<ISOREF>) is used to define the different types of a reference on ISO Standard. The reference may be a truncated (in different ways) reference number, a title, or a combination of both. Everything is possible with the element type <ISOREF> which contains four attributes ("VARA", "VARB", etc.) for different variations of the reference number and the content with the title of the Standard (see below):

Note in that definition, the element <XP> is already used to "copy" the title of the standard. Actually, this element can refer not only on the content of an element in profile, but attributes of an element as well. Any combination of these two options is possible also. So the reference like this "... <XP TYPE=ISOREF REFID="R0.E"> ... " produces " ... ISO 10013: 1995, Guidelines for developing quality manuals ...". Of course, this is a feature of the publishing system at the ISO/CS. In another publishing system, implicit generation of all variations may be necessary.

6.3 Boilerplate text support

ISO Standard contains many boilerplate texts in may variations. There is some logic in presentation (English or French), in boilerplate texts (JTC1 or not), etc. To provide conditional generation of a document in the SGML-based publishing system we use so-called marked section. The transformation procedure from database to document profile also generates the several parameter entities which are used for conditional processing of the document. Below is an example of a boilerplate text fragment for foreword clause:

6.4 Conclusions

The separation of profile into database-oriented and document-oriented has the following advantages:

• a) database-oriented profile is based on the agreed format, i.e. ISONET manual, and
• b) implementation of document-oriented profile is internal choice of an organization.

7. Master entity dictionary

7.1 General

The base DTD contains the several groups of parameter entities to allow some modifications of the base DTD. Some entities are intended for internal organization of the base DTD. The derived DTD is usually defined as some modifications of the parameter entities, the base DTD and additional element types.

7.2 Overall structure

7.2.1 Parameter entity std.name

The parameter entity std.name is the general identifier (i.e. name) of the top element type in the base DTD.

7.2.2 Parameter entity std.model

The parameter entity std.model is the content model for the top element type in the base DTD.

7.2.3 Parameter entity body.model

The parameter entity body.model is the content model for the element type <BODY>.

7.2.4 Parameter entity std.profile

The parameter entity std.profile is the complete definition of the element type <PROFILE>.

7.2.5 Parameter entity std.links

The parameter entity std.web is the complete definition of the element type <LINKS>.

7.2.6 Parameter entity std.entity

The parameter entity std.entity is the definition of all character entities used in base DTD. Two set of character entities are predefined. Each of them contains several hundreds of character entities. The first set is based on ISO 8879:1986 and it has the public id "-///ISO/CS//DTD std::entity:8879//EN". The second set is based on ISO/IEC TR 9573 and has the public id "-//ISO/CS//DTD std::entity:9573//EN".

7.3 Base and local groups

7.3.1 General approach for local modifications

The base DTD uses the several groups (display, inline, include and float) of element types. Each group has base part, which is the default definition, and the local part, which is local addition. The combination of these two parts is used in the derived DTD.

7.3.2 Parameter entity base.list

The parameter entity base.list contains the element types for general list components.

7.3.3 Parameter entity base.note

The parameter entity base.note contains the element types for note components.

7.3.4 Parameter entity base.xmp

The parameter entity base.xmp contains the element types for example components.

7.3.5 Parameter entities base.display, local.display, and display

The parameter entities base.display, local.display, and display are, respectively, base, local, and combined definitions of the group of element types for display components.

7.3.6 Parameter entities base.inline, local.inline, and inline

The parameter entities base.inline, local.inline, and inline are, respectively, base, local, and combined definitions of the group of element types for inline components.

7.3.7 Parameter entities base.float, local.float, and float

The parameter entities base.float, local.float, and float are, respectively, base, local, and combined definitions of the group of element types for float components.

7.3.8 Parameter entities base.include, local.include, and include

The parameter entities base.include, local.include, and include are, respectively, base, local, and combined definitions of the group of element types for include components.

7.4 Content models

7.4.1 Parameter entity m.ph

The parameter entity m.ph is the content model of "phrase". It is used for inline components.

7.4.2 Parameter entity m.par

The parameter entity m.par is the content model of "paragraph". It is used for display components.

7.4.3 Parameter entity m.pseq

The parameter entity m.pseq is the content model of "sequence of paragraphs". It is used for containers.

7.4.4 Parameter entity m.entry

The parameter entity m.entry is the content model of "table cell". It is used in table subDTD.

7.5 Attributes modification

7.5.1 Parameter entity std.page

The parameter entity std.page may be use to add attributes to the element types: <BODY>, <ANNEXN>, <ANNEXI>, and <ANNEXBL>. Usually, an attribute for the page layout is added.

7.5.2 Parameter entity std.xref

The parameter entity std.xref may be use to add an attribute to the element type <XREF>. Usually, an attribute for the cross-reference format is added.

7.6 Modification of formulae component

7.6.1 Parameter entities base.df and base.f

The parameter entities base.df and base.f are used to specify the names of displayed and inline, respectively, element types for formulae component.

7.6.2 Parameter entity std.math

The parameter entity std.math is the definition of the formulae component.

7.6.3 Default definition of formulae component

The default definition of formulae component contains two text-only element types: <DFORMULA> and <FORMULA>.

7.6.4 Use of ISO 12083:1995 for formulae component

The mathematic subDTD from ISO 12083:1995 has public id "-//ISO/CS//DTD m12083//EN". To use this subDTD, the derived DTD should define the entity std.math, for example:

7.7 Modification of figure component

7.7.1 Parameter entities fig.model, fig.include and fig.exclude

The parameter entities fig.model, fig.include, and fig.exclude are used to specify the content model, inclusion, and exclusions, respectively, of element type <FIGURE> for figure component.

7.7.2 Parameter entity fig.title

The parameter entity fig.title is the name of the element for figure title.

7.7.3 Default definition of figure component

The default definition of figure component is the following:

7.8 Modification of table component

7.8.1 Parameter entities tab.model, tab.include, and tab.exclude

The parameter entities tab.model, tab.include, and tab.exclude are used to specify the content model, inclusion, and exclusions, respectively, of element type <TABLE> for table component.

7.8.2 Parameter entity tab.title

The parameter entity tab.title is the name of the element for table title.

7.8.3 Default definition of table component

The default definition of table component is based on CALS subDTD for tables. This subDTD has public identifier "-/ /USA-DOD//DTD MIL-M-28001B/table//EN".

8. Derivation of DTDs from the base DTD

To simplify the maintenance of the several very close DTDs, most of them are implemented as a derivation from one base DTD. Using the base part and local part of the base DTD, derivation of DTDs can be carried out.

9. Authoring DTDs

9.1 Authoring DTD for native SGML tools

Authoring DTD for SGML native tools is a simplified version of the base DTD. The following simplification is pro- posed: less number of tags, no formulae, no exotic element types.

9.2 Authoring DTD for word processors

Another authoring DTD is designed for use with word processors which can save a document in SGML format (e.g. SGML Author for Word by Microsoft). Such a DTD is a simplified twice. At the first, the number of element type is reduced to simplify the authoring. At the second, the structure is flatten, i.e. an element type for display component may not contain another element type for display component. Thus a paragraph may not contain a note. This simplification reflects the current functionalities of word processors. Another simplification is avoiding the nesting. Instead of general element type for nested list (ordered or unordered), four element types are introduced: list level1, list level 2, etc.

9.3 Use of HTML for standards development

The current complexity of HTML is enough to use it for presentation of standards.

10. All public entities

The public entities used in the set of ISO DTDs for standard are given in the following table.

Table 4 — The public entities used in the set of ISO DTDs

Public Id	Comment
-//ISO/CS//DTD std::entity::8879//EN	All character entries in accordance with ISO 8879:1986
-//ISO/CS//DTD std::entity::9573//EN	All characters entities in accordance with ISO/ IEC TR 9573
-//ISO/CS//DTD std::in::92//EN	ISO/CS publishing DTD, version 0.92
-//ISO/CS//DTD std::base::92//EN	Base DTD, version 0.92
-//ISO/CS//DTD std::exchange::92//EN	ITSIG exchange DTD, version 0.92
-//ISO/CS//DTD std::in::93//EN	ISO/CS publishing DTD, version 0.93
-//ISO/CS//DTD std::base::92//EN	Base DTD, version 0.93
-//ISO/CS//DTD std::exchange::93//EN	ITSIG exchange DTD, version 0.93
-//ISO/CS//DTD m12083//EN	Mathematics subDTD from ISO 12083:1995
-//USA-DOD//DTD MIL-M-28001B/table//EN	Table subDTD from CALS
-//ISO/CS//DTD isonet::0.01//E	ISONET based DTD for database profile

11. XML DTD

The XML-DTD is derived from the above SGML structure.

11.1 XMLization

Major modifications for XMLization are:

• a) Comments within declaration are extracted to be separate comment statements.
• b) Characters are adjusted according to the XML rule of case sensitivity.
• c) All tags are described without omission.
• d) Each element is defined separately.
• e) All the attribute values are quoted.
• f) Attribute types NAME, NUMBER, and NUTOKEN are changed into NMTOKEN.
• g) The location of #PCDATA is changed into a head of declaration.
• h) Content models are modified without & separators.
• i) Characters defined by SDATA are changed into simple strings.
• j) Elements declarations are changed without exceptions.
• k) URIs are specified to the public identifies.

11.2 Modularization

The XML-DTD is modularized for a more feasible DTD exchange. The modularization is based on the logical structure of the original SGML-DTD (see Figure 2).

Figure 2 — Referencing relationship between the files of the SGML-DTD

ITSIG/stdex94.dtd (MATH, ARTWORK, Figure, Terminology) +--- ITSIG/m12083.dtd (Formula) +--- ITSIG/tl93a.dtd (Terminology) +--- ITSIG/isonet10.dtd (ISONET) +--- ITSIG/se9573.dtd (Entities) | +--- ent9573/isolat1.ent, ent9573/isolat2.ent, ent9573/isonum.ent, | +--- ent9573/isodia.ent, ent9573/isopub.ent, ent9573/isobox.ent, | +--- ent9573/isotech.ent, ent9573/isogrk1.ent, ent9573/isogrk2.ent, | +--- ent9573/isogrk3.ent, ent9573/isogrk4.ent, ent9573/isocyr1.ent, | +--- ent9573/isocyr2.ent, ent9573/isoamsa.ent, ent9573/isoamsb.ent, | +--- ent9573/isoamsc.ent, ent9573/isoamsn.ent, ent9573/isoamso.ent, | +--- ent9573/isoamsr.ent, ent9573/isomfrk.ent, ent9573/isomopf.ent, | +--- ent9573/isomscr.ent, ent9573/isocs.ent +--- ITSIG/calstab.dtd (Table) +--- ITSIG/stdb94.dtd (NOTATION, parameter entities, structure, displayed elements, terminology list, figure, table, formula)

All the XML-DTD module files are shown in Annex D, where all the element names are described in lower case. A file with the extension ".dtd" is a driver or a DTD module translated from the corresponding SGML-DTD file and a file with ".mod" is a new DTD file developed for the modularized XML-DTD representation.

•  a) stdex.dtd [DTD Driver]
•  b) stdex-model.mod [Model Module]
•  c) stdex-ent.mod [Entity Module]
•  d) stdex-profile.mod [Profile Module]
•  e) isonet10.dtd [Isonet Module]
•  f) se9573.dtd [Entity]
•  g) stdex-docprof.mod [Document oriented Profile Module]
•  h) stdex-base.mod [Base Element Module]
•  i) stdex-notation.mod [Notation]
•  j) stdex-tpage.mod [Title Page]
•  k) stdex-lpage.mod [Last Cover Page]
•  l) stdex-toc.mod [Table of Contents]
•  m) stdex-index.mod [Index]
•  n) stdex-foreword.mod [Foreword]
•  o) stdex-intro.mod [Introduction]
•  p) stdex-body.mod [Body]
•  q) stdex-annex.mod [Annex]
•  r) stdex-nest.mod [Nested Subdivisions]
•  s) stdex-disp.mod [Displayed Components]
•  t) stdex-tl-simple.mod [Terminology List Simple Module]
•  u) stdex-tl.mod [Terminology List Module]
•  v) stdex-inline.mod [Inline Components]
•  w) stdex-artwork-simple.mod [Artwork Simple Module]
•  x) stdex-artwork.mod [Artwork Module]
•  y) stdex-ref.mod [Referential Components]
•  z) stdex-float.mod [Float Components]
•  aa) stdex-figure-default.mod [Figure Default Module]
•  ab) stdex-figure.mod [Figure Module]
•  ac) stdex-table.mod [Table]
•  ad) calstab.dtd [Cals Table]
•  ae) stdex-specific.mod [Very Specific Components]
•  af) stdex-math-simple.mod [Math Simple Module]
•  ag) stdex-math.mod [Math Module]
•  ah) stdex-math-extension.mod [Math Extension Module]
•  ai) stdex-tol.mod [Tolerance]
•  aj) stdex-chem.mod [Chemistry]
•  ak) stdex-listing.mod [Listing Module]

The referencing relationship of the modules is illustrated in Figure 3.

Figure 3 — Referencing relationship of the module files consisting of the XML-DTD

stdex.dtd [DTD Driver] +--- stdex-model.mod [Model Module] +--- stdex-ent.mod [Entity Module] +--- stdex-profile.mod [Profile Module] | +--- isonet10.dtd [Isonet Module] | | +--- se9573.dtd [Entity] | +--- stdex-docprof.mod [Document oriented Profile Module] +--- stdex-base.mod [Base Element Module] | +--- stdex-notation.mod [Notation] | +--- stdex-tpage.mod [Title Page] | +--- stdex-lpage.mod [Last Cover Page] | +--- stdex-toc.mod [Table of Contents] | +--- stdex-index.mod [Index] | +--- stdex-foreword.mod [Foreword] | +--- stdex-intro.mod [Introduction] | +--- stdex-body.mod [Body] | +--- stdex-annex.mod [Annex] | +--- stdex-nest.mod [Nested Subdivisions] | +--- stdex-disp.mod [Displayed Components] | +--- stdex-tl.mod [Terminology List] | +--- stdex-inline.mod [Inline Components] | | +--- stdex-artwork.mod [Artwork] | +--- stdex-ref.mod [Referential Components] | +--- stdex-float.mod [Float Components] | | +--- stdex-figure.dtd [Figure] | | +--- stdex-table.dtd [Table] | | +--- calstab.dtd [Cals Table] | +--- stdex-specific.mod [Very Specific Components] | | +--- stdex-math.mod [Math] | | +--- stdex-math-extension.mod [Math Extension Module] | | +--- stdex-tol.mod [Tolerance] | | +--- stdex-chem.mod [Chemistry] | +--- se9573.dtd [Entity] +--- stdex-listing.mod [Listing Module]

NOTE   The values of gtext attributes are generated by a particular processor. Those attributes generation and rendering can be done, for example, by an XSL processor.

11.3 Non-ISONET base description

For non-ISONET base bibinfo description, the following document profile is prepared.

Annex A
(informative)
Example of terminology in SGML

This is a complete SGML document which contains the terminology from ISO/IEC Directives, Part 3, 1997.

Annex B
(informative)
Example of terminology presentation

This annex is the result of interpretation of SGML- tagged example of terminology given in Annex B.

B.1 standard

document, established by consensus and approved by a recognized body, that provides, for common and repeated use, rules, guidelines or characteristics for activities or their results, aimed at the achievement of the optimum degree of order in a given context

NOTE   Standards should be based on the consolidated results of science, technology and experience, and aimed at the promotion of optimum community benefits.

[ISO/IEC Guide 2:1996, definition 3.2]

B.1.1 international standard

standard that is adopted by an international standardizing/standards organization and made available to the public

[ISO/IEC Guide 2:1996, definition 3.2.1.1]

NOTE   International standards published by ISO and IEC are written with a capital "I" and "S", i.e. "International Standard".

B.2 Technical Report

B.2.1 type 1 Technical Report

publication for which the required support for approval as an International Standard cannot be obtained, or for which there is doubt on whether consensus has been achieved

NOTE   The content of a type 1 Technical Report, including its annexes, may include information that is of a normative nature, although the document itself is not of a normative nature.

B.2.2 type 2 Technical Report

publication of work still under technical development, or where for any other reason there is the future, but not immediate, possibility of agreement on an International Standard

NOTE   The content of a type 2 Technical Report, including its annexes, may include information that is of a normative nature, although the document itself is not of a normative nature.

B.2.3 type 3 Technical Report

informative publication containing collected data of a different kind from that which is normally published as an International Standard

NOTE   Such data may include, for example, data obtained from a survey carried out among the national bodies, data on work in other international organizations or data on the "state of the art" in relation to standards of national bodies on a particular subject.

B.3 Guide

publication containing material on general matters related to international standardization

B.4 normative elements

those elements setting out the provisions to which it is necessary to conform in order to be able to claim compliance with the standard

B.5 informative elements

B.5.1 preliminary elements

those elements that identify the standard, introduce its content and explain its background, its development and its relationship with other standards

B.5.2 supplementary elements

those elements that provide additional information intended to assist the understanding or use of the standard

B.6 required element

element the presence of which in a standard is obligatory

B.7 optional element

element the presence of which in a standard is dependent on the provisions of the particular standard

B.8 provision

expression in the content of a normative document, that takes the form of a statement, an instruction, a recommendation or a requirement

NOTE   These types of provision are distinguished by the form of wording they employ; e.g. instructions are expressed in the imperative mood, recommendations by the use of the auxiliary "should" and requirements by the use of the auxiliary "shall".

[ISO/IEC Guide 2:1996, definition 7.1]

B.8.1 statement

provision that conveys information

[ISO/IEC Guide 2:1996, definition 7.2]

B.8.2 instruction

provision that conveys an action to be performed

[ISO/IEC Guide 2:1996, definition 7.3]

B.8.3 recommendation

provision that conveys advice or guidance

[ISO/IEC Guide 2:1996, definition 7.4]

B.8.4 requirement

provision that conveys criteria to be fulfilled

[ISO/IEC Guide 2:1996, definition 7.5]

B.9 state of the art

developed stage of technical capability at a given time as regards products, processes and services, based on the relevant consolidated findings of science, technology and experience

[ISO/IEC Guide 2:1996, definition 1.4]

Annex C
(informative)
SGML DTDs

C.1  DTD for database-oriented profile

C.2  Document-oriented profile information

The document profile information element (docprof) is composed mainly of the information that appears on the front cover page and back cover page of the published (paper) document. Other, optional, information elements contain information that typically is present in a project monitoring database; e.g. date of various stages in the development of the document.

NOTE   This information is normally only present for documents interchanged between standards bodies. Some of the information applicable to the sender body may be used by the receiver body for their own bibliographic information.

The document profile information element has an attribute (apply=), which is used to specify the standards body to which the information contained within the element is applicable. This attribute is required.

The document profile information element may be repeated. In this case the value of the apply attribute has to be different for each repetition.

The docprof element is composed of

• a) titles
• b) edition
• c) version (optional)
• d) language
• e) document number
• f) document source (optional)
• g) notes (optional)
• h) endorsement information (optional)
• i) development cycle information
• j) information regarding other documents that the current document replaces or is replaced by (optional)
• k) abstract (optional)
• l) classification information (optional)
• m) keywords (optional)
• n) related standards (optional)
• o) production information (optional)

  NOTE   This information is tyhpically used only for the production of the documents on some physical medium; it is not used for any intellectual information.

• p) other information (optional)

NOTE   Some of the optional elements are not used for ISO documents. These elements are: version, abstract, related standards, and other information.

MARKUP EXAMPLE

C.2.1 Titles

The title information consists of one or more occurrences of title entity (titleent) elements, which is composed of

• a) main title (mtitle)
• b) part title (ptitle)

NOTES   Dashes in the titles are keyboarded using the — entity. In the case of a multipart standard the dash between the title and the title of the part is not keyboarded, since it is not part of the title. In the appropriate places this dash is added by the system.

Titles in languages not using the latin alphabet are keyboarded using entity references. For interchange it is recommended that latin letters with diacritics are represented using entity references.

C.2.2 Edition

The edition is identified by the tag. The markup is:

C.2.3 Version

The (optional) version of the document is identified by the tag. It is used to indicate the version of the draft International Standard. The markup is:

C.2.4 Language

The language of the document is identified by the tag. The content of the element is in accordance with ISO 639. The markup is:

NOTE   The language indicator in the reference number of the standard, E, F, or R, is derived from the content of this element.

C.2.5 Document number

The document number consists of

• a) number of the working draft (wdnumber); a prefix followed by a serial number (sernum) element
• b) number of the standard (number)
• c) number of the part (part) (if the standard is published in parts)
• d) type (type) with content 1, 2 or 3 (if the document is a Technical Report)

The markup is:

C.2.6 Document source

The source of the document is identified by the <sourceod> tag. The content of the element is either ISO, or ISOIEC. The element is optional and a source of ISO is implied for a <docprof apply=ISO> element. The markup is:

C.2.7 Notes

Notes, if any, applicable to the document are identified by the <notes> tag. The content is one or more tokens:

• a) FT (for Fast Track)
• b) NONCOMP (for documents which are not yet resident in the system: in this case the system is used to generate only a cover page and foreword)
• c) CR45.83 (for Council resolution 45/1983)
• d) CR21.86 (for Council resolution 21/1986)
• e) LATE.F (French text late arriving)
• f) LATE.E (English text late arriving)
• g) MULT.TC (Note to consult experts in several fields)

The markup is:

C.2.8 Endorsement information

Endorsement information, if any, is identified by the <endorsmt> tag. The content of this element is one or more occurrence of <endorsent>, which is composed of

• a) endorsed document (endorsdn) reference number
• b) explanation of endorsement (endorsnt) (optional)

The markup is:

C.2.9 Development cycle information

Information pertaining to the development cycle of the document is contained in the developc element. This element consists of one or more occurrences of

• a) status of the document (status), with content
  •  1) IS: International Standard
  •  2) ISP: International Standardized Profile
  •  3) TR: Technical Report
  •  4) DIS: Draft International Standard
  •  5) DISP: Draft International Standardized Profile
  •  6) DTR: Draft Technical Report
  •  7) AMDS: Amended Draft (Standard)
  •  8) AMDT: Amended Draft (Technical Report)
  •  9) AMDP: Amended Draft (International Standard Profile)
  • 10) CD: Committee Draft
  • 11) PDTR: Proposed Draft Technical Report
  • 12) WD: Working Draft
• b) date at which the document reached the status (scdate)
• c) date of the start of the vote at the status (votestrt) (if applicable)
• d) date of the end of the vote at the status (voteend) (if applicable)
• e) an explanatory report (report) (optional)

The markup is:

C.2.10 Replacement information

A document may replace one or more documents, either fully or in part. Similarly a document may be replaced by one or more documents. Such replacement information is identified by the replaces and replaced elements, respectively. These elements are repeatable.

These elements consist of

• a) an external reference
• b) a comment regarding the replacement

C.2.11 Abstract

An (optional) Abstract is identified by the <abstract> tag. The content is a sequence of paragraphs.

NOTE   The content of this element is not used for published paper copies of International Standards. The information is used for bibliographic products.

The markup is:

C.2.12 Classification information

Classification numbers are identified by the <classifn> tag. An attribute type= is used to identify the classification scheme.

NOTE   Currently only ICS numbers are used for International Standards.

The markup is:

C.2.13 Keywords

Each keyword for the document is identified by the <keyword> tag. This element can occur zero or more times.

NOTE   Keywords (descriptors) are assigned by the ISO Central Secretariat.

The markup is:

C.2.14 Related standards

Standards related to the documents are each identified by the <relstd> tag.

NOTE   This element is not used for International Standards.

The markup is:

C.2.15 Production information

Production parameters are specified in the prodinfo element. This element consists of pairs of

• a) prodrarm element whose content is the name of the production information parameter
• b) prodval element whose content is the value of the parameter

Production information is used to specify, if applicable,

• a) "toc" to indicate that the document should have a table of contents. The level to which subclauses are entered is controlled by the content of the prodval element; the first number indicates the level for the body and the second number the level for the annexes. For example, to include levels H0 to H3 in the body and H1 to H2 in the annexes, the specification is:
• b) "fastpage" to indicate the page, in camera ready copy received by the ISO Central Secretariat, where the comment regarding fast tracking of a document occurs.
• c) "pprice" to indicate the number of pages on which the price of the standard is based.

  NOTE   This attribute is only used for standards in French and is the number of pages of the English edition. ISO pricing policy is to base the price of a standard on the number of technical pages in the English language edition of a standard; for this edition the number of pages is calculated automatically.

• d) "crc" to indicate the typeface of camera ready copy received by the ISO Central Secretariat.

The markup is:

C.2.16 Other information

No other information is used by ISO.

C.3  Database-oriented DTD

See the attached file-1.

C.4  Document-oriented DTD

See the attached file-2.

Annex D
(informative)
XML DTD Modules

See the attached file-3.

Annex E
(informative)
Schema module by RELAX NG (ISO/IEC 19757-2)

See the attached file-4.

The file-4 includes schema modules in accordance with RELAX NG (ISO/IEC 19757-2), which were generated from XML-DTD without datatypes. The schema modules are:

•  a) stdex.rng [root]
•  b) stdex-model.mod [Model Module]
•  c) stdex-ent.mod [Entity Module]
•  d) stdex-profile.mod [Profile Module]
•  e) isonet10.rng [Isonet Module]
•  f) stdex-base.mod [Base Element Module]
•  g) stdex-tpage.mod [Title Page]
•  h) stdex-lpage.mod [Last Cover Page]
•  i) stdex-toc.mod [Table of Contents]
•  j) stdex-index.mod [Index]
•  k) stdex-foreword.mod [Foreword]
•  l) stdex-intro.mod [Introduction]
•  m) stdex-body.mod [Body]
•  n) stdex-annex.mod [Annex]
•  o) stdex-nest.mod [Nested Subdivisions]
•  p) stdex-disp.mod [Displayed Components]
•  q) stdex-tl.mod [Terminology List Module]
•  r) stdex-inline.mod [Inline Components]
•  s) stdex-artwork.mod [Artwork Module]
•  t) stdex-ref.mod [Referential Components]
•  u) stdex-float.mod [Float Components]
•  v) stdex-figure.mod [Figure Module]
•  w) stdex-table.mod [Table]
•  x) calstab.rng [Cals Table]
•  y) stdex-specific.mod [Very Specific Components]
•  z) stdex-math.mod [Math Module]
•  aa) stdex-math-extension.mod [Math Extension Module]
•  ab) stdex-tol.mod [Tolerance]
•  ac) stdex-listing.mod [Listing Module]
•  ad) stdex-docprof.mod [Document oriented Profile Module]

The referencing relationship of the modules is illustrated in Figure E.1.

Figure E.1 — Referencing relationship of the schema module files

stdex.rng [root] +--- stdex-model.mod [Model Module] +--- stdex-ent.mod [Entity Module] +--- stdex-profile.mod [Profile Module] | +--- isonet10.rng [Isonet Module] | +--- stdex-docprof.mod [Document oriented Profile Module] +--- stdex-base.mod [Base Element Module] | +--- stdex-tpage.mod [Title Page] | +--- stdex-lpage.mod [Last Cover Page] | +--- stdex-toc.mod [Table of Contents] | +--- stdex-index.mod [Index] | +--- stdex-foreword.mod [Foreword] | +--- stdex-intro.mod [Introduction] | +--- stdex-body.mod [Body] | +--- stdex-annex.mod [Annex] | +--- stdex-nest.mod [Nested Subdivisions] | +--- stdex-disp.mod [Displayed Components] | +--- stdex-tl.mod [Terminology List] | +--- stdex-inline.mod [Inline Components] | | +--- stdex-artwork.mod [Artwork] | +--- stdex-ref.mod [Referential Components] | +--- stdex-float.mod [Float Components] | | +--- stdex-figure.dtd [Figure] | | +--- stdex-table.dtd [Table] | | +--- calstab.rng [Cals Table] | +--- stdex-specific.mod [Very Specific Components] | | +--- stdex-math.mod [Math] | | +--- stdex-math-extension.mod [Math Extension Module] | | +--- stdex-tol.mod [Tolerance] +--- stdex-listing.mod [Listing Module]

Annex F
(informative)
XSLT specification for translation to HTML

See the attached file-5.

The file-5 includes an XSLT specification for translation to HTML from an XML instance conforming to ISO/IEC TR 9573-11. Loading the XML instance to an XSLT processor and relating it to this XSLT specification makes it possible to render the XML instance on an HTML browser. It will appropriate for a preview of XML instances.

Annex G
(informative)
XSL specification for rendering an XML instance

See the attached file-6.

The file-6 includes an XSL specification for rendering an XML instance conforming to ISO/IEC TR 9573-11. The rendering conforms basically to the ISO/IEC Directives.

Annex H
(informative)
DSSSL (ISO/IEC 10179) specification for rendering an SGML instance

See the attached file-7.

The file-7 includes an DSSSL specification for rendering an XML or SGML instance conforming to ISO/IEC TR 9573-11. The rendering conforms to the ISO/IEC Directives.