From 83ba7008e412fdde59011a9976028a4ca52370a5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20M=C3=BCller?= <1005065+DeepDiver1975@users.noreply.github.com> Date: Tue, 16 Jun 2026 00:32:38 +0200 Subject: [PATCH] fix: correct broken xrefs in useful_pages (#1541) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The links in useful_pages.adoc carried a 'server:' component prefix without a version coordinate: xref:server:admin_manual:installation/installing_with_docker.adoc[...] Per Antora's resolution rules, a component-qualified xref without a version resolves against the latest non-prerelease version of that component. Since 'next' is flagged prerelease in antora.yml, in the multi-version production build these xrefs resolved against the current release rather than next. installing_with_docker.adoc was newly added/renamed in next (from installation/docker/index.adoc), so the target did not exist in the release version. Antora could not resolve it and emitted a self-anchor fallback, producing the broken link reported in the issue: useful_pages.html#server:admin_manual:installation/installing_with_docker.adoc useful_pages.adoc itself lives in the server component, so dropping the 'server:' prefix makes these same-component xrefs resolve against the current page's version (where every target exists). This matches how all other references to these pages are written across the repo. Note: the previous {latest-server-version}@server: form could not be restored because latest-server-version is defined unquoted in antora.yml and parses as a YAML object, rendering as [object Object]. Fixes #1541 Co-Authored-By: Claude Opus 4.8 Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com> --- modules/admin_manual/pages/useful_pages.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/modules/admin_manual/pages/useful_pages.adoc b/modules/admin_manual/pages/useful_pages.adoc index ee4f33289..d4758f427 100644 --- a/modules/admin_manual/pages/useful_pages.adoc +++ b/modules/admin_manual/pages/useful_pages.adoc @@ -11,7 +11,7 @@ Note that this section always points to the latest server version available. In case you need a different version, select your topic and manually switch to one of the available ones. -* xref:server:admin_manual:installation/installing_with_docker.adoc[Installation with Docker] -* xref:server:admin_manual:configuration/server/occ_command.adoc[OCC Commands] -* xref:server:admin_manual:configuration/server/caching_configuration.adoc#small-organization-single-server-setup[File Locking and Caching Configuration] -* xref:server:admin_manual:maintenance/upgrading/manual_upgrade.adoc[Manual Upgrade] +* xref:admin_manual:installation/installing_with_docker.adoc[Installation with Docker] +* xref:admin_manual:configuration/server/occ_command.adoc[OCC Commands] +* xref:admin_manual:configuration/server/caching_configuration.adoc#small-organization-single-server-setup[File Locking and Caching Configuration] +* xref:admin_manual:maintenance/upgrading/manual_upgrade.adoc[Manual Upgrade]