Metanorma updates

[opoudjis]

The Metanorma software stack is updated every two weeks. Updates consist of:

• A release of the gem metanorma-cli, https://github.com/metanorma/metanorma-cli/releases
• Release of all relevant updated gems that are tied to Metanorma, including the various Metanorma flavours specific to each supported SDO, and supporting gems. A list of all Metanorma and Relaton (bibliographic) repositories, including test documents and templates, can be found in https://github.com/metanorma/metanorma-release
• Update to the Metanorma docker image, https://github.com/metanorma/metanorma-docker, for those users using Docker instead of the command line to run Metanorma

Releases are kicked off on a Monday evening (Australian Eastern time 🇦🇺 ) , and can take a while to run to completion—especially as Metanorma is tested against a representative set of documents from all supported flavours as a precondition to release. There are also often issues in software dependencies which get in the way of testing successfully. For that reason, we will be posting to this thread only after each release propagates successfully through to metanorma-docker, to indicate to our users when the next release has successfully gone live.

We will include in this thread a summary of the updates made in the latest release. The release notes for each gem point to the GitHub issues that have motivated each update.

[opoudjis]

metanorma-cli version 1.9.6 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Dealing with Nokogiri update being more fussy about reading XML into other XML documents (affects SVG files)
  • Debugging handling of UnitsML formulas and of some mathematical formula rendering in Word
  • Significantly more efficient processing of numbers as mathematical expressions (which forces uniform number formatting for numbers entered as stem:[....])
  • More efficient generation of cross-references within documents, to deal with very large documents
  • Fixed inconsistent use of comma in cross-references to list entries (Clause 1, a); Clause 1, a) i) : comma in the latter was missing)
  • Debugged preprocessing of URL links in Literal blocks (to prevent character substitutions distorting the URLs)
• Document collections
  • Work leading up to generation of document collections in Word (multiple documents included in the one Word document)
  • Debugged hyperlinking between documents in a document collection
  • Debugged HTML index page for a document collection consisting of a single document, broken up into one HTML page per clause (sectionsplit)
  • Improved detection of document identifiers in a document collection, based on individual document metadata
• ISO
  • Corrected format for cross-referencing of annex subclauses to match preferred ISO style (Annex A, A.1.2, but Clause A.1)
  • Automatically infer the historical (pre-2014) PDF formatting to be applied to documents based on the copyright year attribute
  • Applied the ISO House style for localisation of numbers (identified by putting them in stem:[....])
  • Remove notifications of style violations for numbers being issued for every single number in a document
  • Stopped validating the language script used in documents (using Chinese no longer gives a warning)
• IETF
  • Use em-dash instead of en-dash after term modified
• IEEE
  • Debugged citation of miscellaneous bibliographic types (e.g. websites, theses): comma, not full stop, after title

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

metanorma-docker 1.9.6 has been released.

[opoudjis]

metanorma-cli version 1.9.7 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Allow unnumbered clauses in main section of document
  • Exclude automatically inserted Table of Contents heading in Word output, if no Table of Contents is supplied
  • Allow empty coverpage to be specified in Word output
• Document collections
  • Support Word output for document collections, putting multiple Metanorma documents into a single Word document
  • Support collection-specific cover pages
• JIS
  • Support Plateau documents

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

metanorma-docker 1.9.7 has been released.

[opoudjis]

metanorma-cli version 1.9.8 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Enable hover anchor links for section headings in HTML
  • Process lists, captions, notes as a single division of content in HTML, DOC output
• Document collections
  • Interleave individual documents with groupings of documents in collection manifests, instead of requiring subtrees of documents to all be the same depth
  • Include external URLs in collection manifest for file references, to redirect links to documents
  • Fix insertion of anchors for indirect anchors in collections, to work with unitary documents as well as section-split documents
• ISO
  • Include definition list title in the post-processing of table keys, so that "Key" title is rendered correctly
• NIST
  • Integrate pubid-nist gem, for uniform rendering of NIST identifiers in document metadata
• OGC
  • Label sourcecode and pseudocode as Listings in output
• Plateau
  • Create separate gem for MLIT-Plateau documents

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

metanorma-docker 1.9.8 has been released.

[opoudjis]

This fortnight's release of the Metanorma stack has been cancelled, as I am undertaking massive refactoring of collections processing. There will be a release in a fortnight, and I will be endeavouring to have that refactoring done by then.

[opoudjis]

metanorma-cli version 1.10.0 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Introduce hover-over highlighting and hyperlinks for clause headings in HTML output, so that links to particular clauses are easy to discover
  • Allow attachments to be specified for documents, and hyperlinks to attachments to be generated
• Compilation
  • Change --no-prefix, --no-install-fonts flags to --prefix, --install-fonts
  • Raise error flag on exit for illegal options
  • Temporarily remove namespace from Collection XML until external object mapper (Shale) enhanced to deal with namespaces better
• Requirements
  • If no anchor is specified for a requirement under Modspec, generate an anchor based on the requirement identifier
• Collections
  • Simplify and streamline collection manifest structure
  • Allow collection manifests to process files outside the current working directory
  • Allow nested collection manifest files
  • Provide external script hooks for collection manifest processing, to alter file identifiers, file locations, and manifest preprocessing
  • Use external object mapper (Shale) to process collection manifests as a class
  • Temporarily remove namespace from Collection XML until Shale enhanced to deal with namespaces better
• ISO
  • Do not display "Warning for WDs and CDs" for DIS, FDIS documents
• ITU
  • Support justification annex in ITU contributions
• OGC
  • Generate hover-over links for requirement headings as well as clause headings, to allow easy lookup of hyperlinks
• Plateau
  • Initial public release, all basic functionality now in place

The successful release of Metanorma on Docker will be announced separately.

[CAMOBAP]

Windows and Snap releases failed. Re-run in progress

[ronaldtse]

@CAMOBAP @maxirmx says that Tebako Windows is ready. I wonder if it makes sense speeding up migration of packed-mn. Just in case the fix for the current Windows release isn't easy.

[CAMOBAP]

Both Snap and chocolatey are released for now

But it's a good idea to migrate packed-mn to tebako from aibika just for a consistency reason.

Thanks for letting me know, I will do it in the scope of metanorma/packed-mn#228

[maxirmx]

@CAMOBAP let me test it first
Metanorma is really big and it may create some special issues.

[CAMOBAP]

metanorma-docker 1.10.0 has been released.

[opoudjis]

metanorma-cli version 1.10.1 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Use Plurimath number formatter, supporting scientific notation
  • Allow attachments to be specified for documents, and hyperlinks to attachments to be generated
• Collections
  • Debugging of SVG mapping to collection document destinations
  • Drop use of temp files for section-splitting in collections (one clause per HTML page)
  • Ensure Semantic XML is recompiled to update file links for section-splitting
• Plateau
  • Distinct clause labels for level 4-6 clauses

The successful release of Metanorma on Docker will be announced separately.

[CAMOBAP]

+

• The snap package is released https://snapcraft.io/metanorma
• The chocolatey package is released https://community.chocolatey.org/packages/metanorma/1.10.1
• The brew package is released metanorma/homebrew-metanorma@d97fce5

Docker release is blocked by metanorma/metanorma-docker#188 . Investigation in progress

[CAMOBAP]

• docker is released https://hub.docker.com/u/metanorma

[opoudjis]

This fortnight's release of the Metanorma stack will be postponed to the week of July 8, as I am going on holiday.

[opoudjis]

metanorma-cli version 1.10.2 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Fix HTML Table of Contents sidebar
  • Process number formatting configurations, introduce number:[] macro to support number formatting
  • Bug fix in naming of folder containing document attachments for output rendering
  • Change fontist option in compilation from no_install_fonts to install_fonts
  • Rationalise placement of predefined introductory text for Normative References and Terms and Definitions
  • Abort if empty table detected in markup
• ISO
  • Allow normative references as subclause of the main clause for 1980s document format, with correct placement of predefined introductory text
• IEEE
  • Consistent insertion of "Abstract:" heading in Word
• IHO
  • Process bibliography entered as subclause

The successful release of Metanorma on Docker will be announced separately.

[CAMOBAP]

• Docker: released hud.docker.com
• Chocolatey: https://community.chocolatey.org/packages/metanorma/1.10.2 - waiting for automated review
• Snap: https://github.com/metanorma/metanorma-snap/actions/runs/9851430058 - release in progress
• Brew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.10.2 - released

[CAMOBAP]

Snap is released https://snapcraft.io/metanorma

[opoudjis]

metanorma-cli version 1.10.3 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Debug number formatting, using significant digits, and rendering exponents in scientific notation correctly
  • Recognise cross-references in document abstracts
  • Improve processing of passthrough lines in document preprocessing
  • Set maximum permitted size for images when encoded as Data URIs (by default)
  • Capture Relaton error messages for fetching bibliographic data into the document error log
  • Allow Symbols and abbreviations as a title recognised automatically as a Symbols clause header
• Bibliography Rendering
  • Add URI to rendering of "misc" document type
  • Do not use italics or quotation marks to delimit titles in Japanese by default
  • Introduce internationalisation of document stages
• Internationalisation
  • Internationalise NO ID tag for missing document identifier in bibliography; provide Japanese for available from for ISO and inheriting flavours (including JIS)
  • Allow internationalisation of Metanorma flavours to annul any rendering of a term inherited from Metanorma
  • Do not convert line break to space within Chinese/Japanese/Korean paragraph text
  • Force smart quotes when quoted Latin text is next to Chinese/Japanese/Korean text without an intervening space
• Collections
  • Introduce bilingual text rendering as multiple columns (experimental)
• IEEE
  • Suppress NO ID for references missing a document identifier
  • Suppress ordinal identifiers in Normative References
  • Update Standards boilerplate text for 2024
• OGC
  • Use open source fonts
• IHO
  • Fix placement and numbering of References within the Overview clause
• JIS
  • Display table keys
  • Do not assume all definition lists in a table are table keys
  • Render subfigure and nested requirement cross-references correctly in Japanese
• Plateau
  • Insert Table of Contents after abstract
  • Add sources on paragraphs and lists
  • Indent all paragraphs in Japanese text
  • Unnumbered document history annex

The successful release of Metanorma on Docker will be announced separately.

[CAMOBAP]

• Docker - released - https://hub.docker.com/u/metanorma
• Chocolatey - pending automated review - https://community.chocolatey.org/packages/metanorma/1.10.3
• Snap - released - https://snapcraft.io/metanorma
• Brew - released - https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.10.3

[opoudjis]

metanorma-cli version 1.10.4 & 1.10.5 contain the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

ALERT: There is currently a problem with accessing the TeXGyreChorus font; as a result, Metanorma cannot process BIPM documents.

• General
  • Debugged handling of line-breaks in Metanorma (introduced in 1.10.3): carriage returns introduced by Asciidoc are normally treated as space in most scripts, but need to be stripped in Chinese/Japanese/Korean. The approach taken was not working for sourcecode embedded within examples; that has now been addressed. This has resulted in the hotfix of 1.10.5.
• Attachments
  • Debugged processing of document attachments, so that they can be processed when the document to be compiled is outside the working directory.
  • Debugged processing of document attachments, to exempt them from text substitution (which was occasionally distorting their Bin64 encoding).
  • Debugged processing of large document attachments, which were being truncated at 10 MB.
• Internationalisation
  • Improved stripping of carriage returns in Chinese/Japanese/Korean text, when followed by non-text or blank text in the next line.
  • Updated processing of multilingual metadata about publisher of document.
  • Internationalised Modspec requirements model for Japanese.
• IEEE
  • Cite documents other than standards in Normative References using Author-Date referencing.
• JIS
  • Support participant tables processing as prefatory metadata
  • Debugged rendering of investigative organisations and committees in document boilerplate
  • Treat JIS standards like ISO standards in bibliographic rendering: do not provide additional publisher details
• Plateau
  • Correct metadata about MLIT as publisher
  • Sort references in the ordering required by MLIT
  • Move revision history to front of document
  • Update the document identifier type from JIS to PLATEAU
  • Process commentaries, rendering them at the end of the document
  • Remove Word as an available output format
  • Do not label figures embedded inside other assets, such as tables
  • Adopt Modspec as default requirements model

The successful release of Metanorma on Docker will be announced separately.

[CAMOBAP]

• Docker is released https://hub.docker.com/layers/metanorma/metanorma/ubuntu-1.10.5/images/sha256-2f844149a4dd848548dcfa68d51f29a8a6d967c48ef49184f52c1804c65f08e8?context=explore
• Snap is released https://snapcraft.io/metanorma
• Chocolatey automation review in progress https://community.chocolatey.org/packages/metanorma/1.10.5

Other deliverables are on the way, to be updated...

[opoudjis]

metanorma-cli version 1.12.1 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Remove redundant title in index sections after Presentation XML refactor
  • Wrap Semantic XML sourcecode content in body element for easier processing
  • Abort and log if any duplicate element IDs emerge in Presentation XML
  • Ensure correct encoding of footnotes on document titles
• Compilation
  • Enable logging of errors during generation of presentation formats of Metanorma
  • Migrate from sassc gem to sassc-embedded gem as sassc gem is no longer maintained
  • Update sassc content of CSS stylesheets for HTML and DOC to current version of dart-scss language
• Requirements
  • More careful assignment of id attributes in generating component cells for Modspec Presentation XML, to prevent duplicate element IDs
• IETF
  • Ignore Legacy stream in RFC bibliographies
• ITU
  • Suppress warning on study group identifiers
• NIST
  • Update relaton-render processing of identifiers in light of Presentation XML refactor

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.1, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Span: https://snapcraft.io/metanorma, last updated 2024-12-24
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.12.1, update successful

[opoudjis]

metanorma-cli version 1.12.3 (hotfix on 1.12.2) contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Preserve Semantic XML elements of bibitem in Presentation XML
  • Presentation XML refactor
  • Process bibdata footnotes in Presentation XML
  • Treat name, title as Semantic XML elements, and therefore ensure they do not contain Presentation XML markup
  • Allow hiddenref% footnotes, to suppress display of footnote reference if already supplied in image
• Dependencies
  • Remove asciimath2unitsml dependency
  • Remove unicode2latex dependency
• Compilation
  • Make Metanorma able to configure output filename
  • Abort if designation markup is used in clause not recognised as a term clause
  • Output messages for fatal errors with a distinct header, so they can be identified more clearly
  • Bugfix: Check the writeability of PlantUML directory earlier on, for Ruby 3.4
  • Speed optimisations in processing of Presentation XML
• ISO
  • Add correct French translations for Draft
• IETF
  • Process cross-reference markup in sourcecode
• IEEE
  • Do not strip footnote autonumber content in Word figure, table titles
• ITU
  • Ensure proper encoding of title footnotes
• Plateau:
  • Changed formatting of tables in Presentation XML
  • Move examples, key, footnotes, notes inside table footer
  • Consistent use of colon per language in rendering of table keys

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.3, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Span: https://snapcraft.io/metanorma, last updated 2024-12-24
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.12.3, update successful

[opoudjis]

metanorma-cli version 1.12.4 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Presentation XML refactoring, comments
  • Allow table colour and background colour styling in input
  • Fix the relative position in HTML of SVG rendering
• Dependencies
  • Update to Nokogiri 1.18, Lutaml-Model 0.7
• Collections
  • Generate RXL (bibliographic metadata file) for collections
  • Specify output format overrides at different levels of collection manifest
  • Make output_folder in collections configuration file be relative to the file, not the command line working directory
• Compilation
  • Silence warnings on normalising anchors and overriding ordered list
  • Bug fix: Ensure metanorma-extension is counted as preface clause for detecting start of main body of document
  • More efficient calculation of destination for term clause boilerplate
• ISO
  • Allow cover-page and first-page variant internationalisations of stage name
• IETF
  • Add colon to definition terms if not provided in markup
• OGC
  • Fix bug repeating the collapsible code snippet button on table rows associated with line number in source code
• BIPM
  • Implement BIPM numbering of footnotes, and associated rules and distinctions

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.4, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Span: https://snapcraft.io/metanorma, last updated 2024-12-24
• Homebrew: update not successful

[opoudjis]

metanorma-cli version 1.12.5 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Presentation XML refactoring, ordered and unordered lists
  • Various speed optimisations
  • Debugging: MathML expressions containing only numbers in Presentation XML
  • Do not italicise numbers-only MathML expressions in Word
  • Skip making smart-quotes for normal text, when text is marked up as pass-format:straightquotes[]
• Compilation
  • Log unresolved ID cross-references introduced in Presentation XML
  • Debugging: prevent ID from duplicating between xref and fmt-xref in Presentation XML
  • Fix processing of comma, empty value, and space as values of CSV document attributes, and number-formatting options in particular
  • Do not insert bookmarks for a comment block outside of a block, where they would disrupt rendering
  • Abort if passthrough is specified for Metanorma XML, but XML given is not compliant
  • Expect legal Metanorma XML in all elements but stem and metanorma-extension: this removes the preemptive stripping of XML attributes in bibliographic XML
  • Do not treat stem as a source of linebreaks to be added to blocks containing paragraphs (such as notes and examples) in Metanorma block postprocessing: this gets rid of redundant spaces being added before stem expressions in notes and examples
  • Debugging: fix the detection of numbers-only expressions in stem, when those expressions span multiple lines
  • Miscellaneous bugs in site generate involving relative paths
• ISO
  • Do not display to console requirement wording errors

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

metanorma-cli version 1.12.6 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Made Executive Summary and Appendix to Annex clauses available throughout Metanorma
  • Allow table border CSS attribute in table style markup
• Requirements
  • Sort nested Modspec requirements
• Rendering
  • Remove '(all parts)' from citations, leaving it in place as a bibliographical qualifier for standards only in references
  • Fix rendering of conjoined cross-references for formulas and annexes
  • Fix linebreaking on MathML in HTML
  • Improved detection in Word output of the left/right/centre alignment of a node containing a MathML expression
  • Remove redundant insertion of space to replace carriage return, at the end of an inline element within a block
  • Strip space around rendering of number:[] macro
• Compilation
  • Do not flag error in generating Presentation XML if semx points to original-id instead of id
  • Track relation between Semantic XML modification and Presentation XML modification
  • Allow absolute pathname for :boilerplate-authority: file
  • Abort if document boilerplate file nominated in :boilerplate-authority: is missing
  • Process #mark# in Asciidoc markup as span[@class='fmt-hi']
  • Register and validate cross-reference ranges
  • Add :publisher_abbr: document attribute for user-supplied abbreviations of publishing organisations
• ISO
  • Alias ICC (International Color Consortium) as a flavour to ISO, and insert ICC boilerplate and publisher identification into ICC documents
  • Support requirement notes in tables
  • Suppress display list punctuation warnings from console
  • Use decimal comma for numbers by default
  • In Word DIS, use KeyTitle style for key titles, so that key titles are left-aligned
  • Do not log assets cross-referenced inside of a cross-reference range as missing any cross-reference in a document
• IETF
  • Remove distinct tag bcp14 from Metanorma XML
• IEEE
  • Add copyright notice to HTML output
• ITU
  • Add warning boilerplate for contributions
• OGC
  • Removed distinct tag submitters from Metanorma XML
  • Replace distinct <hi> markup tag with <span class=fmt-hi> in Metanorma XML
• IHO
  • Debug document history rendering of contributors
• BSI
  • Remove border-under-row attribute from Metanorma XML, replacing it with CSS style attribute in Semantic XML
  • Suppress warnings about list punctuation from console

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.6, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Span: https://snapcraft.io/metanorma, last updated 2024-12-24
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.12.6, update successful

[opoudjis]

A bug in the Windows version of the Ruby date library is blocking the current release. We will update you when this is resolved and the release goes ahead.

[opoudjis]

The issue is still not resolved, and does not look like it will resolve soon. I have therefore been obliged to yank metanorma-utils 1.11.* and isodoc 3.1.8, since the code update that the former has made requires the rest of metanorma to update successfully. All gems will be re-released when the Windows code disruption is resolved.

[opoudjis]

metanorma-cli version 1.12.7 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• XML Structure
  • Differentiate in Semantic XML user-supplied anchors for cross-references, @anchor, from content GUIDs based on content and path, @id. Preserve both in the document and use @anchor for error logs and for cross-references, instead of @id.
  • Preserve in Presentation XML the content GUID of a node as @semx-id, and populate @id as @anchor if present, or @semx-id if not: that preserves previous behaviour.
  • Rename the term source element from termsource to source.
• Internationalisation
  • Extend CJK matching to CJK Script Extensions (e.g. full-width punctuation). As a result, CJK full-width punctuation is now detected as CJK text for the purposes of processing input newlines around them.
• Rendering
  • Refactor the Presentation XML processing of non-term source, using fmt-source for its rendering, and differentiating it from term sources.
  • Delimit the autonumbered content in fmt-fn-label using span[@fmt-caption-label] so it can be readily identified, consistent with other instances of labels in Presentation XML.
  • By default, numbers within formulas are formatted the same as number:[] macros, if :number-presentation-formula: attribute is not supplied
• Compilation
  • Debug the identification and rewriting of cross-references in Presentation XML.
  • Move the sanitisation of the @anchor value to conform with xsd:IDREF format from Semantic to Presentation XML.
  • Debug the tracking of unique instances of deprecates.
• Collections
  • Filter out footnotes and reviews not in the current file in sectionsplit documents, and renumber the remaining instances of footnotes and reviews in each file.
• ISO
  • Speed up validation of cross-references to normative references and sections.
• ITU
  • Do not convert nested definition list to table

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

metanorma-cli version 1.12.8 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Add anchor:[] macro to provide anchor for an inline span
  • Add source-id:[] macro to link an inline span to an external model id
  • Add source_include:[] macro to signal that a file with source code is to be included in metanorma-extension in the Semantic XML, as external data
• XML Structure
  • Anchors have less disruptive sanitisation method: most Unicode characters in user-provided anchors are now preserved, rather than escaped into numeric codes
• Rendering
  • Debugged rendering of SVG in HTML, so that images fit automatically in the window
• Compilation
  • Fix the treatment of linebreaks in source Asciidoc
  • Allow multiple instances of metanorma-extension clauses in source Asciidoc, and conflate them in the generated Semantic XML
  • Allow SVG as an output format of PlantUML images
  • Move the PlantUML image directory to _plantuml_images, and do not use the :imagesdir: directory for generated images
  • Do not delete space incorrectly before inline markup
  • Disable sectids document option, which generates IDs for sections automatically based on the section title
• Collections
  • Add collection flavor into collection configuration bibdata if it is missing from there, in order to recognise YAML flavor-specific fields correctly
  • XML files are recompiled in collections by default
• ISO
  • Left-align the Word Code style, so that nested sourcecode snippets in Word are rendered correctly: Nested sourcecode within examples not rendering correctly in Word metanorma-iso#1256
  • Fix the validation test for Scope clause after Terms & Definitions
  • Support complementary titles
  • Do not impose style checks on sourcecode embedded inside other blocks

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.8, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.12.8, update successful
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.12.8, update successful

[opoudjis]

metanorma-cli version 1.12.9 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Introduced Metanorma "tastes", lightly customised versions of existing flavours. Currently supported: International Color Consortium, Express Language Foundation
• Rendering
  • Debug processing of VML in Word cover pages, making them render properly again
  • Add pdfstylesheet, pdfstylesheet-override document attributes, to pass custom PDF stylesheets
  • Capture co-publisher logos if nominated for document as :publisher_logo:, and make them available to HTML and DOC rendering
  • Debug attachment linking: make the attachment directory for expanding DataURI attachments be relative to the output directory, not the document source directory
  • Debug title added to newly generated index section in Presentation XML, to be fmt-title and not title
• Compilation
  • Add internal identifiers to all sections and blocks in documents
  • Ensure all new GUIDs assigned in Presentation XML are content GUIDs, and therefore stable so long as the content is stable
  • Revert @original-id back to @id if the @id has not been reused elsewhere in the Presentation XML
  • No longer inserting ZWNJ characters in processing :pass-format:[] macros to prevent character substitution.
  • Made pass:[] and pass-format:[] behave consistently, so that neither allow any character substitutions, including smartquotes
  • Strip space around pass-format:[] content
  • Generate (filename).asciidoc.log.txt file during processing, to provide the fully preprocessed Asciidoc content, including resolved includes, for debugging
  • Only create the attachments subdirectory in the output directory if DataURI attachments are being used, not if attachments are linked to the local file system
  • Do not resolve smartquotes twice in boilerplate content (once when parsing its Asciidoc content, once when processing the entire document)
  • In linebreak postprocessing, ensure < > are XML-safe when processing them in text
  • Allow internationalisation configuration documentation attribute :i18nyaml: to be an absolute filepath
• ISO
  • Do not generate spurious bibliography warning if no Bibliography present
  • Refine non-ISO/IEC normative reference warning: non-ISO/IEC reference is allowed as normative only subject to the conditions in ISO/IEC DIR 2
  • Remove empty title components
• NIST
  • Move reviewernote as idiosyncratic element to clause[@type = 'reviewernote']
• IHO
  • Allow copublisher icons on DOC, HTML cover pages
• BIPM
  • Move distinct doccontrol as idiosyncratic element to colophon/clause
  • Replace blacksquare as idiosyncratic element with Unicode dingbat
  • Mark up quoted variant titles as titles in Presentation XML, to preserve proper semx tracing of their source

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.9, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.12.9, update only as candidate
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.12.9, update successful

[opoudjis]

metanorma-cli version 1.12.10 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Overwrite details of old host volume with new, when specifying bibliographic attribute overrides through span:[] attributes
  • Validate for empty blocks
  • Use :version: in preference to :draft: for document version numbering
• Bibliography
  • Blacklist <title> tag from source Relaton records
  • Extract initials from forename tags in Relaton containing multiple forenames
  • Introduce filters to put only part of a Relaton field in upper case or a formatting tag (e.g. AUTHOR1 and AUTHOR2)
• Rendering
  • Fix scaling of SVG in HTML output
  • Use presentation-metadata-doctype-alias to provide override rendering of a doctype (for custom doctypes in Tastes)
  • Maintain all caps in capitalisation of status and similar tags in HTML/DOC metadata, and document boilerplate
  • Populate metadata for Presentation XML after internationalisation of bibdata: this makes doctype_display available in Presentation XML, and improves metadata in general in boilerplate and HTML/DOC cover material
  • Do now allow line breaks in rendering of identifier
  • Debug persisting of temporary file for PDF compilation
• Collections
  • Make docidentifier of collection have 'primary' attribute
• Compilation
  • Debug anchor processing, stripping colon as illegal character
• Tastes
  • Allow taste-specific doctypes, mapping to host flavour doctypes
• ISO
  • Remove "no-place" (n.p.) label from bibliographic rendering of books that are missing place of publication
  • Fix rendering of author initials in references, and capitalisation of author names
• IETF
  • Move anchor in Semantic XML to anchor in RFC XML output: debugs linking of eref and xref
• IEEE
  • Fix Word copyright footers for 2024 template
  • :version: takes over functionality of :draft: for version numbering
• ITU
  • Implement ISO/IEC/ITU Common Text doctype consistent with rest of Metanorma
• NIST
  • :version: takes over functionality of :draft: for version numbering
• OGC
  • Change name, Table of Recommendations, to "List of Normative Statements"

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.12.10, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.12.9, update only as candidate, 2025-06-10
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.12.10, update successful

[opoudjis]

metanorma-cli version 1.13.0 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Change XML name of review and dependent elements to annotation, and of existing annotation for sourcecode callouts to callout-annotation; make default type of review be annotation
• Rendering
  • Allow ordered lists with arbitrary starting number in Word output, and support ol/@start attribute in all flavours
  • Add css-style attribute for tables
  • Left-align the table-formatted definition list key in Word output
  • Table cell style attribute overrides Word table cell border styling
  • Realise conditional rendering of annotations, if either draft or directive, with SDO-specific draft criterion; allow flavour-specific overrides in code on individual annotations
  • Do not put a label on unnumbered uncaptioned assets
  • Support publisher logo size attributes
  • Remove empty fmt-* elements in Presentation XML
• Collections
  • Debug processing of pass:[ \] ] macro
  • Default value of image/@filename is image/@src: enables consistent extraction of images from documents, even if they have been encoded as DataURI
• Compilation
  • Use NCName safeguarding for identifier aliases of anchors, resolving inconsistency between Modspec requirements and rest of Metanorma
  • Add @mimetype to logo images in bibdata: allows consistent extraction of bibliographic metadata in site compilation
  • Update treatment of lang:[] macro
• Tastes
  • Add support for logos
  • Add Enosema taste
• IEEE
  • Restore where to formulas
  • :version: joins :draft: as fallback indicating draft status of document
  • Fix rendering of formatted sourcecode in Word output, to deal with converting inside formatting spans to paragraphs
• IHO
  • Annex, Apppendix, Supplement, Part titles and ids
• JIS
  • Remodel handling of tables to follow the Plateau implementation, with Presentation XML instead of HTML being adjusted
• BIPM
• Labelling of appendix and annex through level2_ancillary and level3_ancillary values in i18n config follows document-scheme attribute
• Add level4_ancillary and level5_ancillary attributes to i18n config, move internationalisation of annex ID to Presentation XML

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.13.0, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.13.0, update only as candidate, 2025-07-07
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.13.0, update successful

[opoudjis]

metanorma-cli version 1.13.1 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Support plain tables, which do not have the border or shading imposed by SDO style rules
  • Allow multiple instances of description for each entry in document history (renders currently in OGC, IHO, BSI)
• Collections
  • Add document_suffix if present to content GUIDs generated in Presentation XML: guarantees that content GUIDs specific to Presentation XML are unambiguous within collections
• Compilation
  • Defensive coding on bibliographic spans processing
• ISO
  • Remove redundant period after editors in bibliography rendering
  • Added validation checks new to 2025 ISO house style
• Generic
  • Expose bibdata Lutaml Hash to Liquid in docidentifier generation: allows bibliographic metadata fields to be used directly in configurable template for generating document identifiers
• IEEE
  • Put copyright footer on all pages of Word output but the first
• IHO
  • Prevent duplication of document history description anchors in Presentation XML

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.13.1, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.13.0, update not successful
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.13.0, update not successful

[opoudjis]

metanorma-cli version 1.13.3 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • By default, all flavours assume that a document is of published status, if no status is given explicitly
  • Fix the processing of number:[] macros so that they are not mangled when joined to another macro, such as footnotes.
  • Recognise TODO: and EDITOR: paragraphs inside other blocks
  • Respect XML escapes in presentation/semantic-metadata document attributes
• Collections
  • Enforce relative path from config file for cover page configuration
  • Update review to annotation in sectionsplit processing
• Rendering
  • Encode copublisher logos as DataURI in HTML, for greater flexibility in rendering
• Bibliography
  • Make parsing of nested directives in bibliographic code more flexible in ordering
  • Amend a fetched reference with bibliographic span annotations, only if the bibliographic code is wrapped in amend().
  • If the amend() wrapper is absent, the bibliographic span annotations replace the fetched bibliographic record
• Tastes
  • Added HTML styling for ICC
  • Updated copyright text for ICC
  • Make unordered list bullets configurable in document metadata
  • Override the published status of a document through document metadata
• ISO
  • Record agency for each ISO workgroup, allowing external agencies
  • Improve representation of workgroups, allowing for multiple workgroups
  • Update internationalisation of Russian, French, German for draft comments
  • Allow internationalisation of the role description of contributors
• IETF
  • Streamline abstract contents for compliance with RFC XML. This includes removing xref from abstracts
  • front/date, as a required element in RFC XML, is populated with today's date if no publication date given
  • Do not use the deprecated format element in RFC XML
• BSI
  • Optimise list cleanup and validation
• BIPM
  • Reduce the size of the black square dingbat for quoted titles in the SI Brochure
  • Language-independent part-subpart and appendix-annex numbering in docidentifier

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.13.3, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.13.2, latest update not successful
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.13.2, update not successful

[opoudjis]

metanorma-cli version 1.13.4 contains the following changes; more details can be found in the individual gem release pages. PDF rendering updates are not tracked separately.

• General
  • Fix paths of pdfstylesheet and pdfstylesheet_override attributes, to be relative to the main document instead of the working directory
  • Move the indication of published stage status to Semantic XML from Presentation XML, as semantic-metadata/stage-published
  • Encode committees in bibdata/contributor instead of bibdata/ext/editorialcommittee and bibdata/ext/advisorycommittee
  • Do not close preface and open main section, based on a level 2+ section heading
  • Allow termnote/@type
• Rendering
  • XXX
• Bibliography
  • Allow parentheses within the rendered identifier markup for bibliography ([[[anchor,(rendered identifier)bibliographic code]]]
• Compilation
  • Remove unlimited regex that was causing delays in Ruby 3.1
  • Register LutamlEnumTableBlockMacro
• Generic
  • Configure attribute committee_types for recognised committee attributes
• IEEE
  • Add document attribute for IEEE SASB approved date
  • Update IEEE reference availability footnotes
  • Remove Emeritus Sign footnote if no participants have an asterisk
  • HTML rendering of officeholders
  • Enforce final 3 column section for Word participants clause, through added section break
  • Add license termnotes
  • Retain em-dash in Word table and figure captions
  • Do not double-render footnote on docidentifier as text within biblio-tag
• ITU
  • /bibdata/ext/studyperiod encoded outside of study group representation

The successful release of Metanorma on Docker will be announced separately.

[opoudjis]

• Docker: https://github.com/metanorma/metanorma-docker/releases/tag/v1.13.4, update successful
• Chocolatey: https://community.chocolatey.org/packages/metanorma, last updated v1.11.5, 2025-01-25
• Snap: https://snapcraft.io/metanorma, v1.13.4, update successful
• Homebrew: https://github.com/metanorma/homebrew-metanorma/releases/tag/v1.13.2, update not successful