The Article Authoring Tag Set (Authoring
) creates a standardized format for new journal articles that
can be used by authors to submit publications to journals and to archives such as
PubMed
Central. While in theory the document scope is the same as for the Publishing Tag
Set, in
practice Authoring defines elements and attributes that describe the content of typical
research-style journal articles.
This is a Tag Set optimized for authorship of new journal articles, where regularization and control of content is important, and where it is useful rather than harmful to have only one way to tag a structure. Therefore, Authoring is more prescriptive than descriptive and includes many elements whose content must occur in a specified order.
Since an author is assumed to be creating and submitting an article for submission to a journal or journals, no publishing history or journal-specific information has been included in this Authoring Tag Set.
Since no assumptions can be made concerning the processing software or editorial situation that will receive an article authored in this Tag Set, tagging that forces specific formatting has also been avoided. There is no way for an author to number his/her lists explicitly, for example, or to manually number the cited references, since many journals have their own citation policies and publication styles. Numbers for the cited references must be generated by the publisher’s software to match editorial policy and established practice.
By design, this is a model for journal articles, such as the typical research article found in an STM journal, and not a model for complete journals. This Tag Set does not include an overarching model for a collection of articles. In addition, the following journal material is not described by this Tag Set:
Company, product, or service display advertising
Job search or classified advertising
Calendars, meeting schedules, and conference announcements (except as these can be tagged as ordinary articles, sub-articles, or sections within articles)
Material specific to an individual journal, such as Author Guidelines, Policy and Scope statements, editorial or advisory boards, detailed indicia, etc.
The Article Authoring Tag Set defines a document that is a top-level component of a journal such as an article, a book or product review, or a letter to the editor. Each such document is composed of one or more parts; if there is more than one part, they must appear in the following order:
Front matter (required). The article front matter contains the metadata for the article (also called article header information), for example, the article title, the names of the contributor(s), and the abstract. This is not textual front matter as appears in books, rather this is bibliographic information about the article.
Body of the article (required). The body of the article is the main textual and graphic content of the article. This usually consists of paragraphs and sections, which may themselves contain figures, tables, sidebars (boxed text), etc.
Back matter for the article (optional). If present, the article back matter contains information that is ancillary to the main text, such as a glossary, appendix, or list of cited references.
Each element in the Tag Set is listed and identified, and specifics of the model of the element in this Tag Set are provided.
Each element is identified with a <tag>, element name, and definition, as it is listed in Section 7, Tag Suite Components. Following that appears the modeling information specific to this Tag Set:
any attributes the element may have in this Tag Set, including:
the attribute name and
the attribute’s informal expanded name
the element’s content model, described in narrative form, in which:
the relationships among elements or groups of elements are specified, for
example, Any combination of
if the structures may occur in any sequence, or The following, in order
if the structures must appear in the specified sequence
the elements are identified by their <tag>s and Element Names
notes indicating occurrence:
if the relationship indicator is Any combination of
any of the elements therein may occur zero or more times in any sequence
if there is any other relationship indicator, it is assumed that an element must occur,
and may occur only once unless there is a statement otherwise. Such statement may
be zero or one
, one or more
, or zero or more
.
Note that for the convenience of the user these models are provided as XML DTDs, W3C XML Schemas (XSD), and as RELAX NG Schemas (RNG), which may be found at http://jats.nlm.nih.gov.
10.4.1 <abbrev> Abbreviation or Acronym
10.4.3 <access-date> Access Date for Cited Work
10.4.5 <addr-line> Address Line
10.4.6 <address> Address/Contact Information
10.4.8 <aff-alternatives> Affiliation Alternatives
10.4.9 <ali:free_to_read> Free to Read (NISO Access License and Indicators)
10.4.10 <ali:license_ref> License Reference (NISO Access License and Indicators)
10.4.11 <alt-text> Alternate Text Name (for a figure, etc.)
10.4.12 <alternatives> Alternatives For Processing
10.4.13 <annotation> Annotation in a Citation
10.4.16 <app-group> Appendix Group
10.4.18 <article-meta> Article Metadata
10.4.19 <article-title> Article Title
10.4.21 <author-comment> Author Comment
10.4.22 <award-group> Award Group
10.4.23 <award-id> Award Identifier
10.4.26 <body> Body of the Document
10.4.28 <boxed-text> Boxed Text
10.4.30 <caption> Caption of a Figure, Table, etc.
10.4.31 <chapter-title> Chapter Title in a Citation
10.4.32 <chem-struct> Chemical Structure (Display)
10.4.33 <chem-struct-wrap> Chemical Structure Wrapper
10.4.34 <citation-alternatives> Citation Alternatives
10.4.37 <col> Table Column (NISO JATS table model)
10.4.38 <colgroup> Table Column Group (NISO JATS table model)
10.4.39 <collab> Collaborative (Group) Author
10.4.40 <collab-alternatives> Collaboration Alternatives
10.4.41 <comment> Comment in a Citation
10.4.42 <compound-kwd> Compound Keyword
10.4.43 <compound-kwd-part> Compound Keyword Part
10.4.44 <conf-acronym> Conference Acronym
10.4.45 <conf-date> Conference Date
10.4.46 <conf-loc> Conference Location
10.4.47 <conf-name> Conference Name
10.4.48 <conf-num> Conference Number
10.4.49 <conf-sponsor> Conference Sponsor
10.4.50 <conf-theme> Conference Theme
10.4.51 <conference> Conference Information
10.4.53 <contrib-group> Contributor Group
10.4.54 <contrib-id> Contributor Identifier
10.4.55 <copyright-holder> Copyright Holder
10.4.56 <copyright-statement> Copyright Statement
10.4.57 <copyright-year> Copyright Year
10.4.58 <country> Country: in an Address
10.4.59 <data-title> Data Title
10.4.61 <date-in-citation> Date within a Citation
10.4.63 <def> Definition List: Definition
10.4.64 <def-head> Definition List: Definition Head
10.4.65 <def-item> Definition List: Definition Item
10.4.66 <def-list> Definition List
10.4.68 <disp-formula> Formula, Display
10.4.69 <disp-formula-group> Formula, Display Group
10.4.70 <disp-quote> Quote, Displayed
10.4.71 <edition> Edition Statement, Cited
10.4.72 <element-citation> Element Citation
10.4.73 <elocation-id> Electronic Location Identifier
10.4.77 <ext-link> External Link
10.4.78 <fax> Fax Number: in an Address
10.4.80 <fixed-case> Fixed Case
10.4.82 <fn-group> Footnote Group
10.4.85 <funding-group> Funding Group
10.4.86 <funding-source> Funding Source
10.4.87 <funding-statement> Funding Statement
10.4.88 <given-names> Given (First) Names
10.4.89 <glossary> Glossary Elements List
10.4.90 <glyph-data> Glyph Data for a Private Character
10.4.91 <glyph-ref> Glyph Reference for a Private Character
10.4.92 <gov> Government Report, Cited
10.4.95 <inline-formula> Formula, Inline
10.4.96 <inline-graphic> Graphic, Inline
10.4.97 <inline-supplementary-material> Inline Supplementary Material Metadata
10.4.98 <institution> Institution Name: in an Address
10.4.99 <institution-id> Institution Identifier
10.4.100 <institution-wrap> Institution Wrapper
10.4.103 <issn-l> ISSN-L (Linking ISSN)
10.4.105 <issue-id> Issue Identifier
10.4.106 <issue-part> Issue Part
10.4.107 <issue-title> Issue Title
10.4.109 <journal-id> Journal Identifier
10.4.111 <kwd-group> Keyword Group
10.4.112 <label> Label (of an Equation, Figure, Reference, etc.)
10.4.113 <license> License Information
10.4.114 <license-p> License Paragraph
10.4.116 <list-item> List Item
10.4.117 <long-desc> Long Description
10.4.120 <mixed-citation> Mixed Citation
10.4.121 <mml:math> Math (MathML Tag Set)
10.4.122 <monospace> Monospace Text (Typewriter Text)
10.4.124 <name> Name of Person
10.4.125 <name-alternatives> Name Alternatives
10.4.126 <named-content> Named Special (Subject) Content
10.4.127 <nested-kwd> Nested Keyword
10.4.128 <nlm-citation> NLM Citation
10.4.129 <object-id> Object Identifier
10.4.130 <on-behalf-of> On Behalf of
10.4.131 <open-access> Open Access
10.4.134 <page-count> Page Count
10.4.135 <page-range> Page Ranges
10.4.136 <part-title> Part Title in a Citation
10.4.137 <patent> Patent Number, Cited
10.4.138 <permissions> Permissions
10.4.139 <person-group> Person Group for a Cited Publication
10.4.140 <phone> Phone Number: in an Address
10.4.141 <postal-code> Postal Code
10.4.143 <preformat> Preformatted Text
10.4.145 <principal-award-recipient> Principal Award Recipient
10.4.146 <principal-investigator> Principal Investigator
10.4.147 <private-char> Private Character (Custom or Unicode)
10.4.148 <product> Product Information
10.4.149 <pub-id> Publication Identifier for a Cited Publication
10.4.150 <publisher-loc> Publisher’s Location
10.4.151 <publisher-name> Publisher’s Name
10.4.154 <ref-list> Reference List (Bibliographic)
10.4.155 <related-article> Related Article Information
10.4.156 <related-object> Related Object Information
10.4.157 <role> Role or Function Title of Contributor
10.4.159 <rt> Ruby Textual Annotation
10.4.160 <ruby> Ruby Annotation Wrapper
10.4.161 <sans-serif> Sans Serif
10.4.165 <self-uri> URI for This Same Article Online
10.4.171 <state> State or Province
10.4.172 <statement> Statement, Formal
10.4.173 <std> Standard, Cited
10.4.174 <std-organization> Standards Organization
10.4.175 <strike> Strike Through
10.4.176 <string-name> Name of Person (Unstructured)
10.4.177 <styled-content> Styled Special (Subject) Content
10.4.179 <subtitle> Document Subtitle
10.4.182 <supplement> Supplement Information
10.4.183 <supplementary-material> Supplementary Material Metadata
10.4.185 <table> Table (NISO JATS table model)
10.4.186 <table-wrap> Table Wrapper
10.4.187 <table-wrap-foot> Table Wrapper Footer
10.4.188 <target> Target of an Internal Link
10.4.189 <tbody> Table Body (NISO JATS table model)
10.4.190 <td> Table Data Cell (NISO JATS table model)
10.4.191 <term> Definition List: Term
10.4.192 <term-head> Definition List: Term Head
10.4.193 <textual-form> Textual Form
10.4.194 <tfoot> Table Footer (NISO JATS table model)
10.4.195 <th> Table Header Cell (NISO JATS table model)
10.4.196 <thead> Table Header (NISO JATS table model)
10.4.197 <time-stamp> Time Stamp for Cited Work
10.4.199 <title-group> Title Group
10.4.200 <tr> Table Row (NISO JATS table model)
10.4.201 <trans-source> Translated Source
10.4.202 <trans-title> Translated Title
10.4.203 <underline> Underline
10.4.204 <uri> Uniform Resource Identifier (URI)
10.4.205 <verse-group> Verse Form for Poetry
10.4.206 <verse-line> Line of a Verse
10.4.207 <version> Version Statement
10.4.208 <volume> Volume Number
10.4.209 <volume-id> Volume Identifier
10.4.210 <volume-series> Volume Series
Each attribute in the Tag Set is listed and identified, and specifics of the model of the attribute in this Tag Set are provided.
Each attribute is identified with a name, expanded information name, and definition,
as it is
listed in Section 7, Tag Suite Components. For some attributes a Usage
section provides additional information on how the attribute is intended to be used
or interpreted.
Following that appears the modeling information specific to this Tag Set. For attributes that are associated with only one element, or for which the usage is the same for all elements in the Tag Set, there appears:
a list of all of the elements associated with the attribute,
an optionality description:
this attribute may be used if the element is used
means the attribute
is optional;
this attribute must be used if the element is used
means the
attribute is required;
this attribute must have the
value …
means that the attribute has a fixed value.
a table showing the allowed value(s) of the attribute and describing the meaning of each value. If there is a default value, that value appears in bold.
If there is more than one element associated with an attribute in the Tag Set and those elements use the attribute differently (for example, one element provides a default value for the attribute and on other elements there is no default value), the specifics are repeated for each group of elements that has the same usage and values for the attribute.
10.5.1 @abbr Abbreviation (NISO JATS table model)
10.5.2 @abstract-type Type of Abstract
10.5.3 @align Horizontal Alignment (NISO JATS table model)
10.5.5 @arrange Arrangement of Subscripts and Superscripts
10.5.6 @article-type Type of Article
10.5.7 @assigning-authority Authority Responsible for an Identifier
10.5.8 @authenticated Authenticated
10.5.9 @award-type Type of Award
10.5.10 @axis Axis (NISO JATS table model)
10.5.11 @baseline-shift Baseline Shift
10.5.12 @border Border (Frame) around a Table (NISO JATS table model)
10.5.14 @cellpadding Cell Padding (NISO JATS table model)
10.5.15 @cellspacing Cell Spacing (NISO JATS table model)
10.5.16 @char Table Cell Alignment Character (NISO JATS table model)
10.5.17 @charoff Table Character Offset (NISO JATS table model)
10.5.18 @code-type Type of Code
10.5.19 @code-version Code Version
10.5.20 @collab-type Type of Collaboration
10.5.21 @colspan Column Span (NISO JATS table model)
10.5.22 @content-type Type of Content
10.5.23 @continued-from Continued From
10.5.24 @contrib-id-type Contributor Identifier Type
10.5.25 @contrib-type Type of Contribution
10.5.26 @corresp Corresponding Author
10.5.30 @date-type Type of Date
10.5.32 @description Description of a Private Character
10.5.33 @designator Designator of the Edition
10.5.34 @document-id Document Identifier
10.5.35 @document-id-type Document Identifier Type
10.5.36 @document-type Document Type
10.5.37 @dtd-version Version of the Tag Set (DTD)
10.5.38 @elocation-id Elocation Identifier
10.5.40 @equal-contrib Equal Contribution
10.5.41 @executable Executable
10.5.42 @ext-link-type Type of External Link
10.5.43 @fig-type Type of Figure
10.5.44 @fn-type Type of Footnote
10.5.45 @fontchar Font Character Table Offset
10.5.48 @frame Frame (NISO JATS table model)
10.5.49 @glyph-data Glyph Data Character Being Referenced
10.5.50 @headers Headers (NISO JATS table model)
10.5.51 @id Document Internal Identifier
10.5.52 @initials Initials for Personal Names
10.5.53 @institution-id-type Type of Institution Identifier
10.5.54 @iso-8601-date ISO-8601 Formatted Date
10.5.55 @issue Issue Number of a Related Article
10.5.56 @journal-id Journal Identifier of a Related Article
10.5.57 @journal-id-type Type of Journal Identifier
10.5.58 @kwd-group-type Keyword Authority
10.5.59 @language Code Language
10.5.60 @language-version Code Language Version
10.5.61 @license-type Type of License
10.5.62 @link-type Type of Link (for a Related Object)
10.5.63 @list-content List Content
10.5.64 @list-type Type of List
10.5.65 @mime-subtype Mime Subtype
10.5.67 @name Name (Private Character)
10.5.68 @name-style Name Style
10.5.69 @object-id Object Identifier
10.5.70 @object-id-type Object Identifier Type
10.5.71 @object-type Object Type
10.5.72 @orientation Orientation
10.5.73 @page Page of Related Article
10.5.74 @person-group-type Type of People in the Person Group
10.5.77 @prefix-word Prefix Word (For a List Item)
10.5.78 @preformat-type Type of Preformatted Text
10.5.79 @product-type Type of Product
10.5.80 @pub-id-type Type of Publication Identifier
10.5.81 @publication-format Format of Publication
10.5.82 @publication-type Type of Referenced Publication
10.5.83 @publisher-type Type of Publisher
10.5.84 @pub-type Type of Publication
10.5.85 @ref-type Type of Cross-Reference
10.5.86 @related-article-type Type of Related Article
10.5.87 @resolution Resolution of the Glyph Bitmap
10.5.88 @rid Reference to an Identifier
10.5.89 @rowspan Row Span (NISO JATS table model)
10.5.90 @rules Rules (NISO JATS table model)
10.5.91 @scope Scope (NISO JATS table model)
10.5.92 @sec-type Type of Section
10.5.94 @source-id Source Identifier
10.5.95 @source-id-type Source Identifier Type
10.5.96 @source-type Source Type
10.5.97 @span Span (NISO JATS table model)
10.5.98 @specific-use Specific Use
10.5.99 @start_date Start Date
10.5.100 @style Style (NISO JATS table model; MathML Tag Set)
10.5.101 @style-type Style Type
10.5.102 @summary Summary (NISO JATS table model)
10.5.103 @supplement-type Type of Supplement
10.5.104 @target-type Type of Target
10.5.105 @toggle Toggle Switch
10.5.107 @valign Vertical Alignment (NISO JATS table model)
10.5.108 @vol Volume of Related Article
10.5.109 @width Width (NISO JATS table model)
10.5.110 @xlink:actuate Actuating the Link
10.5.111 @xlink:href Href (Linking Mechanism)
10.5.112 @xlink:role Role of the Link
10.5.113 @xlink:show Showing the Link
10.5.114 @xlink:title Title of the Link
10.5.115 @xlink:type Type of Link
10.5.118 @xmlns:ali NISO ALI Namespace (NISO Access License and Indicators)
10.5.119 @xmlns:mml MathML Namespace Declaration
10.5.120 @xmlns:xlink XLink Namespace Declaration
10.5.121 @xmlns:xsi XML Schema Namespace Declaration