Commit Graph

13 Commits

Author SHA1 Message Date
Christoph Heiss
ecab5895a4 asciidoc: add clickable anchor link to all headings
Works the same as in our PBS documentation and is generally common for
documentations.

Very useful for linking specific sections of the documentation in other
places. Previously, this always had to be done by getting the correct
anchor from the HTML directly via e.g. browser devtools.

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
Tested-by: Max Carrara <m.carrara@proxmox.com>
2024-06-18 10:27:49 +02: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
Stefan Sterz
864c4d12af conf: add support for a dark mode in the documentation
this commit adds support for a dark theme that behaves similarly to
that one used by the api viewer.

Signed-off-by: Stefan Sterz <s.sterz@proxmox.com>
2023-03-17 09:02:46 +01:00
Thomas Lamprecht
cf7a2acc30 asciidoc: minimally update derived docbook conf templates to work with python 3
there are a few more changes to last stable upstream asciidoc 9.1.0
release, but for now port only those over which are absolutely
necessary.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2021-05-13 19:18:04 +02:00
Thomas Lamprecht
6451ecbdaa html TOC: add "back to index" link
use a unicode symbol for the back arrow, should nowadays be widely
available

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-05-06 15:16:17 +02:00
Thomas Lamprecht
cc38b9254c html: avoid horizontal overflows, break-word and limit image width
break-work affects very long lines on all widths, as pre/monospaced
elements are limited in their available width. This is only a
rendering word break, i.e., if one copies the data they will get the
original "unbroken" one.

The "max-width=100%" enforces only better visuals where space is
limited anyway.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-29 16:27:51 +01:00
Thomas Lamprecht
396e1d03f2 html: use new table-of-contents (toc2) also for individual chapters
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-28 18:19:47 +01:00
Thomas Lamprecht
ea17ced93d style new TOC, sans font headings, less noise for links
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-24 13:46:06 +01:00
Thomas Lamprecht
237d09b998 html: slightly wider TOC for readability
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-22 17:04:17 +01: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
b179764dcb fix thumbnail padding 2016-11-08 09:21:09 +01:00
Dietmar Maurer
aa56b7e0f6 allow float attribute for screenshots 2016-11-08 08:38:52 +01:00
Dietmar Maurer
ae0ad291e1 pve-html.conf: html5 backend with thumbnail support 2016-11-07 18:17:44 +01:00