Metanorma
On this page

Running Metanorma with Docker

Installing Metanorma via Docker

Instead of "installing", the Metanorma Docker container makes running Metanorma a breeze for those that already run Docker.

Docker is a platform-independent container engine that allows one to run packaged software easily as all dependencies are bundled within a container image.

.Possible reasons to avoid running in Docker

Example
  • Performance. Using Metanorma inside Docker container is likely to be be slower.
  • Windows. Docker on Windows require an explicit folder sharing settings in order to share a local filesystem (e.g. a Metanorma document directory) to the container.

The steps are straightforward.

Pulling the Metanorma Docker container

  1. Pull the container:

Running Metanorma using the Docker container

  1. Specify the :local-cache-only: Metanorma attribute in the AsciiDoc document header to cache bibliographic entries in the local directory (where the command was run) (optional).
  2. To render a Metanorma document into its intended outputs, execute from within the directory containing the Metanorma document (replacing {my-document-path} with your actual document's filename):
  3. You can speedup document compilation by caching fonts between docker runs by passing extra docker volume. More information on font caching is found on the Font Management page.
Note
Commands other than metanorma compile ... are also available on the Docker containers. See the Usage page of Metanorma CLI for more details.
Tip

See the metanorma-docker repository for more information.