Building and distributing a single combined Metanorma artifact using Data URIs

This post describes the how Metanorma leverages Data URIs for media files and document attachments to create a single, unified XML document for seamless distribution, and when it is necessary to disable Data URI encoding in cases.

Persistent error logs for more effective document engineering

Metanorma now provides persistent error logs for detailed debugging post-compilation. This post explains how to navigate and utilize these logs effectively.

Selectively including Enterprise Architect diagrams from XMI exports

Enterprise Architect diagrams can now be included through the lutaml_ea_diagram command given an XMI export.

Rendering GML Dictionary objects

Render GML Dictionary files using the new command lutaml_gml_dictionary.

Metanorma now supports PDF attachments

Metanorma-generated PDFs now support attachments, offering a more robust method for bundling related documents and resources.

Encoding and rendering special characters in Metanorma

Metanorma allows extending the default font sets for demanding cases of glyph rendering, ensuring that even the most complex documents are rendered accurately and in compliance with international standards.

The ISO Rice model document, 3rd edition

ISO Rice document that has been used as a sample document to demonstrate the usage of Metanorma in ISO flavor has now been updated to the 3rd edition.

Encode OGC ModSpec using `yaml2text` templates

Take advantage of the yaml2text template capabilities to encode large amounts of ModSpec requirement instances in fewer lines of markup.

Developing ITU-T Recommendations in Metanorma

Metanorma now supports encoding of ruby characters, often used in documents in East Asian languages.

ITU: new layouts for Technical and Service publications (Flagship)

Metanorma for ITU now supports the new ITU cover page layout for Technical and Flagship publications in PDF.

Ruby encoding for East Asian languages now available

Metanorma now supports encoding of ruby characters, often used in documents in East Asian languages.

Managing Metanorma versions on Linux using Snap

Easily manage Metanorma versions on Linux using Snap packages.

Validating against ISO House Style

Metanorma validation against the ISO House Style for ISO deliverables has been updated to the 2023 version of the style guide.

mnconvert supports IEC/ISO NISO STS Coding Guidelines 1.0

mnconvert now produces NISO STS XML in accordance with IEC/ISO NISO STS Coding Guidelines.

Bibliographic information auto-fetch using DOIs now supported

Metanorma now supports auto-fetching bibliographic information using DOI identifiers through the latest Relaton-DOI.

Convert ISO/NISO STS documents to Metanorma using mnconvert

Metanorma now supports converting ISO STS and NISO STS XML formats into Metanorma formats through its mnconvert conversion tool.

Annotations now available in all Metanorma outputs

Editor notes, reviewer notes and to-dos are now available across Metanorma output formats, now including PDF.

Reviewer annotations are available now in Metanorma PDFs

Metanorma-generated PDFs contain now reviewer notes and comments annotated by Metanorma reviewer comments AsciiDoc markup feature.

Introducing the Metanorma collection, through the SI Brochure

Metanorma now supports Metanorma collections, a feature that allows a set of Metanorma documents to be published in flexible configurations.

Validating against ISO House Style

The ISO House Style has recently been published publicly, and Metanorma now supports validation of the ISO House Style for ISO deliverables, in addition to ISO/IEC DIR 2.

Working with special drafting requirements: the ISO 8000 series

Some ISO Technical Committees and Working Groups have additional requirements how drafts are prepared on top of those from ISO DIR 2 and ISO House Style. This blog post uses an example from the ISO 8000 series to demonstrate how it works.

Introducing NIST PubID, and the migration of publication identifiers

Brief introduction to the NIST PubID, the latest human-readable publication identifier syntax at NIST, and the effort behind to migrate existing identifiers.

Metanorma now offers PDF protection mechanisms!

Metanorma-generated PDFs now support encryption and other PDF protection features.

Accessibility tagging in Metanorma PDFs

Metanorma-generated PDFs utilize advanced tagging structures provided by the ISO 32000-1:2008 PDF standard to best facilitate usage of assistive technologies.

Making math accessible in Metanorma PDFs

The BIPM SI Brochure utilizes several advanced PDF techniques for accessibility, not only using PDF/UA features but also making math formulas accessible for non-Adobe PDF viewers.

Using Metanorma with proxies (HTTPS, SOCKS)

Metanorma now supports Internet access via HTTP/HTTPS and SOCKS proxy servers!

New functionality: Concept mentions

New "concept mentions" functionality for semantic encoding of term instances!

Halfway into Google Season of Docs

Ankita and Tina reporting for duty: A summary of the first half of GSoD.

Kickoff to Metanorma's Google Season of Docs 2021

Ankita Tripathi and Tina Lüdtke selected as Metanorma GSoD writers 2021!

Metanorma accepted by Google's Season of Docs 2021

Metanorma is now recruiting an open-source technical writer for its GSoD 2021 season!

Metanorma proposal for Google's Season of Docs 2021

Improving Metanorma documentation through GSoD 2021!

Metanorma CLI: new font processing options

Learn about new font processing options now available in Metanorma CLI

Generate document sites with the Metanorma CLI

Generate a document site for a set of documents using Metanorma CLI

Updated "include" behaviour in Metanorma AsciiDoc

Recent changes to Metanorma AsciiDoc processing of included files.

Yaml2Text now supports YAML with Liquid

Importing YAML data into Metanorma using Liquid!

Upgrading Metanorma IETF documents from metanorma-ietf v1 to v2

This post describes steps to migrate Metanorma IETF documents from metanorma-ietf v1 to v2.

Installing LaTeXML for Metanorma (and tex2mn)

There are many ways to install LaTeXML depending on your needs

Using YAML as data source

Import YAML data into Metanorma has never been so easy

Saving Metanorma Word Documents

Post-processing of Metanorma Microsoft Word output

Metanorma IETF v2 released with native RFC XML v3 support

Metanorma IETF at 2.0 now fully supports RFC XML v3 input.

Compiling IETF RFCs with Metanorma and LaTeX

We’ve had great progress with the LaTeX backend of Metanorma since alpha support was announced!

Metanorma datamodel directive

Metanorma now supports directive for building datamodels.

Metanorma more accessible than ever with WCAG compliance

Learn about newly available accessibility features in Metanorma, including on how to make your documents compliant to Section 508.

Metanorma now supports LaTeX input (tex2mn in alpha!)

Metanorma now supports LaTeX input, in alpha!

Metanorma now supports IEC standardization deliverables

Metanorma now supports authoring IEC International Standards.

Guidance on NOTEs and EXAMPLEs in ISO deliverables

ISO has provided updated advice on styling of notes and examples.

Announcing Metanorma support for TeX math

Until recently, Metanorma has only processed AsciiMath and MathML. Now Metanorma also accepts some WYSIWYM methods for writing mathematical formulas.

Metanorma templates for CalConnect, OGC and ISO documents

Metanorma now supports templates for CalConnect, OGC and ISO documents.

Metanorma available for macOS as Homebrew formula

Metanorma is now available on macOS as a native install through the Homebrew package manager.

Writing in AsciiDoc, Part 4

Two types of section have specialized content, which requires additional markup: Terms and definitions, and Bibliographies.

Metanorma now available on Windows as Chocolatey package

Metanorma is now available on Windows as a native install package through the Chocolatey package manager.

Writing in AsciiDoc, Part 3

AsciiDoc documents are text; so if you already have a document in a PDF file, or a Word file, or an HTML file, the simplest thing to do is to copy its text into a text document, and then to mark it up.

Writing in AsciiDoc, Part 2

By gradually building up the document, and testing it as you go, you can prevent unpleasant surprises later on.

Writing in AsciiDoc

AsciiDoc documents are text; so if you already have a document in a PDF file, or a Word file, or an HTML file, the simplest thing to do is to copy its text into a text document, and then to mark it up.

What Metanorma is

Metanorma defines common formatting and conventions across standards; the various flavors provide functionality specific to each standards body. That includes different validation, different formatting options, and different styling.

What Metanorma is for

Why Metanorma? If you’re in the business of writing standards documents, you are in the business of writing some of the most complicated documents there are. Here’s a better alternative than …​ Microsoft Word.

Metanorma wins two Gold Stevie Awards at 2018 International Business Awards

This year’s judges lauded the development of Metanorma as a "revolutionary concept", noting that, "Setting standards for standardization is a very important requirement. This is a great initiative." Another judge remarked that to anyone who has to administrate such standards, Metanorma "will seem like a godsend."