Introducing Windows Docker containers for Metanorma

Metanorma announces the availability of native Windows Docker containers, enabling true Windows-based workflows in Docker and GitHub Actions for standards developers.

Metanorma CLI 1.11.5: Presentation XML Term Preservation and Bibliography Improvements

This release enhances Presentation XML with preserved term semantics, improves bibliography handling, fixes configuration path resolution, and includes targeted improvements for ITU documents.

Metanorma CLI 1.11.4: Enhanced Requirements Management and ISO Document Support

This release focuses on requirements management improvements, ISO document enhancements, Japanese internationalization, and important ITU and JIS format-specific refinements.

Metanorma CLI 1.11.3: Enhanced Bibliography Encoding and Mathematical Expression Processing

This release features updated bibliography encoding, improved mathematical expression processing, refined indexing capabilities, and several format-specific enhancements for diverse document types.

Metanorma CLI 1.11.2: Comprehensive Presentation XML Refinements and Advanced Language Support

This release brings major enhancements to Presentation XML with semantic annotations for autonumbering, captions, and cross-references, along with improved handling of multilingual content and refined support for IETF, IHO, and BIPM documents.

Metanorma CLI 1.11.1: Version Reporting Hotfix

This hotfix release refines version reporting functionality to exclude deprecated Metanorma flavors, ensuring more accurate and relevant system information.

Metanorma CLI 1.11.0: Major Presentation XML Enhancements and Document Structure Improvements

This milestone release features significant architectural changes to Presentation XML, greater flexibility in document structure, improved annotation of document identifiers, and numerous format-specific enhancements.

Document text line numbers are available in Metanorma documents

Metanorma allows to include the line numbers in the generated ISO and IEEE PDFs, and also allows to line numbering for the source code snippets.

Support for historical ISO versions

This post describes how Metanorma supports legacy versions of ISO standards.

Metanorma CLI 1.10.11: Enhanced Flexibility in Document Attributes and Comprehensive East Asian Language Support

This release introduces flexible document attribute prefixing, enhanced CJK punctuation handling, powerful Japanese numbering options, improved bibliography rendering, and numerous collection processing refinements.

Support for Japanese internationalisation

This post describes how Metanorma internationalises content, specifically for Japanese, in light of Metanorma supporting JIS and Plateau as new flavours.

Metanorma CLI 1.10.10: Optimized Document Processing and Enhanced Framework Consistency

This release focuses on optimization of document validation and collection processing, restoration of UnitsML markup, improved module naming consistency, and format-specific enhancements for ISO, NIST, and other standards types.

Building and distributing a single combined Metanorma artifact using Data URIs

This post describes 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.

Metanorma CLI 1.10.9: Advanced Number Formatting and Enhanced Error Logging

This release introduces sophisticated number formatting options, improved error logging with filtering capabilities, new plugin integrations, refined collection handling, and IHO-specific enhancements for greater document precision and flexibility.

Metanorma CLI 1.10.8: Enhanced XML Documentation and Cross-Reference Validation

This release introduces comprehensive documentation of Semantic and Presentation XML grammar, establishes better defaults for mathematical formulas, improves bibliographic metadata handling, and enhances document validation capabilities.

Metanorma CLI 1.10.7: Refined Formula Formatting and Internationalization Improvements

This release enhances mathematical formula presentation, expands internationalization capabilities for Japanese content, and refines document attachment handling and bibliographic formatting across multiple document types.

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.

Metanorma CLI 1.10.6: Enhanced Document Structure and Improved Requirements Management

This release introduces flexible document structures with unnumbered annexes and collapsible snippets, enhanced requirements management with customizable classification, and significant improvements to configuration options and bibliographic formatting.

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.

Metanorma CLI 1.10.4 & 1.10.5: Line Break Handling and Document Attachment Improvements

This combined release includes critical fixes to line-break handling in CJK text and significant improvements to document attachment processing, making document collections more robust and flexible.

Metanorma CLI 1.10.3: Internationalization Advancements and Image Processing Improvements

This release brings significant enhancements to internationalization capabilities, particularly for Japanese and East Asian languages, improved mathematical notation, and more intelligent handling of image sizes and bibliographic data.

Metanorma CLI 1.10.2: HTML Navigation Enhancements and ISO Document Refinements

This release brings significant improvements to HTML navigation, introduces new number formatting capabilities, and includes several format-specific enhancements for ISO, IEEE, and IHO document types.

Metanorma CLI 1.10.1: Mathematical Enhancements and Collection Processing Improvements

This release enhances mathematical number formatting, refines document attachments, and improves the robustness of collection processing with particular focus on section-split documents and file linking.

Metanorma CLI 1.10.0: Enhanced Navigation and Attachment Features

This milestone 1.10.0 release introduces interactive clause navigation, file attachment capabilities, more streamlined error handling, and key improvements for specialized document formats.

Metanorma CLI 1.9.8: Improved Document Interlinking and Enhanced ISO Features

This release enhances document interlinking capabilities with hover-over highlighting for clause headings, attachment support, and several targeted improvements for ISO, NIST, OGC, and ITU document formats.

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.

Metanorma CLI 1.9.7: Enhanced Document Structure Flexibility and Collection Improvements

This release introduces improvements to document structure flexibility with support for unnumbered clauses, enhanced Word output customization, better error handling, and specialized collection features to streamline the standards authoring experience.

Metanorma CLI 1.9.6: Enhanced Document Collections, Mathematical Processing, and Format-Specific Improvements

This release brings significant enhancements to document collections in Word, improved mathematical formula processing, more efficient cross-referencing, and several flavor-specific improvements for ISO, IETF, and document collections.

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."