A journal issue is built up from articles, each article is a file with an <article> XML-root-element. The article metadata, like the title and authors, and the journal it appears in, with a title, series information etc. are all included in this <article> element.

This document describes a subset of JATS specific for Brill journals. See jats.nlm.nih.org for NLM’s own description of the JATS standard. Their description is normative. This document describes a subset to help uniformity in Brill Journal Article XML.

DOCTYPE


Always add the following <!DOCTYPE> declaration to Brill journal articles:

<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.1 20151215//EN" "https://jats.nlm.nih.gov/publishing/1.1/JATS-journalpublishing1.dtd">

elementattribute(s)requireddescription
<article>

xml:lang

xmlns:xlink

xmlns:mml

dtd-version

specific-use

article-type

yes

/article is the root element in JATS.

@xml:lang is required and indicates the main language of the article. Supported values are ISO 639-2 (B).

xmlns:xlink="http://www.w3.org/1999/xlink" is required

Use xmlns:mml="http://www.w3.org/1998/Math/MathML" if and only if the article contains an element from MathML.
Brill uses MathML3.

dtd-version="1.0" is required for all articles

For all Advance Articles, add @specific-use="prepub" to the root element. Do not add <volume> or <issue>.

@article-type:

Kind or type of the article. The author or Brill will notify the typesetter of this value. Usually, it is "research-article".

Brill supports all 29 values for @article-type that NLM prescribes: "abstract", "addendum", "announcement", "article-commentary", "book-review", "books-received", "brief-report", "calendar", "case-report", "collection", "correction", "discussion", "dissertation", "editorial", "in-brief", "introduction", "letter", "meeting-report", "news", "obituary", "oration", "partial-retraction", "product-review", "rapid-communication", "reply", "reprint", "research-article", "retraction", "review-article", "translation".

Optionally, with Brill permission, a typesetter may use "other" as a value for this attribute.

Please Note: for any files that include one of the following values for @article-type:

"correction", "editorial", "introduction", "obituary", "partial-retraction", or "retraction" the element <ali:free_to_read xmlns:ali="http://www.niso.org/schemas/ali/1.0/"/> is Required under <permissions> (as explained in more detail below).

  • <front>

yes
    • <journal-meta>

yes
      • <journal-id>
journal-id-typeyes

Brill uses the E-ISSN as identifier; the type of the identifier is indicated using the @journal-id-type attribute. Contents come from a Master List that Brill will provide typesetters. This element is required twice, once with a @journal-id-type="eissn" and once with @journal-id-type="publisher-id". Note that the hyphen in an ISSN should always be included.

@journal-id-type:  Required attribute. Type of journal identifier or the authority that created a particular journal identifier. Supported values:

  • "eissn": Include the journal’s E-ISSN in this tag.
  • "publisher-id": Include the journal abbreviation in this tag.
      • <journal-title-group>

yes

Contents come from a Master List that Brill will provide typesetters.

        • <journal-title>

yes

Full title of the journal in which the article was published.

        • <journal-subtitle>

no

This is not an issue title. Issue titles are described in the article metadata. This is a permanent subtitle to a journal.

        • <trans-title-group>
xml:langno

For every translation of the journal title, supply a <trans-title-group>.

@xml:lang: required attribute. Indicates the language of the translated title. This attribute should be included here and not on the sub-elements. Supported values are ISO 639-2 (B).

          • <trans-title>

yesThe translation of the title.
          • <trans-subtitle>

noThe translation of the subtitle.
        • <abbrev-journal-title>
abbrev-typeyes

Short form of the title of the journal in which an article is published. Contents come from a Master List that Brill will provide typesetters.

@abbrev-type="ltwa": required attribute/value pair.

      • <issn>
publication-formatyes

Brill requires that both the E-ISSN and ISSN are always used. Contents come from a Master List that Brill will provide typesetters. In case a journal does not have a ISSN, Brill will let the typesetters know. Note that the hyphen in an ISSN should always be included.

@publication-format: required attribute. Indicate whether this ISSN applies to a print or an online version. Supported values:

  • "print"
  • "online"
      • <issn>
publication-formatno

International Standard Book Number, the international code for identifying a particular product form or edition of a publication, typically a monographic publication.

The code is always set without spaces or hyphens.

@publication-format: required attribute. Indicate whether this ISBN applies to a print or an online version. Supported values:

  • "print"
  • "online"
      • <publisher>
specific-useyes

@specific-use: attribute not required. Supported values are:

  • "print"
  • "online"
        • <publisher-name>

yes

Name of the imprint associated with the article or book. Brill will let the typesetters know which imprint to use for the journal.

Currently, for <publisher-name> only the text values below are permitted. (NOTE: historically, other values may exist and should be retained if such files are redelivered, unless expressly noted otherwise.)

  • Brill
  • Brill | Nijhoff
  • Brill | Hotei
  • Brill | Sense
  • Brill | Schöningh
  • Brill | Fink
  • Brill | mentis
  • Vandenhoeck & Ruprecht
  • Böhlau Verlag
  • V&R unipress
        • <publisher-loc>

yesUse the location as given on the Title Page of the journal prelims. If the publisher has more than one location (Leiden | Boston), this still has to specified in one element.
    • <article-meta>

yes

Information concerning the article that identifies or describes the article.

      • <article-id>
pub-id-typeyes

Unique external identifier assigned to an article. Note that for the DOI, any alphabetic characters within the DOI itself should always be included as lower-case in the XML file.

@pub-id-type: required attribute. Type of publication identifier or the organization or system that defined the identifier.

  • Req. "doi"
  • "EM" This is the Editorial Manager manuscript number. Always include if provided.
      • <article-categories>

no
        • <subj-group>
subj-group-typeno@subj-group-type: attribute not required. Type of subject group. For some journals, articles are grouped into categories which this Tag Set calls <subject>s, which may be grouped into <subj-group>s. These subject categories are typically shown in the Table of Contents, at the top of the first print or display page, or on the web splash page for an article. The Brill Desk Editor will provide these when needed
          • <subject>

yes
      • <title-group>

yes
        • <article-title>

yesFull title of an article or other journal component, such as an editorial or book review.
        • <alt-title>
alt-title-typeno@alt-title-type: required attribute. Reason or purpose for a (shorter) title to be included. Brill supports 2 values for @alt-title-type:
  • "toc": Title to be used in the table of contents.
  • "running-head": Title to be used as the running head. This is a shorter version of the regular title. An <alt-title> with this type is optional.

An <alt-title alt-title-type="toc"> is always required to be in a <title-group>, but does not need to be a shorter version of the regular title.

        • <subtitle>


Subordinate part of a title for a document or document component. Refer to the manuscript to see what the author meant as subtitle.

        • <trans-title-group>
xml:langno

For every translation of the articletitle, supply a <trans-title-group>.

@xml:lang: required attribute. Indicates the language of the translated title. This attribute should be included here and not on the sub-elements. Supported values are ISO 639-2 (B).

          • <trans-title>


The translation of the title.
          • <trans-subtitle>


The translation of the subtitle.