inara

Tools to create Open Journals publishing artifacts.

The package is designed to be usable either via its Makefile, or through a Docker image.

Generated output formats are HTML, PDF, JATS, and Crossref XML.

Usage via Docker

The directory of the paper, or one of its parent directories, must be mounted on path /data. The path to the paper, relative to the mounted folder, is expected as the only argument.

• The Docker image will generate PDF and JATS files by default. To select specific output formats to be generated use the -o flag. Supported options are: pdf, jats, html, crossref, cff, and preprint. To get multiple outputs use a comma separated list.
• By default PDF files will be compiled in draft mode to include a draft watermark and linenumbers. To create a production PDF add the -p flag.
• There is a special flag -r meant for retraction notices that don't need to show Software/Editor/Reviewes/Submission-date information.
• The target journal can be set using the JOURNAL ENV VAR. Currently the valid values are: joss, jose or resciencec

Example:

docker run --rm -it \
    -v $PWD:/data \
    -u $(id -u):$(id -g) \
    openjournals/inara \
    -o pdf,crossref \
    path/relative/to/current/directory/paper.md

The resulting PDF and Crossref-XML files will be named paper.pdf and paper.crossref and placed next to the input file.

Usage via make

The make command should be run from the project's root directory. It expects the article source to be passed via the ARTICLE variable. So if the paper Markdown source is in file /my/path/paper.md, then make should be called with

make ARTICLE=/my/path/paper.md

All supported publishing formats are generated by default, but you can select a specific format to be generated by passing it as an argument. Available options: html, pdf, jats, crossref, cff, and preprint.

E.g., to generate only a PDF file, the command would be

make pdf ARTICLE=/my/path/paper.md

The generated output will be written to folder publishing-artifacts.

Dependencies

Inara is built on pandoc, and requires a recent pandoc version. The latest pandoc version can be downloaded from https://github.com/jgm/pandoc/releases/latest.

PDFs are generated via LaTeX; for best results, all packages listed in Dockerfile should be installed.

You will also need the Hack font by source-foundry.

Versions

Inara is versioned using SemVer. Docker images are tagged with the version; tagged images are available for all published versions. The current development version is published as an image tagged edge.

Deployment

After minting a new version, update the configuration in https://github.com/xuanxu/publishing-artifacts-action to reflect the new version, such as in xuanxu/publishing-artifacts-action#1.