Commit Graph

5 Commits

Author SHA1 Message Date
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
Thomas Lamprecht
450dc469d9 correctly render level 5 headings
E.g., render them as h6 for the HTML output.

Level 5 headings are the +++++ ones in the full page output, in the
per-chapter outputs they are level 4 and worked fine already.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2024-03-06 17:59:31 +01:00
Thomas Lamprecht
c7a25e7c93 update docbook config
sync over from /etc/asciidoc/docbook45.conf shipped by asciidoc.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-06-24 15:01:46 +02:00
Dietmar Maurer
1ff5e4e80e thumbnail: allow to reference all images inside /images subdir
Before, we was limited to /images/screenshots/
2018-08-16 10:13:16 +02:00
Dietmar Maurer
2522a62449 pve-docbook.conf: docbook backend with thumbnail support 2016-11-07 17:43:09 +01:00