Introduction to Elements

This section describes each element in the Journal Publishing DTD. The elements have not been separated by module but are displayed together alphabetically, in the order of their tag names (element type names). The tag name is the shorter machine-readable name used in the tagged documents, the DTD fragments, and by the software, for example, the tag name <p> is used for the element named Paragraph.

Each element description is a separate HTML page. The heading for the page names the element’s tag name, followed by its longer descriptive name. The rest of the element description page describes aspects of the element and its usage. These sections of the page always appear in the following order, although any given element description may not contain all of the sections:

Definition

Narrative description of the element. This paragraph defines the element and may provide information on how the element should be used. This is not intended to be a formal dictionary definition but more to provide information that explains an element and how it may be used.

Remarks

For some elements, this section provides additional information about the element, related or contrasting elements, or element usage.

Conversion Notes are explicit and sometimes very technical instructions to people who are mapping between this DTD and other DTDs, or who are building conversion software to convert between another DTD and one of the DTDs written from this DTD Suite. They may be more technical than a general reader will understand.

Authoring Notes are usage instructions aimed at persons writing or editing journal articles according to an authoring DTD written from this DTD Suite.

Attributes

Names the attributes that may be used with this element.

Note: This section is only present for elements that may take attributes.

An element is usually a structural or metadata component of a document. An attribute contains additional information about that component. This section contains an alphabetical list of the element’s attributes. Each line contains the identification of one attribute: first, the attribute’s name as it appears in the DTD, and then a longer, more descriptive name.

Only the names of the attributes are given in this section. Full attribute definitions are provided in a separate Attribute Section, which follows the Element Description Section in this Tag Library.

Description

This section contains a description of the “content” of the element, that is, what is allowed to be inside the element, for example, does it contain text, other elements, both text and other elements? This content description contains the same information in plain English words that the DTD has in XML syntax. For example, the description of an element may contain “text, numbers, and special characters”, which means it contains text. If an element contains other elements, their names are listed here.

Tagged Example

Excerpt of a tagged XML document, showing the use of the current element. Usually an element is shown in context, with its surrounding elements, and the current element is highlighted in bold.

Module

Name of the DTD Suite module in which the element is defined.