OJS3 Plugin for parsing JATS XML and displaying it on article detail page.
- JATS XML to HTML conversion.
- JATS XML to PDF conversion.
- Article's metadata now is taken directly from OJS (no need to populate JATS XML meta nodes).
- Article's reference list can be taken from JATS XML or OJS (option in the plugin settings).
- Support for figures attached to the XML through OJS dashboard.
How to use?
- Download the latest release
- Upload the plugin from the admin dashboard
Website Settings -> Plugins -> Upload a New Plugin(make sure php.ini variables
post_max_sizea set to equal or more than 16M) or unpack the archive into the
- Activate the plugin from the dashboard.
- To change image logo in resulted PDF just replace
JATSParser/logo/logo.jpgfile by yours.
After activation the plugin adds new item to the publication form: The first select option contains the list of XML files uploaded to the production ready stage where is possible to pick the file that will be converted and saved as article's full-text. Before saving, a result of a conversion can be previewed. Under the hood the conversion process transforms JATS XML into HTML and saves the results in the database.
After publication full-text will be shown on the article landing page under the abstract.
Installation for development
- Navigate to
plugins/genericfolder starting from OJS webroot.
git clone --recursive https://github.com/Vitaliy-1/JATSParserPlugin.git jatsParser.
- To install support for JATS to PDF conversion:
- PHP 7.3 or higher
- OJS 3.1+
- Lens Galley Plugin must be turned off
- Example of the JATS XML: https://github.com/Vitaliy-1/JATSParser/blob/master/example.xml
- HTML example: http://ojsdemo.e-medjournal.com/index.php/jatsparser/article/view/8/8
- PDF example: http://ojsdemo.e-medjournal.com/index.php/jatsparser/article/view/8/8?download=pdf
Starting from this version JATS Parser Plugin starts to serve HTML statically and will no longer support rendering of the full-text on the fly on the galley page. Instead full-text is generated on demand from production ready JATS XML files and saved as a part of the publication.