This standard defines a set of structures (elements and attributes) that can be used to create a variety of Tag Sets for specific uses. In addition, it describes three specific Tag Sets. This document first defines all of the structures in the Tag Suite and then describes each of the three defined Tag Sets.
Each element and attribute in the Tag Suite is described in tabular form in Section 7, Tag Suite Components.
Section 7.1, Elements provides a row for each element, in which appears:
An indicator showing in which of the Tag Sets the element is used. Most elements are used in several of the Tag Sets, some are used in all of them.
The XML Name (generic identifier
or tag
) for the
element. This is the version of the element name that is used in the XML documents.
An informational name for the element. This is often a longer or more formal name than the XML Name (Tag).
The definition of the element.
Note that since the content models and available attributes of the elements may be different in each of the Tag Sets this information is not provided in Section 7, Tag Suite Components. It is provided in the sections about each of the Tag Sets (Section 8, Section 9, and Section 10).
Section 7.2, Attributes provides a row for each attribute, in which appears:
An indicator showing in which of the Tag Sets the attribute is used.
The XML Name of the attribute. This is the name of the attribute used in tagging XML documents.
An informational name for the attribute. This is often a longer or more formal name than the XML Name.
The definition of the attribute.
Note that since the attribute value type and list of allowable or recommended values for the attributes may be different in each of the Tag Sets this information is not provided in Section 7, Tag Suite Components. It is provided in the sections about each of the Tag Sets (Section 8, Section 9, and Section 10).
In Section 8, Section 9, and Section 10, the specifics of each of the Tag Sets are defined, using the same format.
Following an Introduction, which describes the specific Tag Set, are entries for the elements and then attributes in the Tag Set.
Element entries contain:
The XML Name (Tag) of the element, duplicated from Section 7, Tag Suite Components, e.g., <bio>.
The informational name of the element, duplicated from Section 7, Tag Suite Components, e.g., Biography.
The definition of the element, duplicated from Section 7, Tag Suite Components, e.g., “Biographical data concerning a contributor, usually an author or editor or the description of a collaboration. A <bio> concerns a person or group who wrote or otherwise contributed to the document.”
A list of all of the attributes the element may have in this Tag Set. In this
documentation, attribute names will be prefixed with an
at sign (@
):
…
An English-language description of the content model of the element in this Tag Set, for example:
The following in order:
<sec-meta> Section Metadata, zero or one
<label> Label (of an Equation, Figure, Reference, etc.), zero or one
Any combination of:
…
Attribute entries contain:
The XML Name of the attribute, duplicated from Section 7, Tag Suite Components.
The informational name of the attribute, duplicated from Section 7, Tag Suite Components.
The definition of the attribute, duplicated from Section 7, Tag Suite Components.
Then, for each element or group of elements in the Tag Suite in which the attribute is identically defined, there is a block of usage information. Note that:
Some attributes are used on many elements
Some attributes are used in the same way on all elements in a Tag Set, but some may have different optionality or contents on different elements in the same Tag Set.
For each usage block, the attribute entry contains:
A list of the elements for which this block of information is relevant.
A restrictions statement, which may have any of the following values:
@pppp is an optional attribute; there is no default. (where "pppp" is the XML name
of an attribute)
@pppp is required; it must be provided if the element is used. (where "pppp" is the
XML name of an attribute)
A description of the allowed contents of the attribute, which will either be a description of the type of information allowed in the attribute or a table of allowed values and their meanings. If one of the allowed values is the default an additional column (Default) will appear in the table and an X will indicate which value is the default value for this attribute in this element usage block in this Tag Set.