Support unit statements for figures and tables

[Intelligent2013]

Source issues: metanorma/mnconvert#224, metanorma/mnconvert#228.

ISO and IEC documents may contain the text describing the units used in the tables and figures (unit statements).

From Guidelines for coding IEC and ISO standards in NISOSTS.pdf

• for figures (from 8.4 Unit statements in figures):

When a figure contains a unit statement such as “Dimensions in millimetres”, this is coded as as <p> with @content-type=”dimension”.

• for tables (from 6.6.5 General unit statements in tables)

When a table contains text describing the units used in the table it is captured as <p> with @content-type=”dimension” in <table-wrap-foot>.
For example:

is coded as (NISO STS XML):

</table>
<table-wrap-foot>
<p content-type="Dimension" specific-use="100">Mass fractions in per cent</p>
</table-wrap-foot>
</table-wrap>

Also, this feature is using in BSI documents. For instance, https://github.com/metanorma/mn-samples-bsi/blob/main/reference-docs/standards/bs-9999/BS%209999.pdf, page 90:

This needs to be supported by metanorma-standoc.

[ronaldtse]

This issue is also mentioned here: metanorma/metanorma-iso#754

[opoudjis]

We allow a type attribute on paragraphs:

[type="dimension"]
Blah blah

I'm not going to put in numerical values into attributes on an adhoc basis. We need a global solution for RDF microformatting of Metanorma documents, in line with Smart documents, and that is the only context I will insert numeric values with.

Does @type address your need?

[ronaldtse]

@opoudjis look at metanorma/metanorma-iso#754 please.

[opoudjis]

This is not a key, and in the first figure, it occurs alongside the key.

Instead, this is some sort of bizarre extraneous note to a table or figure, which is idiosyncratically rendered.

So, the solution to this is:

[NOTE,type=units]
Dimension in millimeters

I'll implement that.

[ronaldtse]

@opoudjis as @Intelligent2013 alluded to -- should we consider this not as a note but as a secondary caption?

[opoudjis]

... We haven't defined secondary captions, and that seems an unnecessary complication to the model.

[ronaldtse]

OK I'm happy with NOTE=units.

[opoudjis]

Stop requirement that notes at the end of a clause must not fold into a preceding block; it is bogus, and "keep-separate" attribute takes care of such notes if needed.

[opoudjis]

Units notes need to not be numbered.

[opoudjis]

Requires isodoc refactoring in main branch.

[opoudjis]

@Intelligent2013 Please confirm this is working for you. You should also pull metanorma-standoc, to ensure that notes at the end of a clause are processed correctly.

[Intelligent2013]

@opoudjis confirmed. But there is the issue with note numbering (see NOTE 2 at bottom):

Units notes need to not be numbered.

but non units notes should be numbered without units notes counter.

[ronaldtse]

This is back to @opoudjis : the first figure NOTE is now called "NOTE 2" due to presence of unit note.

[opoudjis]

Needing to fix the counting of notes when units and other skippable notes are present.

[opoudjis]

Should be fixed, please review.

[Intelligent2013]

Confirmed:

@opoudjis thank you!