Skip Navigation
Skip to contents

Science Editing : Science Editing

OPEN ACCESS
SEARCH
Search

Articles

Page Path
HOME > Sci Ed > Volume 1(2); 2014 > Article
Training Material
Coding practice of the Journal Article Tag Suite extensible markup language
Sun Huhorcid
Science Editing 2014;1(2):105-112.
DOI: https://doi.org/10.6087/kcse.2014.1.105
Published online: August 18, 2014

Department of Parasitology and Institute of Medical Education, College of Medicine, Hallym University, Chuncheon, Korea

Correspondence to Sun Huh E-mail: shuh@hallym.ac.kr
This article was presented at the workshop entitled ‘Application of advanced information technology to scholarly journal publishing’ during the 12th EASE General Assembly and Conference, Split, Croatia, July 12-13, 2014.
• Received: June 5, 2014   • Accepted: July 29, 2014

Copyright © Korean Council of Science Editors

This is an open access article distributed under the terms of the Creative Commons Attribution Non-Commercial License (http://creativecommons.org/licenses/by-nc/3.0/), which permits unrestricted use, distribution, and reproduction in any medium, provided the original work is properly cited.

prev next
  • 40,963 Views
  • 273 Download
  • 3 Web of Science
  • 11 Crossref
  • 11 Scopus
  • In general, the Journal Article Tag Suite (JATS) extensible markup language (XML) coding is processed automatically by an XML filtering program. In this article, the basic tagging in JATS is explained in terms of coding practice. A text editor that supports UTF-8 encoding is necessary to input JATS XML data that works in every language. Any character representable in Unicode can be used in JATS XML, and commonly available web browsers can be used to view JATS XML files. JATS XML files can refer to document type definitions, extensible stylesheet language files, and cascading style sheets, but they must specify the locations of those files. Tools for validating JATS XML files are available via the web sites of PubMed Central and ScienceCentral. Once these files are uploaded to a web server, they can be accessed from all over the world by anyone with a browser. Encoding an example article in JATS XML may help editors in deciding on the adoption of JATS XML.
Anyone who can understand English and has a modest knowledge of journal editing and publishing can produce Journal Article Tag Suite (JATS) extensible markup language (XML) files. Manually coding such documents according to a document type definition (DTD) requires 12 hours for a single article, even if any existing extensible hypertext markup language (XHTML), mathematical markup language (MathML), and chemical markup language (ChemML) portions are treated as figure formats. Therefore, most printing companies employ a special XML conversion program. In general, the preliminary XML file for a single article is generated within 15 minutes. Then, the validation check and trimming of the file is performed. XML coding of articles requires some knowledge of bibliographic formatting conventions in order to differentiate the bibliographic characteristics of data in the articles. For example, in the reference section, journals, books, web sites, or PhD theses may be cited. Typically, these distinct reference types should be formatted differently. The objective of this article is to explain how editors can code journal articles according to JATS 1.0 XML specification and to observe the results through a web browser. In particular, at least 20 XML tags are considered and the role of DTDs, extensible stylesheet language transformations (XSLT), and cascading style sheets (CSS) are explained. It is expected that after gaining some experience with the article coding process, editors will have an incentive to adopt JATS XML.
An editor program that supports Unicode and a web browser are necessary for coding JATS XML file. JATS XML sample files are provided as Supplement 1. Further, the DTD, XSLT, and CSS files are available as well: a journalpublishing1.dtd file was available from https://github.com/PeerJ/jats-conversion/blob/master/schema/jats/publishing/1.0/JATS-journalpublishing1.dtd; a jats-html.xsl file was available from: https://github.com/ncbi/JATSPreviewStylesheets/blob/master/xslt/main/jats-html.xsl; and a jats-preview.css file was available from: https://github.com/wendellpiez/oXygenJATSframework/blob/master/jats-preview-xslt/jats-preview.css.
First, open the sample coding article within your text editor. Save the file (sample.xml) to a specific directory, ensuring that UTF-8 encoding is maintained. Open the file in a web browser and observe how it appears. It is presented as Fig. 1. Next, copy the DTD file (journalpublishing1.dtd) into the same directory where the sample file is located. Re-open the sample file in a browser and observe how its appearance has changed. To the same directory, add the XSLT file (jats-html.xsl) and then the CSS file (jats-preview.css). Each time re-open sample.xml in a browser and observe any changes (Figs. 2, 3). With each additional file, you should note any improvements in the layout and appearance of the document, and these changes should suggest the function of each file added.
Since a DTD provides the attributes and elements only, the format of the sample file as viewed in the browser does not change (Fig. 1). XSLT files, in contrast, typically define how an XML document is to be rendered or transformed into hypertext markup language (HTML) for example (Fig. 2). Finally, CSS files describe the look and formatting of documents written in mark-up languages such as HTML (Fig. 3).
An XML document begins as follows:
<?xml version=“1.0” encoding=“UTF-8”?>---(1)
<?xml-stylesheet type=“text/xsl” href=“jats-html.xsl”?> ---(2)
<!DOCTYPE article PUBLIC “-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.0 20120330//EN” “http://jats.nlm.nih.gov/publishing/1.0/JATS-journalpublishing1.dtd”>---(3)
(1) <?xml version=“1.0” encoding=“UTF-8”?> means that the xml version is 1.0 and encoding is according to UTF-8. It is the most common declaration for XML documents.
(2) The<?xml-stylesheet type=“text/xsl” href=“jats-html.xsl”?> tag determines the stylesheet. Layout is assigned in jats-html.xsl.
(3) The declaration on line three beginning with ‘<!DOCTYPE article’ indicates the online location of the DTD file. If the DTD file is instead located on a local file system, the declaration would appear as <!DOCTYPE article PUBLIC “-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.0 “JATS-journalpublishing1.dtd”>
The DTD determines the elements and attributes that are permissible within any XML document that refers to it. Previously, different DTDs were used by each publisher; however, the JATS XML DTD is now conventionally used.
<article
article-type=“research-article” --- (4)
dtd-version=“1.0” xml:lang=“en” --- (5)
xmlns:mml=http://www.w3.org/1998/Math/MathML--- (6)
xmlns:xlink=http://www.w3.org/1999/xlink --- (7)
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance --- (8)
>
Above is an example of an article declaration.
(4) article-type=“research-article” specifies that the publication type is “research article.” A variety of types are available, such as “editorial,” “letter,” and “case report.”
(5) dtd-version=“1.0” xml:lang=“en” declares the language in which the article is written. If there is no language declaration, the default value is “en” (English).
(6-8) The last three lines in the article declaration above indicate that this article follows W3C MathML, XLINK, and XML Schema-instance.
Articles are comprised of three sections classified as “front matter,” “body,” and “back matter.” Each of these sections is enclosed within the corresponding tag pair as follows:
<front> --- (9)
....
</front>
<body> --- (10)
...
</body>
<back>--(11)
...
</back>
(9) “Front matter” consists of citation details, an abstract, keywords, and masthead.
(10) The “body” section includes the article’s primary content from the introduction to conclusion.
(11) “Back matter” comprises conflict of interest, acknowledgments, footnotes, References, appendices, and/or supplements.
Special characters such as *, <, and > must be specified using the corresponding Unicode character entity reference, for example:
* &#x002A;
< &#x003C;
> &#x003e;
All Unicode character entity References can be specified with a four-digit hexadecimal code, prepended with &#x and appended with a semicolon. For example, the code for the % character is 0025; therefore, the complete character entity reference is &#x0025;. A full list of codes for all special characters is available at http://www.unicode.org/charts/.
To make a full-text JATS XML file for articles in Croatian, it is necessary to add a language tag such as <xml:lang=“hr”> in the article declaration. The language element is specified as an attribute with a two-letter alphabetic code in accordance with the IETF RFC 5646 (http://tools.ietf.org/html/rfc5646) recommended by the Internet Engineering Task Force in September 2009. For example, “fr” (French), “en” (English), “de” (German), “se” (Swedish), “hr” (Croatian), “es” (Spanish), and “ko” (Korean) were used [1].
After adding the journal article’s content to the appropriate sections of the sample file, you can then check how it appears in a web browser.
Once the JATS XML file has been produced, it can be validated with any variety of tools available online, such as http://www.ncbi.nlm.nih.gov/pmc/tools/xmlchecker/ or http://www.e-sciencecentral.org/tools/stylechecker/. Any indicated errors should be fixed in accordance with the JATS DTD.
There is still small portion of full-text JATS XML-based society-directed journals in the web. A number of scientific journal publishing societies in Korea have begun to produce full-text JATS XML files and deposit them to ScienceCentral, since at least three Korean firms can generate perfect JATS XML files with table XHTML, ChemML, and MathML [2]. It is the base of producing JATS XML files both in English and in Korean. There are other excellent global companies that can produce JATS XML files; however, they usually process articles in English. Therefore, JATS XML-producing company of which specialists fluent in each language is needed in order to make articles accessible internationally via the Web and to deposit them to ScienceCentral for wider exposure.
JATS XML coding can be performed according to the JATS DTD, which provides the specification for elements and attributes. XSLT provides the stylesheet for XML; whereas CSS provides the stylesheet for HTML. With DTD, XSLT, and CSS, the JATS XML file can be viewed in a user-friendly fashion via a web browser. Journals in local languages can be specified in JATS XML files with the appropriate code in the language attribute. Such journals will then be accessible to all readers in the world with a variety of formats including PubReader and ePub.

No potential conflict of interest relevant to this article was reported.

Acknowledgements
This work is supported by a research grant of the National Research Foundation of Korea (policy research-2013-003-academic infrastructure promotion) and the Korean Federation of Science and Technology Societies (KOFST-2013), government of the Republic of Korea.

Supplement 1.

Sample file for exercise of Journal Article Tag Suite
<?xml version=”1.0” encoding=”UTF-8”?>
<?xml-stylesheet type=”text/xsl” href=”jats-html.xsl”?>
<!DOCTYPE article PUBLIC “-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.0 20120330//EN” “journalpublishing1.dtd”>
<article article-type=”research-article” dtd-version=”1.0” xml:lang=”en” xmlns:mml=”http://www.w3.org/1998/Math/MathML” xmlns:xlink=”http://www.w3.org/1999/xlink” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<front>
<journal-meta>
<journal-id journal-id-type=”publisher-id”>KCSE</journal-id>
<journal-title-group><journal-title>Science Editing</journal-title></journal-title-group>
<issn pub-type=”ppub”>2288-7474</issn>
<issn pub-type=”epub”>2288-9063</issn>
<publisher>
<publisher-name>Korean Council of Science Editors</publisher-name></publisher>
</journal-meta>
<article-meta>
<article-id pub-id-type=”doi”>10.6087/kcse.2014.1.15</article-id>
<article-id pub-id-type=”publisher-id”>sciedit-1-15</article-id>
<article-categories>
<subj-group>
<subject>Educational Material</subject>
</subj-group>
</article-categories>
<title-group>
<article-title>Coding practice of Journal Article Tag Set eXtensible Markup Language
</article-title>
</title-group>
<contrib-group>
<contrib contrib-type=”author”>
<name><surname>Huh</surname><given-names>Sun</given-names></name>
<xref rid=”af1-sciedit-1-15” ref-type=”aff”><sup>1</sup></xref>
<xref rid=”c1-sciedit-1-15” ref-type=”corresp”><sup>&#x0002A;</sup></xref>
</contrib>
<aff id=”af1-sciedit-1-15”>
<label>1</label>Department of Parasitology and Institute of Medical Education, College of Medicine, Hallym University, Chuncheon,
<country>Korea</country>
</aff>
</contrib-group>
<author-notes>
<corresp id=”c1-sciedit-1-15”>
<label>&#x0002A;</label> <email>shuh@hallym.ac.kr</email></corresp>
</author-notes>
<pub-date pub-type=”collection”>
<year>2014</year></pub-date>
<pub-date pub-type=”epub”>
<day>20</day>
<month>08</month>
<year>2014</year></pub-date>
<volume>1</volume>
<elocation-id>15</elocation-id>
<history>
<date date-type=”received”>
<day>04</day>
<month>06</month>
<year>2014</year></date>
<date date-type=”accepted”>
<day>26</day>
<month>06</month>
<year>2014</year></date></history>
<permissions>
<copyright-statement>&#x000A9; 2014, Korean Council of Science Editors</copyright-statement>
<copyright-year>2014</copyright-year>
<license>
<license-p>This is an open-access article distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, and reproduction in any medium, provided the original work is properly cited.</license-p></license></permissions>
<abstract>
<p>
Journal Article Tag Set eXtensible Markup Language (JATS XML) coding is usually processed automatically by XML filtering program and the accuracy of tagging is checked by validation process.....
</p>
</abstract>
<kwd-group>
<kwd>Journal Article Tag Suite</kwd>
<kwd>journal publishing</kwd>
</kwd-group>
</article-meta>
</front>
<body>
<sec sec-type=”intro”>
<title>Introduction</title>
<p>
Production of Journal Article Tag Set eXtensible Markup Language (JATS XML) files can be done by anyone who can understand English and have minimum knowledge on journal editing and publishing....
</p>
</sec>
<sec sec-type=”methods”>
<title>Programs and sample files</title>
<p>Unicode supporting text editor and web browser are necessary.
</p>
</sec>
<sec sec-type=”conclusions”>
<title>Conclusion</title>
<p>
JATSXML coding can be done according to the JATSDTD which provide the information of elements and attributes.
</p>
</sec>
</body>
<back>
<fn-group><fn fn-type=”conflict”>
<p> No potential conflict of interest relevant to this article was reported</p></fn></fn-group>
<ack>
<p>This work is supported by the research grant of the National Research Foundation of Korea (policy research-2013-003-academic infrastructure promotion) and the Korean Federation of Science and Technology Societies (KOFST-2013), Government of the Republic of Korea.</p>
</ack>
<ref-list>
<ref id=”b1-sciedit-1-15”>
<label>1</label>
<element-citation publication-type=”journal”>
<person-group person-group-type=”author”>
<name>
<surname>Huh</surname>
<given-names>Sun</given-names>
</name>
<name>
<surname> Choi</surname>
<given-names>Tae-Jin</given-names>
</name>
<name>
<surname>Kim</surname>
<given-names>So-Hyung</given-names>
</name>
</person-group>
<article-title>
Using Journal Article Tag Suite extensible markup language for scholarly journal articles written in Korean
</article-title>
<source>Sci Ed</source>
<year iso-8601-date=”2014”>2014</year>
<volume>1</volume>
<fpage>19</fpage>
<lpage>23</lpage>
</element-citation>
</ref>
</ref-list>
</back>
</article>
Fig. 1.
Screenshot of sample.xml file seen with browser when there was no other file or journalpublishing1.dtd file at the same directory with sample.xml.
se-1-2-105f1.gif
Fig. 2.
Screenshot of sample.xml file seen when there were journalpublishing1.dtd and jats-html.xsl files at the same directory with sample.xml.
se-1-2-105f2.gif
Fig. 3.
Screenshot of sample.xml file seen when there were journalpublishing1.dtd, jats-html.xsl, and jats-preview.css files at the same directory with sample.xml.
se-1-2-105f3.gif

Figure & Data

References

    Citations

    Citations to this article as recorded by  
    • Trends of publication in the orthopedic journals from India: A bibliometric analysis
      Mohit Kumar Patralekh, Abhishek Vaish, Raju Vaishya, Ashish Gulia, Hitesh Lal
      Indian Journal of Medical Sciences.2021; 73: 134.     CrossRef
    • The Thirty-First Year Journey, the Journal of the Korean Academy of Child and Adolescent Psychiatry
      Hee Jeong Yoo, Min-Hyeon Park, Jae Hyun Yoo, Minha Hong, Geon Ho Bahn
      Journal of the Korean Academy of Child and Adolescent Psychiatry.2020; 31(4): 201.     CrossRef
    • Journal metrics of Clinical and Molecular Hepatology based on the Web of Science Core Collection
      Sun Huh
      Clinical and Molecular Hepatology.2018; 24(2): 137.     CrossRef
    • Promotion ofNeurointerventionto International Journal Based on Journal Metrics
      Sun Huh
      Neurointervention.2016; 11(1): 5.     CrossRef
    • Journal of Gastric Cancer's Promotion to International Journal from the Perspective of Biliometric Analysis
      Sun Huh
      Journal of Gastric Cancer.2016; 16(1): 8.     CrossRef
    • Clinics in Orthopedic Surgery's Evolution into an International Journal Based on Journal Metrics
      Sun Huh
      Clinics in Orthopedic Surgery.2016; 8(2): 127.     CrossRef
    • How much progress has been made in journal metrics two years after the citation analysis of theKorean Journal of Urology?
      Sun Huh
      Korean Journal of Urology.2015; 56(4): 276.     CrossRef
    • Evidence of the Internationalization ofClinical EndoscopyBased on Journal Metrics
      Sun Huh
      Clinical Endoscopy.2015; 48(4): 317.     CrossRef
    • The Elevation ofAnnals of Rehabilitation Medicineto the Status of an International Journal After Adopting an English-Only Policy
      Sun Huh
      Annals of Rehabilitation Medicine.2015; 39(5): 661.     CrossRef
    • How Journal Metrics Illustrate the Transformation of Archives of Plastic Surgery into an International Journal
      Sun Huh
      Archives of Plastic Surgery.2014; 41(06): 617.     CrossRef
    • What is the position ofClinical and Experimental Reproductive Medicinein its scholarly journal network based on journal metrics?
      Sun Huh
      Clinical and Experimental Reproductive Medicine.2014; 41(4): 147.     CrossRef

    Figure
    • 0
    • 1
    • 2
    Related articles
    Coding practice of the Journal Article Tag Suite extensible markup language
    Image Image Image
    Fig. 1. Screenshot of sample.xml file seen with browser when there was no other file or journalpublishing1.dtd file at the same directory with sample.xml.
    Fig. 2. Screenshot of sample.xml file seen when there were journalpublishing1.dtd and jats-html.xsl files at the same directory with sample.xml.
    Fig. 3. Screenshot of sample.xml file seen when there were journalpublishing1.dtd, jats-html.xsl, and jats-preview.css files at the same directory with sample.xml.
    Coding practice of the Journal Article Tag Suite extensible markup language

    Science Editing : Science Editing
    TOP