Installation

Tip	To use Metanorma, normally you don’t manually install this gem. Depending on your setup, you may find quicker ways to get started: please refer to Getting Started instead.

To install this gem, simply run:

gem install metanorma-cli

This will install the metanorma executable, which you can use with all officially supported Metanorma flavors (such as ISO, CalConnect, IETF, etc).

However, a number of dependencies are not installed with this gem, and have to be installed separately. The process of installing the full suite can be a little more complex.

Generally, we recommend you to follow steps given at Metanorma Installation.

But if you aren’t afraid of tinkering deeply, please see the Developer Installation Notes for advanced details regarding dependencies and Windows installation notes.

External dependencies

The Metanorma toolchain supports certain features when optional dependencies are installed. Please refer to the following table for them.

Dependency	Mandatory?	Target component / purpose
git	:white_check_mark:	metarnoma-cli (templates), fontist
java	:white_check_mark:	mn2pdf, metanorma-standoc
xml2rfc (python)	:white_large_square:	metanorma-ietf
inkscape	:white_large_square:	isodoc, SVG to EMF functionality (for inserting SVGs into Word)
graphviz	:white_check_mark:	lutaml generation of LutaML diagrams
plantuml	:white_large_square:	metanorma-standoc generation of PlantUML diagrams

Usage

Refer to Metanorma CLI usage.

Credits

This gem is developed, maintained and funded by Ribose Inc.

License

The gem is available under the terms of the MIT License.