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
Thomas Lamprecht
ba6ea59562
asciidoc config: work around missing icon bug
...
The inline icons for admotions (note, tip, warning, ...) are missing
on builts with the asciidoc package shipped by Debian Bookworm.
As workaround set the "iconsdir" attribute manually to
"/usr/share/asciidoc/icons", as recommend by the DM in the respective
Debian bug report [0].
[0]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1036030#10
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-05-18 15:46:14 +02: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
067d9c3dba
attrs: update cephdocs template to quincy
...
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-01-16 14:55:04 +01:00
Lukas Wagner
e86a387380
asciidoc: fix capitalization of GmbH
...
Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>
2022-11-09 14:50:25 +01:00
Aaron Lauterer
208543355b
update Ceph codename and docs url to octopus
...
Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-01-28 12:14:38 +01:00
Thomas Lamprecht
d2a0a9cc74
mediawiki: load JS helper in plugin instead of including it in the html out
...
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2021-05-28 16:03:59 +02:00
Thomas Lamprecht
4622d5b4c5
mediawiki toc: adapt to version 1.35
...
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2021-05-28 14:19:09 +02:00
Thomas Lamprecht
706103708c
mediawiki toc: code cleanup
...
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2021-05-28 14:18:30 +02: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
Dylan Whyte
65799de02c
change 'Gmbh' to 'GmbH'
...
Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
2021-03-16 19:22:40 +01:00
Alwin Antreich
b46a49edb1
update links to the ceph docs
...
* use a variable instead of hardcoded url+release name
* ceph migrated to readthedocs with a minor uri change
https://lists.ceph.io/hyperkitty/list/ceph-users@ceph.io/thread/AQZJG75IST7HFDW7OB5MNCITQOVAAUR4/
Signed-off-by: Alwin Antreich <a.antreich@proxmox.com>
2020-10-14 12:28:23 +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
Alwin Antreich
2798d126f3
pveceph: add attribute ceph_codename
...
To change the codename for Ceph in one place, the patch adds the
asciidoc attribute 'ceph_codename'. Replaces the outdated references to
luminous and the http -> https on the links in pveceph.adoc.
Signed-off-by: Alwin Antreich <a.antreich@proxmox.com>
2019-11-06 19:27:23 +01:00
Thomas Lamprecht
747e99ba33
Revert "set email to office@proxmox.com"
...
This reverts commit b1a2cc40b7
Reqeuested, again, by Martin as it's out there for such purposes for
>15 years, so we just keep it.
2019-05-31 13:12:47 +02:00
Thomas Lamprecht
b1a2cc40b7
set email to office@proxmox.com
...
Requested by Martin as the support@ address is now quite wired to the
enterprise support ticket system, and office is for more general
requests.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-05-28 15:29:48 +02:00
Dominik Csapak
91ef956f9f
use https for the website
...
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2018-09-13 09:16:13 +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
Thomas Lamprecht
789c5c57d3
use rsvg-convert instead of inkscape
...
we save quite a few build (reverse-)dependencies with this change
rsvg-convert is also a lot faster.
both use the same backend to process SVGs – cairo
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2017-06-29 12:15:07 +02:00
Dietmar Maurer
b9ff41f19f
add ceph macro
2017-06-21 08:32:39 +02:00
Dietmar Maurer
df0649a4ba
mediawiki.conf: remove useles }
2016-11-08 10:26:36 +01: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
Dietmar Maurer
2522a62449
pve-docbook.conf: docbook backend with thumbnail support
2016-11-07 17:43:09 +01:00
Dietmar Maurer
8c8ae22460
mediawiki.conf: implement thumbnail attribute
...
And install screenshot files
2016-11-07 17:43:09 +01:00
Dietmar Maurer
d2e80213b5
rename dasciidoc/asciidoc.js -> asciidoc/mediawiki-asciidoc.js
2016-11-07 16:47:00 +01:00
Dietmar Maurer
de7022fbe9
asciidoc-pve.conf: use extra asciidoc configuration file
...
We can define PVE related attributes here (will replace attributes.txt).
Install all asciidoc-pve config files to /usr/share/pve-doc-generator/asciidoc
2016-11-07 08:19:04 +01:00
Dietmar Maurer
73799de4d0
dblatex-custom.sty: fix spacing in descriptionlabel
2016-11-05 18:43:21 +01:00
Dietmar Maurer
9909dc0dd5
pve-dblatex.xsl: use latex \paragraph for formalpara
2016-11-05 18:41:59 +01:00
Dietmar Maurer
37ea112ef9
pve-dblatex.xsl: define all dblatec settings inside this file
...
And overwrite formalpara template, adding newline after title.
2016-11-05 12:13:42 +01:00
Dietmar Maurer
12c4696e3f
use parbox for description labels to allow line breaks
2016-11-05 11:55:25 +01:00
Dietmar Maurer
9dbe49ebe4
mediawiki.conf: improve horizontal list rendering
2016-10-31 11:54:00 +01:00
Dietmar Maurer
119de29835
asciidoc.js: use mediawiki mw.hook
...
To trigger toc generation more reliable.
2016-10-26 17:16:49 +02:00
Dietmar Maurer
24bec5055d
asciidoc.js: use mediawiki resource loader queue
...
Because jQuery is not available when we load the script.
2016-10-22 14:50:00 +02:00
Dietmar Maurer
a7d40e1f89
asciidoc.js: use jQuery instead of $
2016-10-22 12:49:00 +02:00
Dietmar Maurer
7cbfd9192e
add simple toc generator for wiki pages
2016-10-22 12:24:39 +02:00
Dietmar Maurer
110ebe8fe1
add code to generate correct footnotes on wiki pages
2016-10-22 10:57:06 +02:00
Dietmar Maurer
52cac052f9
do not use the <code> tag
...
Because it has unwanted side effect in newer mediawiki CSS (box around text).
2016-10-21 08:56:45 +02:00
Dietmar Maurer
77d64ef718
mediawiki.conf: use <tt> tag for monospace font
2016-10-19 09:53:38 +02:00
Dietmar Maurer
344921dff6
mediawiki.conf: use <tt> tag for monospace font
2016-10-19 09:22:45 +02:00
Dietmar Maurer
f70eb3a839
mediawiki.conf: fix table rendering (use class wikitable)
2016-10-19 08:37:11 +02:00
Dietmar Maurer
09fa9913f4
mediawiki.conf: simplify footnote rendering (remove <br> tags)
2016-10-19 08:28:43 +02:00
Dietmar Maurer
d77aa8bcf0
mediawiki.conf: add more descriptive comment
2016-10-19 08:25:33 +02:00
Dietmar Maurer
636ea67ba5
mediawiki.conf: use h5 for paragraph titles
2016-10-19 08:09:25 +02:00
Dietmar Maurer
404a1dc149
mediawiki.conf: remove gheader/footer content
...
simply not required for wiki.
2016-10-19 08:08:00 +02:00