hassoon1986/metanorma-linux-setup

Metanorma setup script for Linux

Metanorma Linux Setup

Purpose

This repository provides installation of the Metanorma publication toolchain on Linux.

Requirements

• Ubuntu (18.10 down to 12.04)

• CentOS 7.x

Older versions may work but are not tested.

Install on Ubuntu

# Prerequisites: "curl"
# apt-get update && apt-get install -y curl
sudo bash -c "curl -L https://raw.githubusercontent.com/metanorma/metanorma-linux-setup/master/ubuntu.sh | bash"
curl -L https://raw.githubusercontent.com/metanorma/metanorma-linux-setup/master/install-gems.sh | bash

Note	The first command has to be run via sudo.

Install on CentOS

# Prerequisites: "curl"
# yum install -y curl
sudo bash -c "curl -L https://raw.githubusercontent.com/metanorma/metanorma-linux-setup/master/centos.sh | bash"
curl -L https://raw.githubusercontent.com/metanorma/metanorma-linux-setup/master/install-gems.sh | bash

Note	The first command has to be run via sudo.

What it sets up

• bundler for managing [Ruby] gems

• Java which is a dependency for some of the Metanorma gems

• Node.js (includes latest Node.js and NPM, for running apps and installing JavaScript packages)

• puppeteer for running Headless Chrome via Node.js (used to generate PDFs from HTML)

• PlantUML for creating UML diagrams via plain-text

Debugging

METANORMA_DEBUG environment variable was introduced which will: * Enable more verbose logging * Enable tests on dependent components (like latexml)

If you run into any problems, please copy and paste the entire log into a new GitHub Issue for us.