This section describes each attribute used in the Journal Archiving and Interchange DTD and the Archiving and Interchange DTD Suite modules. The attributes have not been separated by module, but are displayed all together in alphabetical order by their DTD names. The DTD name is the shorter machine-readable name used in the tagging of a document, in the DTD, and by the software. For example, the attribute name corresp instead of the “Corresponding Author.
There is one HTML page per attribute. The title at the top of each attribute page gives the attribute’s name as it appears in a tagged document or in the DTD, followed by the attribute’s descriptive name. The rest of the attribute page contains multiple sections which describe aspects of the attribute, its usage, and the elements to which it can be attached. These sections always appear in the following order, although any given attribute page may not contain every section:
|
Definition |
Narrative description of the attribute. This is not a formal, dictionary definition, but more an explanation of what the attribute means, what question it asks, or how it can be used. |
|
Usage |
Explanation of the expected uses for the attribute such as when or why it might be used or how to determine its value |
|
Remarks |
Additional useful information about the attribute |
|
Values |
This section performs two functions: 1) naming the elements which can take this attribute and 2) describing the values and defaults for the attribute. Elements. The elements that may take this 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 an attribute can be used in more than one way or with several slightly different meanings, there may be more than one “In elements:” section, each 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, which lists and/or explains the possible values of the attribute. When the attribute originates in this DTD Suite, the Values section also explains the meaning of each value. Elements defined in the MathML DTD, for example, do not have their values explained, since those values are not under control of this Suite and may change. Each row in the table describes one value. The column titled “Value” names or describes the value, and the column titled “Meaning” specifies the meaning of the attribute value or describes what an XML application might do with the attribute value. The last row of the table indicates the default value of the attribute, if any, or whether or not the attribute must be supplied when the element is used or is optional and may be supplied. The row begins with the word “Restriction:”. |