metanorma/mn2sts-ruby

= mn2sts Ruby gem

image:https://img.shields.io/gem/v/mn2sts.svg["Gem Version", link="https://rubygems.org/gems/mn2sts"]
image:https://github.com/metanorma/mn2sts-ruby/workflows/rake/badge.svg["Build Status", link="https://github.com/metanorma/mn2sts-ruby/actions?query=workflow%3Arake"]
image:https://codeclimate.com/github/metanorma/mn2sts-ruby/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/mn2sts-ruby"]
image:https://img.shields.io/github/issues-pr-raw/metanorma/mn2sts-ruby.svg["Pull Requests", link="https://github.com/metanorma/mn2sts-ruby/pulls"]
image:https://img.shields.io/github/commits-since/metanorma/mn2sts-ruby/latest.svg["Commits since latest",link="https://github.com/metanorma/mn2sts-ruby/releases"]

== Purpose

The mn2sts Ruby gem is a wrapper around the Java https://github.com/metanorma/mn2sts[mn2sts]
which converts Metanorma XML files into native PDFs.

This gem is used to provide mn2sts.jar with mirrored version numbers, to allow
Ruby code to easily refer to the desired mn2sts version as dependencies.

== Installation

[source,ruby]
----
gem install mn2sts
----

Or include it in your gemspec.

== Usage

[source,ruby]
----
require 'mn2sts'
Mn2sts.convert(sample_xml_path, output_pdf_path)
----

== Updating the gem

Update `lib/mn2sts/version.rb` to the desired version of https://github.com/metanorma/mn2sts[mn2sts].

Run `rake` to download the `bin/mn2sts.jar` file:

[source,ruby]
----
rm -f bin/mn2sts.jar
rake bin/mn2sts.jar
----

Then release the gem with `rake release`.