CaSSius is a tool to create beautiful paginated PDF documents from NLM/JATS. Under the hood, v0.2 of CaSSius uses the pagination polyfill from pagedjs. It is intended to be part of XML-first/XML-in workflows for scholarly communications but may have alternative uses.
CaSSius: heavyweight typesetting with lightweight technology.
Usage and Quick Start Guide
Usage: cassius.py <in-file> <out-file> [options] cassius.py (-h | --help) cassius.py --version cassius.py --debug
CaSSius takes NLM/JATS XML and produces a PDF file from the results. To begin using CaSSius on a Linux system, follow these steps:
- Ensure that you have all of the requirements in requirements.txt installed and are using Python 3.
- Install Google Chrome in order to generate the PDF.
- Copy CaSSius.css to the directory with your input files and modify as appropriate.
- Run src/cassius.py from within that directory, specifying the input XML and the desired output PDF file.
If something isn't working, please try with the --debug option. Furthermore, please verify the JATS structure against the provided samples.
Various sample XML files can be found in the "samples" directory.
CaSSius creates PDF files by headless printing of documents in Google Chrome.
Components and Licensing
CaSSius is copyright Martin Paul Eve 2020. It is released under the terms specified in LICENSE.
CaSSius makes use of several other open-source/free-software projects, including:
- paged.js. Copyright (c) 2018 Adam Hyde under the MIT license.
- jQuery. Under the MIT license.
- docopt. Copyright (c) 2012 Vladimir Keleshev, firstname.lastname@example.org with an MIT license.
- The Open Library of Humanities logo, distributed with samples, is (c) and a trademark of the Open Library of Humanities. No re-use rights of this logo beyond distribution with the samples are bestowed by the above license.
- The CaSSius logo is a derivative of a work by Lil Squid from the Noun Project, licensed under the Creative Commons Attribution License.
- Parts of the cassius library contain materials from the National Library of Medicine, specifically adaptations of their XSLT suite and entity resolution files, which are public domain.