Publishing in HTML and XML

OJS supports various galley formats; these are the final publication-ready files that journals prepare for readers and publish on the article page. These formats include PDF, HTML, XML and ePub. OJS also supports multimedia formats like MP3 and videos.

PDF is the most common galley format that journals publish. It is the easiest to convert and is preferred as it closely resembles a printed page. For journals considering offering more galley formats, this blog highlights some of the benefits and considerations for publishing HTML and XML.

HTML

HTML stands for Hyper Text Markup Language and is the standard markup language for web pages. HTML primarily contains text; however, it is possible to embed images and multimedia links. With Cascading Style Sheets (CSS) journals can modify how their HTML files look.

HTML code sample
Example of HTML code

Benefits of publishing full-text HTML

Flexibility. As mentioned, HTML allows you to embed images, tables, figures, and multimedia files. Embed links on an HTML file when needed by editing the file.

Reader-friendly. Like OJS, it is also responsive, meaning text will resize to fit various screen sizes. It is both human and machine-friendly, which allows for text to be easily searchable. Machine-friendly formats allow for better accessibility, ensuring your content reaches the broadest audience possible.

Discoverability. As the standard web language, a clean HTML makes content easily detectable by bots that index and rank the content in Google and Google Scholar. The Google Scholar Inclusion Guidelines list HTML as an acceptable file format for inclusion.

Considerations

Time and Resources. HTML requires additional tools and/or software to create and it takes more effort than creating a PDF. It also requires some understanding of HTML to review and update links if necessary.

For an example of an HTML Galley, see International Journal of Therapeutic Massage & Bodywork

XML (JATS)

XML stands for eXtensible Markup Language, a markup language like HTML. JATS stands for Journal Article Tag Suite, an XML format used to describe scientific literature published online. The XML viewer on OJS supports JATS XML galley files.

Example of XML Code

Benefits of publishing JATS XML

Reader-friendly. Provides a clean and straightforward way to view an article. XML viewers separate the article into sections that allow users to easily navigate around the article.

Extensible metadata. Unlike HTML, XML tagging is semantic. It contains more metadata about the article, including funders, submission, and acceptance dates.

Discoverability. It is also human and machine-readable. More metadata allows content to be discoverable for a quicker more accurate search.

Considerations

For journals looking to be indexed in PMC, XML is one of the data files required in the sample package as part of the technical evaluation phase. Similar to HTML, it requires some knowledge of XML along with resources to create these files.

For an example of an XML Galley, see Polar Research

To learn more about how to create XML and HTML files, see PKP’s Learning OJS guide. For journals looking for additional assistance with Typesetting and preparing these galley formats, please contact our affiliated partners, Open Academia.