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); and
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 5 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
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 (RNGs), ), which may be found at http://jats.nlm.nih.gov.
8.4.1 <abbrev> Abbreviation or Acronym
8.4.3 <access-date> Access Date for Cited Work
8.4.5 <addr-line> Address Line
8.4.6 <address> Address/Contact Information
8.4.8 <aff-alternatives> Affiliation Alternatives
8.4.9 <alt-text> Alternate Text Name (For a Figure, etc.)
8.4.10 <alternatives> Alternatives For Processing
8.4.11 <annotation> Annotation in a Citation
8.4.14 <app-group> Appendix Group
8.4.16 <article-meta> Article Metadata
8.4.17 <article-title> Article Title
8.4.19 <author-comment> Author Comment
8.4.20 <award-group> Award Group
8.4.21 <award-id> Award Identifier
8.4.24 <body> Body of the Document
8.4.26 <boxed-text> Boxed Text
8.4.28 <caption> Caption of a Figure, Table, etc.
8.4.29 <chapter-title> Chapter Title in a Citation
8.4.30 <chem-struct> Chemical Structure (Display)
8.4.31 <chem-struct-wrap> Chemical Structure Wrapper
8.4.32 <col> Table Column (XHTML table model)
8.4.33 <colgroup> Table Column Group (XHTML table model)
8.4.34 <collab> Collaborative (Group) Author
8.4.35 <comment> Comment in a Citation
8.4.36 <compound-kwd> Compound Keyword
8.4.37 <compound-kwd-part> Compound Keyword Part
8.4.38 <conf-acronym> Conference Acronym
8.4.39 <conf-date> Conference Date
8.4.40 <conf-loc> Conference Location
8.4.41 <conf-name> Conference Name
8.4.42 <conf-num> Conference Number
8.4.43 <conf-sponsor> Conference Sponsor
8.4.44 <conf-theme> Conference Theme
8.4.45 <conference> Conference Information
8.4.47 <contrib-group> Contributor Group
8.4.48 <copyright-holder> Copyright Holder
8.4.49 <copyright-statement> Copyright Statement
8.4.50 <copyright-year> Copyright Year
8.4.51 <country> Country: in an Address
8.4.53 <date-in-citation> Date within a Citation
8.4.55 <def> Definition List: Definition
8.4.56 <def-head> Definition List: Definition Head
8.4.57 <def-item> Definition List: Definition Item
8.4.58 <def-list> Definition List
8.4.60 <disp-formula> Formula, Display
8.4.61 <disp-formula-group> Formula, Display Group
8.4.62 <disp-quote> Quote, Displayed
8.4.63 <edition> Edition, Cited
8.4.64 <element-citation> Element Citation
8.4.65 <elocation-id> Electronic Location Identifier
8.4.68 <ext-link> External Link
8.4.69 <fax> Fax Number: in an Address
8.4.72 <fn-group> Footnote Group
8.4.75 <funding-group> Funding Group
8.4.76 <funding-source> Funding Source
8.4.77 <funding-statement> Funding Statement
8.4.78 <given-names> Given (First) Names
8.4.79 <glossary> Glossary Elements List
8.4.80 <glyph-data> Glyph Data for a Private Character
8.4.81 <glyph-ref> Glyph Reference for a Private Character
8.4.82 <gov> Government Report, Cited
8.4.85 <inline-formula> Formula, Inline
8.4.86 <inline-graphic> Graphic, Inline
8.4.87 <inline-supplementary-material> Inline Supplementary Material
8.4.88 <institution> Institution Name: in an Address
8.4.92 <issue-id> Issue Identifier
8.4.93 <issue-part> Issue Part
8.4.94 <issue-title> Issue Title
8.4.96 <journal-id> Journal Identifier
8.4.98 <kwd-group> Keyword Group
8.4.99 <label> Label (of an Equation, Figure, Reference, etc.)
8.4.100 <license> License Information
8.4.101 <license-p> License Paragraph
8.4.104 <long-desc> Long Description
8.4.107 <mixed-citation> Mixed Citation
8.4.108 <mml:math> Math (MathML 2.0 Tag Set)
8.4.109 <monospace> Monospace Text (Typewriter Text)
8.4.112 <name-alternatives> Name Alternatives
8.4.113 <named-content> Named Special (Subject) Content
8.4.114 <nlm-citation> NLM Citation
8.4.115 <object-id> Object Identifier
8.4.116 <on-behalf-of> On Behalf of
8.4.117 <open-access> Open Access
8.4.120 <page-count> Page Count
8.4.121 <page-range> Page Ranges
8.4.122 <part-title> Part Title in a Citation
8.4.123 <patent> Patent Number, Cited
8.4.124 <permissions> Permissions
8.4.125 <person-group> Person Group for a Cited Publication
8.4.126 <phone> Phone Number: in an Address
8.4.128 <preformat> Preformatted Text
8.4.130 <principal-award-recipient> Principal Award Recipient
8.4.131 <principal-investigator> Principal Investigator
8.4.132 <product> Product Information
8.4.133 <pub-id> Publication Identifier for a Cited Publication
8.4.134 <publisher-loc> Publisher’s Location
8.4.135 <private-char> Private Character (Custom or Unicode™)
8.4.136 <publisher-name> Publisher’s Name
8.4.138 <ref-list> Reference List (Bibliographic)
8.4.139 <related-article> Related Article Information
8.4.140 <related-object> Related Object Information
8.4.141 <role> Role or Function Title of Contributor
8.4.143 <sans-serif> Sans Serif
8.4.146 <self-uri> URI for This Same Article Online
8.4.153 <statement> Statement, Formal
8.4.155 <strike> Strike Through
8.4.156 <string-name> Name of Person (Unstructured)
8.4.157 <styled-content> Styled Special (Subject) Content
8.4.159 <subtitle> Document Subtitle
8.4.162 <supplement> Supplement Information
8.4.163 <supplementary-material> Supplementary Material
8.4.165 <table> Table (XHTML table model)
8.4.166 <table-wrap> Table Wrapper
8.4.167 <table-wrap-foot> Table Wrapper Footer
8.4.168 <target> Target of an Internal Link
8.4.169 <tbody> Table Body (XHTML table model)
8.4.170 <td> Table Data Cell (XHTML table model)
8.4.171 <term> Definition List: Term
8.4.172 <term-head> Definition List: Term Head
8.4.173 <textual-form> Textual Form
8.4.174 <tfoot> Table Footer (XHTML table model)
8.4.175 <th> Table Header Cell (XHTML table model)
8.4.176 <thead> Table Header (XHTML table model)
8.4.177 <time-stamp> Time Stamp for Cited Work
8.4.179 <title-group> Title Group
8.4.180 <tr> Table Row (XHTML table model)
8.4.181 <trans-source> Translated Source
8.4.182 <trans-title> Translated Title
8.4.184 <uri> Uniform Resource Indicator (URI)
8.4.185 <verse-group> Verse Form for Poetry
8.4.186 <verse-line> Line of a Verse
8.4.187 <volume> Volume Number
8.4.188 <volume-id> Volume Identifier
8.4.189 <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 5 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
if the attribute has a fixed value the statement this attribute must have the 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 are 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.
8.5.1 @abbr Abbreviation (XHTML table model)
8.5.2 @abstract-type Type of Abstract
8.5.3 @align Horizontal Alignment (XHTML table model)
8.5.5 @altimg Alternate Image (MathML 2.0 Tag Set)
8.5.6 @alttext Alternate Text (MathML 2.0 Tag Set)
8.5.7 @arrange Arrangement of Subscripts and Superscripts
8.5.8 @article-type Type of Article
8.5.9 @award-type Type of Award
8.5.10 @axis Axis (XHTML table model)
8.5.11 @baseline Baseline (MathML 2.0 Tag Set)
8.5.12 @baseline-shift Baseline Shift
8.5.13 @border Border (Frame) around a Table (XHTML table model)
8.5.14 @cellpadding Cell Padding (XHTML table model)
8.5.15 @cellspacing Cell Spacing (XHTML table model)
8.5.16 @char Table Cell Alignment Character (XHTML table model)
8.5.17 @charoff Table Character Offset (XHTML table model)
8.5.18 @class Class (MathML 2.0 Tag Set)
8.5.19 @collab-type Type of Collaboration
8.5.20 @colspan Column Span (XHTML table model)
8.5.21 @content-type Type of Content
8.5.22 @continued-from Continued From
8.5.23 @contrib-type Type of Contribution
8.5.24 @corresp Corresponding Author
8.5.28 @date-type Type of Date
8.5.30 @description Description of a Private Character
8.5.31 @display Display (MathML 2.0 Tag Set)
8.5.32 @document-id Document Identifier
8.5.33 @document-id-type Document Identifier Type
8.5.34 @document-type Document Type
8.5.35 @dtd-version Version of the Tag Set (DTD)
8.5.36 @elocation-id Elocation Identifier
8.5.37 @equal-contrib Equal Contribution
8.5.38 @ext-link-type Type of External Link
8.5.39 @fig-type Type of Figure
8.5.40 @fn-type Type of Footnote
8.5.41 @fontchar Font Character Table Offset
8.5.44 @frame Frame (XHTML table model)
8.5.45 @glyph-data Glyph Data Character Being Referenced
8.5.46 @headers Headers (XHTML table model)
8.5.47 @height Height (MathML 2.0 Tag Set)
8.5.49 @initials Initials of Given Names
8.5.50 @issue Issue Number of a Related Article
8.5.51 @journal-id Journal Identifier of a Related Article
8.5.52 @journal-id-type Type of Journal Identifier
8.5.53 @kwd-group-type Keyword Authority
8.5.54 @license-type Type of License
8.5.55 @link-type Type of Link (for a Related Object)
8.5.56 @list-content List Content
8.5.57 @list-type Type of List
8.5.58 @macros Macros (MathML 2.0 Tag Set)
8.5.59 @mime-subtype Mime Subtype
8.5.61 @mode Mode (MathML 2.0 Tag Set)
8.5.64 @object-id Object Identifier
8.5.65 @object-id-type Object Identifier Type
8.5.66 @object-type Object Type
8.5.67 @orientation Orientation
8.5.68 @other Other (MathML 2.0 Tag Set)
8.5.69 @overflow Overflow (MathML 2.0 Tag Set)
8.5.70 @page Page of Related Article
8.5.71 @person-group-type Type of People in the Person Group
8.5.73 @prefix-word Prefix Word (For a List Item)
8.5.74 @preformat-type Type of Preformatted Text
8.5.75 @product-type Type of Product
8.5.76 @pub-id-type Type of Publication Identifier
8.5.77 @pub-type Type of Publication
8.5.78 @publication-format Publication Format
8.5.79 @publication-type Type of Publication
8.5.80 @publisher-type Type of Publisher
8.5.81 @ref-type Type of Cross-Reference
8.5.82 @related-article-type Type of Related Article
8.5.83 @resolution Resolution of the Glyph Bitmap
8.5.84 @rid Reference to an Identifier
8.5.85 @rowspan Row Span (XHTML table model)
8.5.86 @rules Rules (XHTML table model)
8.5.87 @scope Scope (XHTML table model)
8.5.88 @sec-type Type of Section
8.5.90 @source-id Source Identifier
8.5.91 @source-id-type Source Identifier Type
8.5.92 @source-type Source Type
8.5.93 @span Span (XHTML table model)
8.5.94 @specific-use Specific Use
8.5.95 @style Style (XHTML table model; MathML 2.0 Tag Set)
8.5.97 @summary Summary (XHTML table model)
8.5.98 @supplement-type Type of Supplement
8.5.99 @target-type Type of Target
8.5.100 @type Type (MathML 2.0 Tag Set)
8.5.102 @valign Vertical Alignment (XHTML table model)
8.5.103 @vol Volume of Related Article
8.5.104 @width Width (XHTML table model; MathML 2.0 Tag Set)
8.5.105 @xlink:actuate Actuating the Link
8.5.106 @xlink:href Href (Linking Mechanism)
8.5.107 @xlink:role Role of the Link
8.5.108 @xlink:show Showing the Link
8.5.109 @xlink:title Title of the Link
8.5.110 @xlink:type Type of Link
8.5.111 @xmlns:mml MathML Namespace Declaration
8.5.112 @xmlns:xlink XLink Namespace Declaration
8.5.113 @xmlns:xsi XML Schema Namespace Declaration
8.5.116 @xref Cross-Reference (MathML 2.0 Tag Set)
8.5.117 @x-size X Size of the Glyph
8.5.118 @xsi:schemaLocation Schema Location (MathML 2.0 Tag Set)