10 Article Authoring Tag Set
10.1 Rationale
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.
10.2 Scope
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.
10.3 Structural Overview
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.
10.4 Elements
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 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.2 <abstract> Abstract
10.4.3 <access-date> Access Date for Cited Work
10.4.4 <ack> Acknowledgments
10.4.5 <addr-line> Address Line
10.4.6 <address> Address/Contact Information
10.4.7 <aff> Affiliation
10.4.8 <aff-alternatives> Affiliation Alternatives
10.4.9 <alt-text> Alternate Text Name (for a figure, etc.)
10.4.10 <alternatives> Alternatives For Processing
10.4.11 <annotation> Annotation in a Citation
10.4.12 <anonymous> Anonymous
10.4.13 <app> Appendix
10.4.14 <app-group> Appendix Group
10.4.15 <article> Article
10.4.16 <article-meta> Article Metadata
10.4.17 <article-title> Article Title
10.4.18 <attrib> Attribution
10.4.19 <author-comment> Author Comment
10.4.20 <award-group> Award Group
10.4.21 <award-id> Award Identifier
10.4.22 <back> Back Matter
10.4.23 <bio> Biography
10.4.24 <body> Body of the Document
10.4.25 <bold> Bold
10.4.26 <boxed-text> Boxed Text
10.4.27 <break> Line Break
10.4.28 <caption> Caption of a Figure, Table, etc.
10.4.29 <chapter-title> Chapter Title in a Citation
10.4.30 <chem-struct> Chemical Structure (Display)
10.4.31 <chem-struct-wrap> Chemical Structure Wrapper
10.4.32 <citation-alternatives> Citation Alternatives
10.4.33 <col> Table Column (NISO JATS table model)
10.4.34 <colgroup> Table Column Group (NISO JATS table model)
10.4.35 <collab> Collaborative (Group) Author
10.4.36 <collab-alternatives> Collaboration Alternatives
10.4.37 <comment> Comment in a Citation
10.4.38 <compound-kwd> Compound Keyword
10.4.39 <compound-kwd-part> Compound Keyword Part
10.4.40 <conf-acronym> Conference Acronym
10.4.41 <conf-date> Conference Date
10.4.42 <conf-loc> Conference Location
10.4.43 <conf-name> Conference Name
10.4.44 <conf-num> Conference Number
10.4.45 <conf-sponsor> Conference Sponsor
10.4.46 <conf-theme> Conference Theme
10.4.47 <conference> Conference Information
10.4.48 <contrib> Contributor
10.4.49 <contrib-group> Contributor Group
10.4.50 <contrib-id> Contributor Identifier
10.4.51 <copyright-holder> Copyright Holder
10.4.52 <copyright-statement> Copyright Statement
10.4.53 <copyright-year> Copyright Year
10.4.54 <country> Country: in an Address
10.4.55 <date> Date
10.4.56 <date-in-citation> Date within a Citation
10.4.57 <day> Day
10.4.58 <def> Definition List: Definition
10.4.59 <def-head> Definition List: Definition Head
10.4.60 <def-item> Definition List: Definition Item
10.4.61 <def-list> Definition List
10.4.62 <degrees> Degree(s)
10.4.63 <disp-formula> Formula, Display
10.4.64 <disp-formula-group> Formula, Display Group
10.4.65 <disp-quote> Quote, Displayed
10.4.66 <edition> Edition Statement, Cited
10.4.67 <element-citation> Element Citation
10.4.68 <elocation-id> Electronic Location Identifier
10.4.69 <email> Email Address
10.4.70 <etal> Et Al.
10.4.71 <ext-link> External Link
10.4.72 <fax> Fax Number: in an Address
10.4.73 <fig> Figure
10.4.74 <fn> Footnote
10.4.75 <fn-group> Footnote Group
10.4.76 <fpage> First Page
10.4.77 <front> Front Matter
10.4.78 <funding-group> Funding Group
10.4.79 <funding-source> Funding Source
10.4.80 <funding-statement> Funding Statement
10.4.81 <given-names> Given (First) Names
10.4.82 <glossary> Glossary Elements List
10.4.83 <glyph-data> Glyph Data for a Private Character
10.4.84 <glyph-ref> Glyph Reference for a Private Character
10.4.85 <gov> Government Report, Cited
10.4.86 <graphic> Graphic
10.4.87 <hr> Horizontal Rule
10.4.88 <inline-formula> Formula, Inline
10.4.89 <inline-graphic> Graphic, Inline
10.4.90 <inline-supplementary-material> Inline Supplementary Material
10.4.91 <institution> Institution Name: in an Address
10.4.92 <isbn> ISBN
10.4.93 <issn-l> ISSN-L (Linking ISSN)
10.4.94 <issn> ISSN
10.4.95 <issue> Issue Number
10.4.96 <issue-id> Issue Identifier
10.4.97 <issue-part> Issue Part
10.4.98 <issue-title> Issue Title
10.4.99 <italic> Italic
10.4.100 <journal-id> Journal Identifier
10.4.101 <kwd> Keyword
10.4.102 <kwd-group> Keyword Group
10.4.103 <label> Label (of an Equation, Figure, Reference, etc.)
10.4.104 <license> License Information
10.4.105 <license-p> License Paragraph
10.4.106 <list> List
10.4.107 <list-item> List Item
10.4.108 <long-desc> Long Description
10.4.109 <lpage> Last Page
10.4.110 <media> Media Object
10.4.111 <mixed-citation> Mixed Citation
10.4.112 <mml:math> Math (MathML 2.0 Tag Set)
10.4.113 <monospace> Monospace Text (Typewriter Text)
10.4.114 <month> Month
10.4.115 <name> Name of Person
10.4.116 <name-alternatives> Name Alternatives
10.4.117 <named-content> Named Special (Subject) Content
10.4.118 <nested-kwd> Nested Keyword
10.4.119 <nlm-citation> NLM Citation
10.4.120 <object-id> Object Identifier
10.4.121 <on-behalf-of> On Behalf of
10.4.122 <open-access> Open Access
10.4.123 <overline> Overline
10.4.124 <p> Paragraph
10.4.125 <page-count> Page Count
10.4.126 <page-range> Page Ranges
10.4.127 <part-title> Part Title in a Citation
10.4.128 <patent> Patent Number, Cited
10.4.129 <permissions> Permissions
10.4.130 <person-group> Person Group for a Cited Publication
10.4.131 <phone> Phone Number: in an Address
10.4.132 <prefix> Prefix
10.4.133 <preformat> Preformatted Text
10.4.134 <price> Price
10.4.135 <principal-award-recipient> Principal Award Recipient
10.4.136 <principal-investigator> Principal Investigator
10.4.137 <private-char> Private Character (Custom or Unicode)
10.4.138 <product> Product Information
10.4.139 <pub-id> Publication Identifier for a Cited Publication
10.4.140 <publisher-loc> Publisher’s Location
10.4.141 <publisher-name> Publisher’s Name
10.4.142 <ref> Reference Item
10.4.143 <ref-list> Reference List (Bibliographic)
10.4.144 <related-article> Related Article Information
10.4.145 <related-object> Related Object Information
10.4.146 <role> Role or Function Title of Contributor
10.4.147 <roman> Roman
10.4.148 <sans-serif> Sans Serif
10.4.149 <sc> Small Caps
10.4.150 <season> Season
10.4.151 <sec> Section
10.4.152 <self-uri> URI for This Same Article Online
10.4.153 <series> Series
10.4.154 <size> Size
10.4.155 <source> Source
10.4.156 <speaker> Speaker
10.4.157 <speech> Speech
10.4.158 <statement> Statement, Formal
10.4.159 <std> Standard, Cited
10.4.160 <strike> Strike Through
10.4.161 <string-name> Name of Person (Unstructured)
10.4.162 <styled-content> Styled Special (Subject) Content
10.4.163 <std-organization> Standards Organization
10.4.164 <sub> Subscript
10.4.165 <subtitle> Document Subtitle
10.4.166 <suffix> Suffix
10.4.167 <sup> Superscript
10.4.168 <supplement> Supplement Information
10.4.169 <supplementary-material> Supplementary Material
10.4.170 <surname> Surname
10.4.171 <table> Table (NISO JATS table model)
10.4.172 <table-wrap> Table Wrapper
10.4.173 <table-wrap-foot> Table Wrapper Footer
10.4.174 <target> Target of an Internal Link
10.4.175 <tbody> Table Body (NISO JATS table model)
10.4.176 <td> Table Data Cell (NISO JATS table model)
10.4.177 <term> Definition List: Term
10.4.178 <term-head> Definition List: Term Head
10.4.179 <textual-form> Textual Form
10.4.180 <tfoot> Table Footer (NISO JATS table model)
10.4.181 <th> Table Header Cell (NISO JATS table model)
10.4.182 <thead> Table Header (NISO JATS table model)
10.4.183 <time-stamp> Time Stamp for Cited Work
10.4.184 <title> Title
10.4.185 <title-group> Title Group
10.4.186 <tr> Table Row (NISO JATS table model)
10.4.187 <trans-source> Translated Source
10.4.188 <trans-title> Translated Title
10.4.189 <underline> Underline
10.4.190 <uri> Uniform Resource Identifier (URI)
10.4.191 <verse-group> Verse Form for Poetry
10.4.192 <verse-line> Line of a Verse
10.4.193 <volume> Volume Number
10.4.194 <volume-id> Volume Identifier
10.4.195 <volume-series> Volume Series
10.4.196 <xref> X (cross) Reference
10.4.197 <year> Year
10.5 Attributes
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.4 @alt Alternative Text
10.5.5 @altimg Alternate Image (MathML 2.0 Tag Set)
10.5.6 @alttext Alternate Text (MathML 2.0 Tag Set)
10.5.7 @arrange Arrangement of Subscripts and Superscripts
10.5.8 @article-type Type of Article
10.5.9 @award-type Type of Award
10.5.10 @axis Axis (NISO JATS table model)
10.5.11 @baseline Baseline (MathML 2.0 Tag Set)
10.5.12 @baseline-shift Baseline Shift
10.5.13 @border Border (Frame) around a Table (NISO JATS table model)
10.5.14 @calendar Calendar
10.5.15 @cellpadding Cell Padding (NISO JATS table model)
10.5.16 @cellspacing Cell Spacing (NISO JATS table model)
10.5.17 @char Table Cell Alignment Character (NISO JATS table model)
10.5.18 @charoff Table Character Offset (NISO JATS table model)
10.5.19 @class Class (MathML 2.0 Tag Set)
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.27 @count Count
10.5.28 @country Country
10.5.29 @currency Currency
10.5.30 @date-type Type of Date
10.5.31 @deceased Deceased
10.5.32 @description Description of a Private Character
10.5.33 @designator Designator of the Edition
10.5.34 @display Display (MathML 2.0 Tag Set)
10.5.35 @document-id Document Identifier
10.5.36 @document-id-type Document Identifier Type
10.5.37 @document-type Document Type
10.5.38 @dtd-version Version of the Tag Set (DTD)
10.5.39 @elocation-id Elocation Identifier
10.5.40 @equal-contrib Equal Contribution
10.5.41 @ext-link-type Type of External Link
10.5.42 @fig-type Type of Figure
10.5.43 @fn-type Type of Footnote
10.5.44 @fontchar Font Character Table Offset
10.5.45 @fontname Font Name
10.5.46 @format Format
10.5.47 @frame Frame (NISO JATS table model)
10.5.48 @glyph-data Glyph Data Character Being Referenced
10.5.49 @headers Headers (NISO JATS table model)
10.5.50 @height Height (MathML 2.0 Tag Set)
10.5.51 @id Identifier
10.5.52 @initials Initials for Personal Names
10.5.53 @issue Issue Number of a Related Article
10.5.54 @iso-8601-date ISO-8601 Formatted Date
10.5.55 @journal-id Journal Identifier of a Related Article
10.5.56 @journal-id-type Type of Journal Identifier
10.5.57 @kwd-group-type Keyword Authority
10.5.58 @license-type Type of License
10.5.59 @link-type Type of Link (for a Related Object)
10.5.60 @list-content List Content
10.5.61 @list-type Type of List
10.5.62 @macros Macros (MathML 2.0 Tag Set)
10.5.63 @mime-subtype Mime Subtype
10.5.64 @mimetype Mime Type
10.5.65 @mode Mode (MathML 2.0 Tag Set)
10.5.66 @name Name
10.5.67 @name-style Name Style
10.5.68 @object-id Object Identifier
10.5.69 @object-id-type Object Identifier Type
10.5.70 @object-type Object Type
10.5.71 @orientation Orientation
10.5.72 @other Other (MathML 2.0 Tag Set)
10.5.73 @overflow Overflow (MathML 2.0 Tag Set)
10.5.74 @page Page of Related Article
10.5.75 @person-group-type Type of People in the Person Group
10.5.76 @position Position
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 @pub-type Type of Publication
10.5.82 @publication-format Format of Publication
10.5.83 @publication-type Type of Referenced Publication
10.5.84 @publisher-type Type of Publisher
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.93 @seq Sequence
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 @style Style (NISO JATS table model; MathML 2.0 Tag Set)
10.5.100 @style-type Style Type
10.5.101 @summary Summary (NISO JATS table model)
10.5.102 @supplement-type Type of Supplement
10.5.103 @target-type Type of Target
10.5.104 @type Type (MathML 2.0 Tag Set)
10.5.105 @units Units
10.5.106 @valign Vertical Alignment (NISO JATS table model)
10.5.107 @vol Volume of Related Article
10.5.108 @width Width (NISO JATS table model; MathML 2.0 Tag Set)
10.5.109 @xlink:actuate Actuating the Link
10.5.110 @xlink:href Href (Linking Mechanism)
10.5.111 @xlink:role Role of the Link
10.5.112 @xlink:show Showing the Link
10.5.113 @xlink:title Title of the Link
10.5.114 @xlink:type Type of Link
10.5.115 @xmlns:mml MathML Namespace Declaration
10.5.116 @xmlns:xlink XLink Namespace Declaration
10.5.117 @xmlns:xsi XML Schema Namespace Declaration
10.5.118 @xml:lang Language
10.5.119 @xml:space Space
10.5.120 @xref Cross-Reference (MathML 2.0 Tag Set)
10.5.121 @x-size X Size of the Glyph
10.5.122 @xsi:schemaLocation Schema Location (MathML 2.0 Tag Set)
10.5.123 @y-size Y Size of the Glyph