Element |
Elements are nouns, like “speech” and “speaker”, that
represent components of journal articles, the articles themselves, and accompanying
metadata.
|
Attribute |
Attributes hold facts about an element, such as which type of list (e.g., numbered,
bulleted, or plain) is being requested when using the List (<list>) tag, or the name of a
pointer to an external file that contains an image. Each attribute has both a name (e.g.,
@list-type) and a value (e.g.,
“bullet”).
|
Metadata |
Data about the data, for example, bibliographic
information. The distinction is between metadata elements which describe an article (such as author and the title of the article) versus elements which
contain the textual and graphical content of the article.
|
How To Use (Read Me First) |
How to make best use of this Tag Library to reference XML tags, become familiar with
the Authoring Tag Set as a whole, or see examples of recommended usage.
|
Root Element |
Naming the <article> element as the root of this XML schema (DTD, XSD, RNG).
|
General Introduction |
This introduction to the contents of this Tag Library, to the design
philosophy and intended usage of the JATS DTD Suite, and to the Article Authoring Tag Set.
|
Selecting a Model & Schema |
Describing the variant Archiving schemas and how to choose the right one for your implementation.
|
Elements Section |
Descriptions of the elements used in the Article Authoring Tag Set and the parts of the
JATS DTD Suite used in this Tag Set. The element descriptions are listed in
alphabetical order by tag name.
[Note: Each element has two names: a “tag name” (formally called an
element-type name) that is used in tagged documents, in the DTDs/schemas, and by XML
software; and an “element name” (usually longer) that provides a fuller, more
descriptive name for the benefit of human readers. For example, a tag name might be
<disp-quote> with the corresponding element
name Quote, Displayed, or a tag name might be
<verse-group> with the corresponding element
name Verse Form for Poetry.]
|
Attributes Section |
Descriptions of the attributes in the Article Authoring Tag Set. Like elements,
attributes also have two names: the shorter machine-readable one and a (usually longer)
human-readable one. Attributes are listed in order by the shorter, machine-readable names.
For example, the attribute short name @list-type instead of the more informal, easier to read: Type of List.
|
Parameter Entity Section |
Names (with occasional descriptions) and contents of the parameter entities in the Tag
Set modules.
|
Document Hierarchy Diagrams |
Tree-like graphical representations of the content of many elements. This can be a
fast, visual way to determine the structure of an article or of any element within an
article.
|
Full Article Sample |
One full article is provided in both PDF format and in XML according to this Tag Set.
This is provided to help users understand the relationship between the article as displayed
and the XML version of the article.
|
Common Tagging Practice |
Tips, tricks, hints, and examples of how (and why) to tag certain structures using this
Tag Set.
|
Accessibility |
Brief description of how NISO JATS approaches the 508 and WCAG 2.0 Accessibility
issues.
|
Implementing This Tag Set |
Implementor’s instructions for using this Tag Set, customizing this Tag Set, or
making derivative tag sets based on this one.
|
Version 1.1d2 Change Report |
Pointer to the description of the changes made in response to the public comments on the ANSI/NISO
JATS 1.1d1 prior to October 2014, that resulted in this Committee Draft NISO JATS 1.1d2 Tag Set.
|
Context Table |
A listing of where each element may be used. All elements in this Tag Set are given in a
single alphabetical list.
The Context Table is formatted in two columns. The first column (“This
Element”) names an element, with the name shown in pointy brackets. In the second
column (“May Be Contained In”) for each element is an alphabetical list of
all the elements in which the first column element may occur. For example, if the first
column contains the element <front> and the
second column contains only the <article>
element, this means that the <front> element
may only be used directly inside an <article>.
Most elements may be used inside more than one other element. For example, the element
<def> (a definition) may be used inside the
<abbrev> and the <def-item> elements.
The Context Table contains the same information that is found on each element
page under the heading “This element may be contained in:”.
|
Index |
Where to find elements, tags, and terms used in this Tag Library. Includes synonyms
(terms not used in this Tag Set) that direct the reader to
elements used in this Tag Library, for example, “author” is paired with
Contributor <contrib>.
|
Supporting Documentation Home |
The Article Authoring Tag Set is available in three forms: an XML Document Type
Definition (DTD); a W3C XML Schema (XSD); and a RELAX NG Schema (RNG). Each of these formats
is available in two forms: a zipped file containing a downloadable version of the schema
(often in multiple files), and a readable/browsable version in which the internal markup has
been escaped.
|
<alt-text> | The tag name of an element (written in lower case with the entire name surrounded by “< >”) |
Alternate Text Name (for a figure, etc.) | The element name (long descriptive name of an element) or the descriptive name of an attribute (written in title case, with important words capitalized, and the words separated by spaces) |
@name | The “@” sign before a name indicates an attribute name. |
must not | Emphasis to stress a point |