From 5c5e28294f2f9c5f733294f37e7eb4af8822f3cc Mon Sep 17 00:00:00 2001
From: Pekka Paalanen <pekka.paalanen@collabora.com>
Date: Fri, 16 Jan 2026 14:16:57 +0200
Subject: [PATCH] doc: change HTML file names

Previously the HTML files generated from the DocBook sources were named
ch01.html, ch02.html, apa.html, apb.html, etc. with running numbering.
This means that if one added a new chapter between existing chapters,
the following chapter file names would change and break all web links
pointing to them.

Instead, let's use the chapter ID as the file name. This way, web links
will not be broken when new chapters are added.

Of course, this change breaks all web links to everything but index.html
(and pr01.html and pr02.html).

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
---
 doc/publican/xsl/docbook-config.xsl | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/publican/xsl/docbook-config.xsl b/doc/publican/xsl/docbook-config.xsl
index 2e176b89..6c93d204 100644
--- a/doc/publican/xsl/docbook-config.xsl
+++ b/doc/publican/xsl/docbook-config.xsl
@@ -7,5 +7,6 @@
   <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="use.id.as.filename">1</xsl:param>
   <xsl:param name="html.stylesheet">css/default.css</xsl:param>
 </xsl:stylesheet>