Metanorma
On this page

Metanorma-CC library documentation

Library documentation for Metanorma-CC, the Metanorma flavor for CalConnect standards. Synced from the upstream gem README at github.com/metanorma/metanorma-cc.

Functionality

This gem processes Metanorma documents following the Metanorma model for generating CalConnect Standards.

The gem currently inherits from the https://github.com/metanorma/metanorma-standoc gem, and aligns closely to it. Refer to https://metanorma.com[] for guidance.

Usage

The preferred way to invoke this gem is via the metanorma script:

$ metanorma --type cc a.adoc                   # output HTML and PDF
$ metanorma --type cc --extensions html a.adoc # output just HTML
$ metanorma --type cc --extensions pdf a.adoc  # output just PDF
metanorma --type cc --extensions xml a.adoc  # output Metanorma XML</code></pre></div><p>The gem translates the document into Metanorma XML format, and then validates its output against the CC Metanorma XML document model; errors are reported to console against the XML, and are intended for users to check that they have provided all necessary components of the document.</p><p>The gem then converts the XML into output formats such as HTML and PDF.</p><section id="_usage_installation"><h3 id="_usage_installation">Installation</h3><p>If you are using a Mac, the <a href="https://github.com/metanorma/metanorma-macos-setup" target="_blank" rel="noopener">https://github.com/metanorma/metanorma-macos-setup</a> repository has instructions on setting up your machine to run Metanorma scripts such as this one. You need only run the following in a Terminal console:</p><div class="code-block" data-code-block><pre><code class="language-console"> bash <(curl -s https://raw.githubusercontent.com/metanorma/metanorma-macos-setup/master/metanorma-setup)
$ gem install metanorma-cc

Documentation

See Author CalConnect documents with Metanorma CC.

Examples

Notes

Metanorma-CC was formerly published as asciidoctor-csd and metanorma-csd.