metanorma / bipm-si-brochure

SI Brochure edition 9, semantic encoded version (WARNING: DRAFT)
3 stars 0 forks source link

Encoding indented editorial note #214

Closed manuelfuenmayor closed 1 year ago

manuelfuenmayor commented 1 year ago

In Brochure, as we might remember, there are two font families: Arial and normal text. Normal text is reserved for editorial notes, and Arial is applied to quoted content.

So, having this in mind, there is this case from original source:

issue-1-original

The paragraphs enclosed in brackets are editorial notes, shown is normal text.

The current markup encloses all the list in quotes:

____
...
*recommends*

[align=left]
. that the name "Système International d'Unités" be given to the system founded on the base units(((base unit(s)))) adopted by the 10th CGPM, viz.: +
[This is followed by the list of the six base units(((base unit(s)))) with their symbols, reproduced in Resolution 12 of the 11th CGPM (1960)].

. that the units listed in the table below be used, without excluding others which might be added later: +
[This is followed by the table of units reproduced in paragraph 4 of Resolution 12 of the 11th CGPM (1960)].
____

Therefore, it is shown in Arial font: issue-1-generated-1

But, in order to fulfill with the format of the text I could do this:

____
....

[align=left]
. that the name "Système International d'Unités" be given to the system founded on the base units(((base unit(s)))) adopted by the 10th CGPM, viz.:
____

[This is followed by the list of the six base units(((base unit(s)))) with their symbols, reproduced in Resolution 12 of the 11th CGPM (1960)].

____
[start=2]
. that the units listed in the table below be used, without excluding others which might be added later:
____

[This is followed by the table of units reproduced in paragraph 4 of Resolution 12 of the 11th CGPM (1960)].

which renders as: issue-1-generated-2

But note that the indentation is not respected.

Do you think I should use the latter markup?

ronaldtse commented 1 year ago

Ping @opoudjis .

opoudjis commented 1 year ago

Oh God.

Yes, you should do the latter markup. But how to indicate that the jump back to authorial text is still indented?

... In my opinion? Sacrifice the indent, the quotation boundaries = font shift is more important. Trying to do both the font (quoted status) and the indentation is going to get us into an unholy mess of formatting markup, which we don't currently support, and/or abuse of semantic markup. We are prioritising semantics in this document after all.

ronaldtse commented 1 year ago

Agree. Thanks guys!