Introduction to Elements

This section describes each element in the OASIS (CALS) Table Exchange table model. Although the elements are declared in different modules, they are described in alphabetical order of their tag names (i.e., element type names). The tag name is the shorter machine-readable name used in tagged documents, DTDs and schemas, and by software; for example, the tag name <oasis:row> is used for the element named Table Row (OASIS Table Model).

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

Definition

This segment provides a narrative description of the element, that is, it “defines” the element and may provide information on its usage. This is not intended to be a formal dictionary definition, but more to provide information about an element and how it may be used.

Remarks

When present, provides additional information about the element, explanations of similar or contrasting elements, or instructions for element usage (See also Related Elements described below.)

Conversion Notes are explicit and and sometimes very technical instructions to people who are mapping between this table model and the XHTML table model, or who are building conversion software to convert between another tag set and one written from this Suite. They may be more technical than a general reader will need to worry about.

Authoring Notes are usage instructions aimed at persons creating or editing journal articles according to an authoring tag set written from the NLM DTD Suite.

Implementor’s Notes are instructions written to persons creating or maintaining DTDs based on the NLM DTD Suite.

Attributes

For an element that may take attributes, this segment contains an alphabetical list of those attributes. Each line contains the identification for one attribute: first, the attribute’s name as it appears in the OASIS table model, then a longer, more descriptive name. Full attribute definitions are not provided; instead, each attribute is linked to its description in the Attribute Section, which follows the Element Description Section in this Tag Library.

Related Elements

Contains information about elements associated with the current element. For example, a <oasis:table> may be divided into header (<oasis:thead>) and table body (<oasis:tbody>) elements. In order to better understand the relationship of these components, information about all of them may be provided in the Related Elements segment for each element comprising a <oasis:table>.

Model Information

Content Model

The content model is a copy of the declaration for this element from the OASIS table model, i.e., the “content” of an element as shown in XML syntax. For those users not versed in XML syntax, a description in plain English follows.

Description

Contains a description of the “content” of the element, that is, what is allowed to be inside the element, for example, whether it may contain text, other elements, or both text and others elements in some combination. This content description contains the same information in plain English phrasing that the OASIS table model provides in XML syntax. For example, the description of an element may contain “text, numbers, and special characters”, which means it contains ordinary text. If an element contains other elements, their names are listed here.

Context Table Segment

The tag library contains a complete context table providing information about where any element can be used. This segment contains the portion of the context table relevant to the element being discussed, that is, a listing of the elements which may contain the element under discussion.

Tagged Example

Provides an excerpt of a tagged XML document, showing 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 (Implementor Information)

Names the NLM DTD Suite module in which the element is defined, in this instance, either the OASIS (CALS) Table Exchange table model (%oasis-exchange.ent;) or the OASIS XML Table Setup Module (%oasis-tablesetup.ent;)