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">
| element | attribute(s) | required | description |
|---|---|---|---|
| <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. 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). |
| yes | ||
| yes | ||
| journal-id-type | yes | 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:
|
| yes | Contents come from a Master List that Brill will provide typesetters. | |
| yes | Full title of the journal in which the article was published. | |
| no | This is not an issue title. Issue titles are described in the article metadata. This is a permanent subtitle to a journal. | |
| xml:lang | no | 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). |
| yes | The translation of the title. | |
| no | The translation of the subtitle. | |
| abbrev-type | yes | 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. |
| publication-format | yes | 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:
|
| publication-format | no | 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:
|
| specific-use | yes | @specific-use: attribute not required. Supported values are:
|
| 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.)
| |
| yes | Use 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. | |
| yes | Information concerning the article that identifies or describes the article. | |
| pub-id-type | yes | 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.
|
| no | ||
| subj-group-type | no | @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 |
| yes | ||
| yes | ||
| yes | Full title of an article or other journal component, such as an editorial or book review. | |
| alt-title-type | no | @alt-title-type: required attribute. Reason or purpose for a (shorter) title to be included. Brill supports 2 values for @alt-title-type:
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. |
| Subordinate part of a title for a document or document component. Refer to the manuscript to see what the author meant as subtitle. | ||
| xml:lang | no | 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). |
| The translation of the title. | ||
| The translation of the subtitle. |
