From 42d914f20cb09a3141e025eda92af33352c91150 Mon Sep 17 00:00:00 2001 From: Stefan Klug Date: Mon, 8 Sep 2025 16:07:45 +0200 Subject: [PATCH] Documentation: Enable doxygen-awesome-css MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Include doxygen-awesome-css in the doxygen config. The project's documentation indicated that the HTML_COLORSTYLE option needs to be set to LIGHT starting with Doxygen 1.9.5. The reason isn't explained, and tests have not shown any noticeable difference with Doxygen 1.9.5, 1.13.2 and 1.14.0. Unlike Doxygen itself that generates different CSS files depending on the HTML color style, doxygen-awesome-css use the same CSS that defaults to auto-light, and relies on adding "light-mode" to the class of the element manually to disable dark mode. As we don't do this, doxygen-awesome-css effectively operates in auto-light mode. Given that setting HTML_COLORSTYLE to LIGHT makes no visible difference, leave the option unset to default to auto-light mode that matches the actual behaviour. Signed-off-by: Stefan Klug Signed-off-by: Laurent Pinchart Reviewed-by: Stefan Klug Reviewed-by: Barnabás Pőcze --- Documentation/Doxyfile-common.in | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/Doxyfile-common.in b/Documentation/Doxyfile-common.in index c9527da0..23a0e362 100644 --- a/Documentation/Doxyfile-common.in +++ b/Documentation/Doxyfile-common.in @@ -54,6 +54,9 @@ EXCLUDE_SYMBOLS = libcamera::BoundMethodArgs \ IMAGE_PATH = "@TOP_SRCDIR@/Documentation/images" +HTML_EXTRA_STYLESHEET = "@TOP_SRCDIR@/Documentation/doxygen-awesome-css/doxygen-awesome.css" \ + "@TOP_SRCDIR@/Documentation/doxygen-awesome-css/doxygen-awesome-sidebar-only.css" + GENERATE_LATEX = NO MACRO_EXPANSION = YES