Structure of the Tag Library
This “Tag Library” is provided as a service to users of ANSI/NISO Z39.96-2021, JATS: Journal Article Tag Suite; the Tag Library is not part of ANSI/NISO Z39.96-2021. It contains non-normative information that is intended to be helpful to users of ANSI/NISO Z39.96-2021.
The Tag Library is organized onto a number of chapters, each divided into sections (which may also be divided into further sections). Navigation around the Tag Library is through the Navigation Panel (Navbar) and through numerous direct links between related components.
The table below outlines the structure and chapters (with their subsections) of this document:
Basic information for first time users and reference for experienced users, this chapter describes the Tag Library document, how to navigate around the web pages of the complex document, and introductory material for the Archiving Tag Set. Also includes the Hierarchy Diagrams, which are useful as introductions as well as reference.
Descriptions of the elements used in the Archiving Tag Set. The elements are listed in order by tag name. (For information on how each Element page is organized, see Introduction to Elements.)
Descriptions of the attributes in the Archiving Tag Set. Attributes are listed in order by the name used in tagging documents and in the schemas. (For information on how each Attribute page is organized, see Introduction to Attributes.)
Finding Information in Tag Library
Contains two aids for locating a JATS element, attribute, an element’s context, and related information:
How to use this Tag Set: descriptions and guidance for specific tagging issues. (See Tagging Documents.)
Provides material for implementors and people modifying or installing the Tag Set (See Technical Details.)
Supporting Documentation Home
The Archiving and Interchange 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.
Using the Tag Library to Learn This Tag Set
If you want to learn about the elements and the attributes in this Tag Set so you can tag documents or learn how the archiving article model is constructed, here is a good way to start.
- Read the Tag Library General Introduction, taking particular note of the next section that describes the parts of the Tag Library so you will know what resources are available.
- Next, if you do not know the symbols used in the Hierarchy Diagrams, read the “Key to the Near & Far® Diagrams”.
- Scan the Hierarchy Diagrams to get a good sense of the top-level elements and their contents. (Find what is inside an <article>, now what is inside each of the four large pieces of an article, keep working your way down.)
- Pick an element from one of the diagrams. (Look up the element in the Elements Section to find the full element, the definition, usage notes, content allowed inside the element, where the element may be used, and a list of any attributes. Look up one of the attributes to find its full name, usage notes, potential values, and whether it has a default.)
Finally, if you are interested in conversion from a particular source:
- Look at an article in a printed or online journal (and look at the DTD/schema for
the other journal if there is one).
- Can all the information you want to store from an article fit into the models shown in the diagrams?
- Do you have, or know how to get, all the information the models require? Will that information always be available for documents that are complete and correct?
- How difficult will it be to identify the parts of the information using the elements and attributes described in these models? Would changes to one or more models make this easier?
- Now look at some non-article content, such as a news column, a book review, or some letters to the editor. Are there tags to handle all these article types and all their components?
Terms and Definitions
Elements are nouns, like “speech” and “speaker”, that represent components of journal articles, the articles themselves, and accompanying metadata.
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”).
Data about the data, for example, bibliographic information. The distinction is between metadata elements which describe an article (such as the name of the journal in which an article was published or the article title) versus elements which contain the textual and graphical content of the article.
Tag Library Typographic Conventions
|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)
|The “@” sign before a name indicates an attribute name.
|Emphasis to stress a point