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.
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.
-o
flag.
Supported options are: pdf
, jats
, html
, crossref
, cff
, and preprint
. To get multiple outputs
use a comma separated list.-p
flag.-r
meant for retraction notices that don't need to show Software/Editor/Reviewes/Submission-date information.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.
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
.
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
.
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.