/manubot

The manuscript bot for automated scholarly publishing

Primary LanguagePythonOtherNOASSERTION

The manuscript bot for automated scholarly publishing

Build Status

The Manubot Python package prepares scholarly manuscripts for Pandoc consumption. It automates and scripts several aspects of manuscript creation, including fetching bibliographic metadata for citations.

This program is designed to be used with clones of Manubot Rootstock, which perform Pandoc conversion and continuous deployment. See the Manubot Rootstock usage guide for more information.

Usage

Installing the python package creates the manubot command line program. This program is the primary interface to using Manubot. There are two required arguments: --content-directory and --output-directory, which specify the respective paths to the content and output directories. The content directory stores the manuscript source files. Files generated by Manubot are saved to the output directory.

One common setup is to create a directory for a manuscript that contains both the content and output directory. Under this setup, you can run the Manubot using:

manubot \
  --content-directory=content \
  --output-directory=output

See manubot --help for documentation of all command line arguments.

Installation

Install the version specified by a git commit hash using:

COMMIT=33e512d21218263423de5f0d127aac4f8635468f
pip install git+https://github.com/greenelab/manubot@$COMMIT

Use the --upgrade argument to reinstall manubot with a different commit hash.