openSUSE / suse-xsl

DocBook XSL Stylesheets for SUSE branding
Other
11 stars 10 forks source link

`xref` renders as plain text #443

Closed KucharczykL closed 2 years ago

KucharczykL commented 2 years ago

Problem Description

The code below renders as plain text instead of a link:

<xref linkend="jsc-SLE-16552"/>

(Source at https://gitlab.suse.de/documentation/release-notes-sles/-/blob/15_SP1/xml/release-notes.xml#L3841)

image

This only happens locally on my Tumbleweed installation:

Name : suse-xsl-stylesheets Version : 2.99.20211129-26.1

Expected Behaviour

The code is rendered as link, as can be seen here: https://www.suse.com/releasenotes/x86_64/SUSE-SLES/15-SP1/index.html#jsc-SLE-16552-1

ghost commented 2 years ago

This issue occurs because the new stylesheets no longer support DocBook 4's @id, and instead look for DocBook 5's @xml:id attributes only. This is an intended change that has simplified code in quite a few places already. As such, I think this is a wontfix.

(cc @tomschr @fsundermeyer )