search

metanorma / firelight

IN DEVELOPMENT: HTML frontend for Metanorma documents
1 stars 0 forks source link

Metanorma XML for PLATEAU #8

Closed strogonoff closed 2 months ago

strogonoff commented 2 months ago

Is it possible to have a sample?

opoudjis commented 2 months ago

https://github.com/metanorma/mn-samples-plateau/

Compile that, following the instructions in the README.

Currently apparently this Firelight thing is set up to read Semantic XML (*.xml). That was a stupid design decision, taken by people who did not talk to me and did not know what they were doing. It should be consuming Presentation XML (*.presentation.xml), which resolves numbering, does i18n, orders clauses, resolves passthrough blocks, and any number of other things. The entire reason Presentation XML exists is so that Alex D and I did not have to redo this work independently: any attempt by Firelight to redo the same work from scratch needs to be kerb-stomped.

As it turns out, the Presentation XML embeds the Semantic XML at the beginning anyway (semantic_ prefixed to all elements and anchors with equivalents in the Presentation XML.)

There is an action coming up on me to create and document the Presentation XML schema, so you know what its value-add is.

strogonoff commented 2 months ago

In my process issues are usually closed by the callers when truly resolved (i.e., I need XML => You help me obtain it => I close the issue when it’s all good), but as long as this is under MN org I guess when in Rome…

ronaldtse commented 2 months ago

I agree with @strogonoff . Issues should only be closed when resolved. But I know @opoudjis uses a different understanding of “resolved” for colleagues vs clients 🤣