On Sun, 3 Jan 2021, Don Siders via lazarus wrote:
> I would rather see sectioning added to the FPDoc tags/content model:
>
> <topic>
> <section>
> <title>Using the Control</title>
> <p>Lorem ipsum sic dolor amet.</p>
> </section>
> </topic>
And what would this do in terms ouf output ?
In general, it would make FPDoc more usable for non-reference type
material. Grouping related content. If <section> has a name, it could
provide another level of navigation in the TOC. It provides a standard
way to tag a Formal Para, instead of emulating it it with:
<p>
<b>Using the Control</b>
</p>
<p>
Lorem ipsum sic dolor amet.
</p>
In specific, <section> could render like the HTML equivalent (as a
biock). <title> renders like the HTML H4 tag. The rest of the content
model renders just like the current usage.
You do know that topics can be nested ?
I can add 'section', but it will be below the <descr> node, as IMO it makes no
sense to do this below the topic node because of the nesting.
Michael.
--
_______________________________________________
lazarus mailing list
lazarus@lists.lazarus-ide.org
https://lists.lazarus-ide.org/listinfo/lazarus