Metanorma: Aequitate Verum

Getting started with Metanorma on Windows

Install Chocolatey

For a simpler command-line experience, first install the Chocolatey package manager: please follow the official installation instructions.

Then, add the Ruby install that is packaged with MSYS2 build tools. This process is explained below:

  1. Open a command prompt (cmd.exe) or PowerShell console.

  2. Type choco install -y msys2 ruby. (If you have a firewall, you may be prompted to allow dirmngr.exe and pacman.exe. These are part of Ruby and are safe).

  3. When the installation completes, type refreshenv to make Ruby available to you.

  4. Type ridk install 3 to complete the installation of Ruby version 3. This make take a while.

Install Metanorma via Chocolatey

Once you have installed Cholocaley, run the following in your cmd.exe or PowerShell to install the Metanorma Chocolatey package:

choco install metanorma -y

See the blog post on Metanorma Chocolatey package for more background information.

Install Ruby

Ruby is not pre-installed on Windows. There are several ways to install it:

  1. For an easy experience, use RubyInstaller, via the official Ruby installation guide

  2. For a more developer-friendly experience, install Ruby via a Linux distribution (like Ubuntu) hosted in the Windows Subsystem for Linux (WSL). Install WSL2, and then Install Ruby.