From 8b60342f76a744e61c16ea683b44996dd462bfda Mon Sep 17 00:00:00 2001 From: Peter Krempa Date: Tue, 12 Apr 2022 13:00:45 +0200 Subject: [PATCH] docs: Adapt to semantic tag usage of docutils-0.17 and later MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Docutils-0.17 switched to using
instead of a
and
instead of
. To ensure that our pages still work we need to slightly adapt our XSL stylesheet to select the
tag properly and adapt the CSS to also select the 'section' element instead of a class and to apply to a
tag with the appropriate names. Docutils-0.17 also changed to use 'h2' for section heading instead of 'h1'. Note the styles applied to the 'main' element with certain id can't be made more universal by just applying to the id itself, as in certain cases (e.g. 'documentation') we also have sections with that name. This was previously ensured by also matching the 'document' class which would make it equal to the 'main' element. Signed-off-by: Peter Krempa Reviewed-by: Ján Tomko Reviewed-by: Michal Privoznik Reviewed-by: Martin Kletzander Reviewed-by: Jiri Denemark --- docs/css/libvirt.css | 9 +++++++++ docs/page.xsl | 6 ++++++ 2 files changed, 15 insertions(+) diff --git a/docs/css/libvirt.css b/docs/css/libvirt.css index 2b2208f56e..097dfcbe8e 100644 --- a/docs/css/libvirt.css +++ b/docs/css/libvirt.css @@ -95,6 +95,7 @@ margin-right: 1em; } +main, .document { margin-left: auto; margin-right: auto; @@ -104,9 +105,13 @@ width: 70em; } +main#index, #index.document, +main#hvsupport, #hvsupport.document, +main#documentation, #documentation.document, +main#knowledge-base, #knowledge-base.document { width: inherit; @@ -397,7 +402,9 @@ h6:hover > a.headerlink { } div.panel, +#documentation section, #documentation .section, +#knowledge-base section, #knowledge-base .section { width: 24%; @@ -407,7 +414,9 @@ div.panel, } div.panel h2, +#documentation section h2, #documentation .section h1, +#knowledge-base section h2, #knowledge-base .section h1 { margin-top: 0px; padding: 0.5em; diff --git a/docs/page.xsl b/docs/page.xsl index a6a270896c..7d0203cf62 100644 --- a/docs/page.xsl +++ b/docs/page.xsl @@ -120,9 +120,15 @@
+ + + + + +
-- 2.39.5