From 41b8bc56dae8e1cb021c9e52d687951ea4cd765e Mon Sep 17 00:00:00 2001
From: Alexander Kriegisch <Alexander@Kriegisch.name>
Date: Sat, 6 Jan 2024 12:47:44 +0700
Subject: [PATCH] Docs: Create separate CSS files, do not embed into HTML

TODO: There still is one set of CSS files per subdirectory due to the
way the docs directories are organised. It would be better to have them
just once. But to achieve that, the ADOC-to-HTML conversion would have
to be changed, e.g. using one central directory for images and
reorganisation of the overall directory structure and build options.
See https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/729.

Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
---
 pom.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index d62e3b9bf..e8dd18e45 100644
--- a/pom.xml
+++ b/pom.xml
@@ -424,9 +424,18 @@
 					<configuration>
 						<attributes>
 							<source-highlighter>coderay</source-highlighter>
-							<!--<imagesdir>./images</imagesdir>-->
 							<toc>left</toc>
 							<icons>font</icons>
+							<!--
+								Create separate CSS files, rather than embedding CSS into each HTML file
+								TODO:
+									There still is one set of CSS files per subdirectory due to the way the docs directories are
+									organised. It would be better to have them just once. But to achieve that, the ADOC-to-HTML conversion
+									would have to be changed, e.g. using one central directory for images and reorganisation of the
+									overall directory structure and build options.
+									See https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/729.
+							-->
+							<linkcss>true</linkcss>
 						</attributes>
 					</configuration>
 					<dependencies>
-- 
2.39.5