Definition |
Contains a narrative description of the attribute. This is not a formal dictionary
definition, but more an explanation of what the attribute means, what type of information it
provides, or how it can be used.
|
Usage |
Discusses expected uses for the attribute, such as when or why it might be used or how
to determine its value
|
Remarks |
Provides additional information about the attribute, such as similar or contrasting
attributes, processing information, or material about the base element
Implementor’s Notes are instructions written to persons creating or maintaining
Tag Sets and schemas based on the Suite.
|
Values |
Performs three functions:
Elements — The elements that may take the
attribute are named following the phrase “In elements:”. For each element,
both the tag name (the shorter element type name) and the longer descriptive name are given.
If the attribute can be used in more than one way, or with several slightly different
meanings, there will be more than one “In elements:” section. Each “In
elements:” section is followed by a value table that describes the attribute’s
values when it is used with the specific elements just listed. For example, the attribute may
have exactly the same meaning whenever it is used, but sometimes it is required while other
times it is optional, so there will be two “In elements:” sections, one naming
all the elements for which the attribute is required, and one naming all the elements for
which the attribute is optional.
Values — Following each “In
elements:” section is an Attribute Value Table that lists the possible values of the
attribute and explains selected values. When the attribute originates in the Authoring Tag
Set or the base Suite, the Values table also explains the meaning of each value. Attributes
defined in PUBLIC tag sets that have been incorporated into the Authoring Tag Set or base
Suite (such as the MathML Tag Set) do not have their values explained, since those values are
not established in this Tag Set and may change without notice.
The Attribute Value Table typically contains two columns although a third column titled
“Behavior” may be present. Each row in the table describes one value, where:
The last row of the table begins with the word “Restriction:”. This row
indicates whether the attribute must be supplied when the
relevant element is used or is optional and may be supplied.
A default value, if any exists, is also provided.
Suggested Values — For those attributes whose
value is defined as text (letters, numbers, or special characters), this Tag Set does not
enforce any particular value(s), but a list of suggested values may be provided.
|
Article Authoring Tag Library NISO JATS Draft Version 1.1d2
Version of December 2014