metanorma / metanorma-iso

Metanorma processor for ISO standards
BSD 2-Clause "Simplified" License
14 stars 5 forks source link

NISO STS import on ISO Fonto: cross-references in terminology and bibliography entries not working #868

Open ronaldtse opened 1 year ago

ronaldtse commented 1 year ago

As reported by SIS (sis.se). Have requested for more information.

This is probably due to ISO Fonto implementing terms and bibliographic items not as part of the document but in their own individual databases for linking with existing content.

ronaldtse commented 1 year ago

From @matsahlin:

The cross reference in terms I identified from Metanorma as: image001

But when I recreated what would been what Fonto expected I got this: image002

The cross references for the Bibliography I found from in Metanorma to be: image003

But after import to Fonto it looks like this: image

And when recreating the cross reference in Fonto I get this: image

ronaldtse commented 1 year ago

@Intelligent2013 not sure if there's something we can do but could you have a look? Thanks.

Intelligent2013 commented 1 year ago

Regarding the issue:

The cross reference in terms I identified from Metanorma as: image001

I've updated mnconvert to generate tbx:entailedTerm instead of named-content for terms within the Terms and definitions clause as noted in '9.3.6 Cross-references between terms in the Terms and definitions clause' in 'IEC/ISO Coding Guidelines':

<tbx:definition><tbx:entailedTerm target="term_3.1.1">entity (3.1.1)</tbx:entailedTerm> with substantial knowledge, experience and competency in the domain</tbx:definition>

But SIS expects the tag xref instead of tbx:entailedTerm:

But when I recreated what would been what Fonto expected I got this: image002

If we need to update mnconvert for support SIS practice, then I need the full XML SIS example to adapt Metanorma to STS XSLT conversion rules specially for SIS format.

Intelligent2013 commented 1 year ago

The cross references for the Bibliography issue fixed. Now it encodes as:

<xref rid="biblref_13" ref-type="bibr">ISO 19115-1:2014</xref>