TOC headings seems to break section names?

[ronaldtse]

=> "INTRODUCTIONPrinciples and rules followed"

This is from https://github.com/glossarist/iev-document .

[ronaldtse]

@w00lf could you help take care of this? Thanks!

[opoudjis]

if you get to it before me, @w00lf, the simplification of headings for rendering in TOC is done in isodoc, lib/isodoc/function/utils.rb, header_strip(): presumably replacing <br/> with space.

[opoudjis]

... no, it is in the JS scripts.html; the code to build it statically is overridden.

[opoudjis]

This is from the comedy of errors of metanorma/isodoc#79. The request to move away from Javascript dates from TWO YEARS AGO, and the followup to feature-improve static TOC has been unactioned as metanorma/isodoc#113.

I will need to investigate what disabling static ToC will do.

[opoudjis]

So

• The cleanup of headings in Static ToC (Ruby) is much better than that in Dynamic ToC (JS), which is basically unimplemented; hence the run-ins we are seeing.
• I have no idea if we are meant to be moving away from Dynamic ToC or not, Create static ToC for Html output isodoc#79 is muddled and full of short term thinking.
• I have no idea if we are meant to use jQuery or not.
• I do know that replicating code to do the same thing in JS and Ruby is leading to confusion.
• I am going to shove in a cheap jQuery function to implement the highlighting requested in Improve ToC isodoc#113, and disable Dynamic ToC.

[ronaldtse]

We are meant to have a degradable Dynamic ToC. Ie. Even if there is no JS enabled the ToC still works, perhaps without highlighting.

[opoudjis]

There is no reason to implement the same functionality twice in this case. Urgent I speak to you.