Getting started with Metanorma on Windows
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:
Open a command prompt (
cmd.exe) or PowerShell console.
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).
When the installation completes, type
refreshenvto make Ruby available to you.
ridk install 3to 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
PowerShell to install the Metanorma Chocolatey package:
choco install metanorma -y
See the blog post on Metanorma Chocolatey package for more background information.
Ruby is not pre-installed on Windows. There are several ways to install it:
For an easy experience, use
RubyInstaller, via the official Ruby installation guide
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.