Manual Installation of Metanorma

General

The metanorma command-line executable is installed by this Ruby gem.

Important

Users of the Metanorma suite should install Metanorma according to the steps at the Metanorma installation guide.

The instructions provided here are intended for Metanorma developers, since a number of third-party dependencies will also need to be installed manually.

Install Ruby

Depending on your platform, please refer to:

Other Ruby Resources

Further details (or FAQ) on Ruby installation please visit the official Ruby installation guide.

Installing the Metanorma CLI gem

Once Ruby is installed, you can install metanorma-cli as a gem:

gem install metanorma-cli

Installing the gem will also install all officially supported Metanorma flavors (such as ISO, CalConnect, IETF, etc).

Dependencies

Java

You will have to have a Java runtime installed.

Use the following commands on various platforms:

macOS: Run brew cask install java
Linux: Follow official instructions
Windows: Run choco install -y javaruntime

PlantUML

If your documents include PlantUML diagrams, PlantUML will have to be installed.

macOS: Run brew install plantuml.
Linux: Link the PlantUML jar file into a command line executable; see .travis.yml for an example.
Windows: Run choco install -y plantuml.

If PlantUML diagrams used within a document but there PlantUML is not installed, the PlantUML diagram source will be incorporated into the output document as source code (i.e. [source] style).

Graphviz

Graphviz is required by LutaML (and PlantUML) to draw diagrams.

macOS: Run brew install graphviz.
Linux: Install the appropriate available packages (apt or yum)
Windows: Run choco install -y graphviz

xml2rfc

Metanorma IETF requires usage of the xml2rfc Python package.

To install Python:

macOS: brew install python3
Windows: choco install -y python

Then install xml2rfc with:

pip3 install xml2rfc

Inkscape

Optional dependency. Inkscape is needed for SVG-to-EMF conversion functionality.

macOS: Run brew install inkscape
Linux: See Linux instructions here
Windows: Run choco install -y inkscape

LaTeXML

Optional dependency. LaTeXML is needed for Metanorma for LaTeX functionality.

Most of the packages from various package manager listed on https://dlmf.nist.gov/LaTeXML/get.html are outdated.

Since LaTeXML is a perl module, a reliable way to install it is with the cpanm package manager

curl -L https://cpanmin.us | perl - --sudo App::cpanminus
cpanm --notest LaTeXML
# or
cpanm --notest git://github.com/brucemiller/LaTeXML.git@9a0e7dc5

Alternative, it also can be installed in the following ways (always check the version, because the packages may be outdated):

macOS: Run brew install latexml
Linux (with Snap installed): Run snap install latexml
Windows: choco install -y latexml