From 8c9aedf36edf83322c9ac9bc95f6095a73a7bcb2 Mon Sep 17 00:00:00 2001
From: Pekka Paalanen <pekka.paalanen@collabora.com>
Date: Fri, 16 Jan 2026 13:40:39 +0200
Subject: [PATCH] doc: move docbook config to a file

I think it's nicer to have the configuration in a separate file, and not
clutter the Meson file. Yes, the XML syntax is inconvenient.

This patch does not change the generated output.

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
---
 doc/publican/meson.build            |  6 +-----
 doc/publican/xsl/docbook-config.xsl | 11 +++++++++++
 2 files changed, 12 insertions(+), 5 deletions(-)
 create mode 100644 doc/publican/xsl/docbook-config.xsl

diff --git a/doc/publican/meson.build b/doc/publican/meson.build
index 2edf7988..e6b5121f 100644
--- a/doc/publican/meson.build
+++ b/doc/publican/meson.build
@@ -96,11 +96,7 @@ custom_target(
 	'Wayland-docbook-html',
 	command: [
 		xmlto,
-		'--stringparam', 'chunker.output.encoding=UTF-8',
-		'--stringparam', 'chunk.section.depth=0',
-		'--stringparam', 'toc.section.depth=1',
-		'--stringparam', 'generate.consistent.ids=1',
-		'--stringparam', 'html.stylesheet=css/default.css',
+		'-m', files('xsl/docbook-config.xsl'),
 		'-o', '@OUTPUT@',
 		'html',
 		'@INPUT0@'
diff --git a/doc/publican/xsl/docbook-config.xsl b/doc/publican/xsl/docbook-config.xsl
new file mode 100644
index 00000000..2e176b89
--- /dev/null
+++ b/doc/publican/xsl/docbook-config.xsl
@@ -0,0 +1,11 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+<!-- See: https://docbook.sourceforge.net/release/xsl/current/doc/html/index.html -->
+
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+  <xsl:param name="chunker.output.encoding">UTF-8</xsl:param>
+  <xsl:param name="chunk.section.depth">0</xsl:param>
+  <xsl:param name="toc.section.depth">1</xsl:param>
+  <xsl:param name="generate.consistent.ids">1</xsl:param>
+  <xsl:param name="html.stylesheet">css/default.css</xsl:param>
+</xsl:stylesheet>