Generate ToC subsections from markdown sections

[idomingu]

Would be nice to generate new subsections from the sections specified in markdown text. These new subsections would be included in the Table of Contents at the beginning.

For example, in the following:

<https://example.org> rdf:type owl:Ontology ;
                      dcterms:description """

Here starts the Description section (should appear as section 3 in the ToC).

### Examples

Here starts the Examples subsection (should appear as section 3.1 in the ToC).
"""@en.

I have tested this issuing the following command java -jar widoco.jar -ontFile ontology/ontology.ttl -outFolder $dir -webVowl -uniteSections -oops -rewriteAll -getOntologyMetadata. The Examples subsection is rendered in the final HTML (without numbering), though the ToC is not updated.

Widoco release 1.4.24.

Thanks!

[dgarijo]

In theory it should work. have you tried to add the headers in html? (e.g., <h2> Examples </h2>).

The only thing I can think of is that the rendering library in markdown takes more time than the script used to create the table.

[idomingu]

I'm afraid it did not work. I got the same result as if using markdown headers (i.e., ### results into <h3>).

Another thing I noticed is that < > characters must be escaped in the markdown text. Otherwise, they are considered as HTML labels and end up removed. In the previous example I had to do the following:

<https://example.org> rdf:type owl:Ontology ;
                      dcterms:description """

Here starts the Description section (should appear as section 3 in the ToC).

<h3> Examples </h3>

Here starts the Examples subsection (should appear as section 3.1 in the ToC).
"""@en.

Thanks!

[dgarijo]

Try <h3 id="examples" class="list">

[idomingu]

Worked like a charm! Thanks!

[dgarijo]

I will leave the issue open until this is documented. The reason why the markdown does not work is that it does not know the class. Not sure if there is an easy fix. Alternatively I can document it and provide the solution above