pve-docs/asciidoc
Thomas Lamprecht c2eab5cc87 docbook: render 4th section level for manpages
In the manpage output the sections get rendered as refsections, but
those only go up to level 3:

> In DocBook, RefSect3 is the lowest-level section allowed in a
> RefEntry. There is no element analogous to a Sect4.
-- https://tdg.docbook.org/tdg/4.5/refsect3

While nesting refsect3 would work output wise, the DTD schema does not
allows this, and disabling schema validation can lead to graver
issues, so rather avoid that and use a formalpara [0], a paragraph
with a title, instead, but only for the title, as the inner content
will be a simpara (simple paragraph) that cannot be nested inside a
formalpara, but the resulting rendering works out well enough.

[0]: https://tdg.docbook.org/tdg/4.5/formalpara

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2024-03-06 18:09:56 +01:00
..
asciidoc-pve.conf asciidoc config: work around missing icon bug 2023-05-18 15:46:14 +02:00
dblatex-custom.sty dblatex: update custom style with upstream changes 2024-03-06 17:59:31 +01:00
dblatex-export.conf use rsvg-convert instead of inkscape 2017-06-29 12:15:07 +02:00
mediawiki.conf correctly render level 5 headings 2024-03-06 17:59:31 +01:00
pve-dblatex.xsl pve-dblatex.xsl: use latex \paragraph for formalpara 2016-11-05 18:41:59 +01:00
pve-docbook.conf docbook: render 4th section level for manpages 2024-03-06 18:09:56 +01:00
pve-docs.css css: fine-tune h4, h5, h6 headings font-sizes 2024-03-06 17:59:31 +01:00
pve-html.conf correctly render level 5 headings 2024-03-06 17:59:31 +01:00