sts2mn Ruby gem
Purpose
The sts2mn Ruby gem is a wrapper around the Java sts2mn which converts NISO STS and ISOSTS into Metanorma XML and AsciiDoc files.
This gem is used to provide sts2mn.jar with mirrored version numbers, to allow Ruby code to easily refer to the desired sts2mn version as dependencies.
Installation
gem install sts2mn
Or include it in your gemspec.
Usage
require 'sts2mn'
Sts2mn.convert(input: 'test/sts.xml')
# => generates 'test/sts.adoc', in Metanorma AsciiDoc
Sts2mn.convert(input: 'test/sts.xml', output: 'another/path/mn.xml', format: 'xml')
# => generates 'another/path/mn.xml' in Metanorma XML
Sts2mn.convert(input: 'test/sts.xml', output: 'another/path/mn.adoc', format: 'adoc')
# => generates 'another/path/mn.adoc' in Metanorma AsciiDoc
Sts2mn.split_bibdata('test/sts.xml')
# => generates 'test/sts.rxl' (Relaton XML) and 'test/mn.adoc' (Metanorma AsciiDoc)
Updating the gem
Update lib/sts2mn/version.rb
to the desired version of sts2mn.
Run rake
to download the bin/sts2mn.jar
file:
rm -f bin/sts2mn.jar
rake bin/sts2mn.jar
Then release the gem with rake release
.