Sha256: 4c1e508db4b90812dc256850af6f7a946f149407680a22d91556e8ca57c1437a

Contents?: true

Size: 1.62 KB

Versions: 92

Compression:

Stored size: 1.62 KB

Contents

= mn2pdf Ruby gem

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

== Purpose

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

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

== Installation

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

Or include it in your gemspec.

== Usage

[source,ruby]
----
require 'mn2pdf'
Mn2pdf.convert(sample_xml_path, output_pdf_path, sample_xsl_path, options = "")
----

The options are any options trailing in the mn2pdf Java executable, e.g. `--split-by-language`.

== Updating the gem

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

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

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

Then release the gem with `rake release`.


Version data entries

92 entries across 92 versions & 1 rubygems

Version Path
mn2pdf-2.16 README.adoc
mn2pdf-2.15 README.adoc
mn2pdf-2.14 README.adoc
mn2pdf-2.13 README.adoc
mn2pdf-2.12 README.adoc
mn2pdf-2.11 README.adoc
mn2pdf-2.10 README.adoc
mn2pdf-2.09 README.adoc
mn2pdf-2.08 README.adoc
mn2pdf-2.07 README.adoc
mn2pdf-2.06 README.adoc
mn2pdf-2.05 README.adoc
mn2pdf-2.04 README.adoc
mn2pdf-2.03 README.adoc
mn2pdf-2.02 README.adoc
mn2pdf-2.01 README.adoc
mn2pdf-2.00 README.adoc
mn2pdf-1.99 README.adoc
mn2pdf-1.98 README.adoc
mn2pdf-1.97 README.adoc