Structure of the Tag Library

This “Tag Library” is provided as a service to users of ANSI/NISO Z39.96-2019, JATS: Journal Article Tag Suite, wishing to incorporate the OASIS (CALS) Table Exchange table model. The Tag Library is not part of ANSI/NISO Z39.96-2019. It contains non-normative information that is intended to be helpful to users of ANSI/NISO Z39.96-2019.
The Tag Library is organized into 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:
Getting Started
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 document, and introductory material for the OASIS (CALS) Table Exchange table model. Also includes a Hierarchy Diagram, which serves as an introduction as well as a reference.
Navigation
How to move around the Tag Library pages, using the Navigation Bar (Navbar), Navbar collapse and expand arrows, page collapse/expand diamonds, and the search facility. (See Navigation.)
Structure of Tag Library
Describes the sections of the Tag Library and what can be found in each.
Introduction to OASIS (CALS) Table Exchange table model
This section provides basic information about the OASIS (CALS) Table Exchange table model, as modified by the Journal Article Tag Suite (JATS). How is the top-level <oasis:table> element structured? (See Introduction to OASIS Open Exchange (CALS) Table Model.)
Root Element
Names the <oasis:table> element as the root of this XML schema. (See Root Element.)
Hierarchy Diagram
Tree-like graphical representation of the <oasis:table> element. This provides a fast, visual way to determine the structure of an OASIS table and its components. (See Hierarchy Diagrams.)
Elements
Descriptions of the elements used in the OASIS (CALS) Table Exchange table model. The elements are listed in order by tag name. (For information on how each Element page is organized, see Introduction to Elements.)
Attributes
Descriptions of the attributes in the OASIS (CALS) Table Exchange table model. 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 an OASIS table element, attribute, an element’s context, and related information:
  • Index: Like a back-of-the-book Index: a list of OASIS table elements, attributes, parameter entities, and discussion topics linked to their Tag Library locations. The Index includes alternative words linked to the equivalent OASIS table term. (Non-OASIS term to OASIS term translation: for example, the term “table cell” will direct you to use the OASIS table element Table Entry (OASIS Table Model).) (Click on “Index” under “Finding Information in Tag Library” in the Navbar.)
  • Element Context Table: A table of where an element may be used. Provides, for each element, all the elements that can directly contain it. This is how to find out whether an element can be used in a particular context. (Click on “Element Context Table” under “Finding Information in Tag Library” in the Navbar.)
    Context information is also available on each Element page under the subheading “May be contained in” (within “Models and Context”).
Supporting Documentation Home
A link to the main JATS supporting information resource.
Using the Tag Library to Learn This Table Model
If you want to learn about the elements and the attributes in the OASIS (CALS) table model so you can tag an OASIS table, 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 Diagram, read the “Key to Near & Far® Diagrams”.
  • Scan the Hierarchy Diagram to get a good sense of the <oasis:table> element’s contents. (For example, find what is inside an <oasis:tgroup> or an <oasis:thead>.)
  • Pick an element from the diagram. (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.)
Terms and Definitions
Element
Elements are nouns, like “row” and “entry”, that represent components of the OASIS table.
Attribute
Attributes hold facts about an element, such as which type of alignment (e.g., centered, flush left, or justified) is being requested when using the Table Entry (OASIS Table Model) (<oasis:entry>) tag. Each attribute has both a name (e.g., @align) and a value (e.g., “center”).
Tag Library Typographic Conventions
<oasis:tbody> The tag name of an element (written in lower case with the entire name surrounded by “< >”)
Table Body (OASIS Table Model) 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