You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
However, this was done in a backward-incompatible way. So now, in your customization layer or build system, you have to pick one of these URLs, and users who have a different docbook-xsl version installed locally will suffer, either because the stylesheets have to be fetched from a remote server, or the build will fail entirely.
This didn't use to be a real problem in practice because 1.79.2 saw very little adoption, but it's now trickling into various distributions and packagings, and it's becoming a real source of frequent build problems.
This should be fixed by making the supplied catalog files include backward-compatible mappings. For example, the currently built catalog file
<?xml version="1.0" encoding="utf-8"?>
<catalogxmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
<!-- XML Catalog file for DocBook XSL Stylesheets vsnapshot -->
<rewriteURIuriStartString="https://cdn.docbook.org/release/xsl/current/"rewritePrefix="./"/>
<rewriteSystemsystemIdStartString="https://cdn.docbook.org/release/xsl/current/"rewritePrefix="./"/>
<rewriteURIuriStartString="https://cdn.docbook.org/release/xsl/snapshot/"rewritePrefix="./"/>
<rewriteSystemsystemIdStartString="https://cdn.docbook.org/release/xsl/snapshot/"rewritePrefix="./"/>
</catalog>
could be expanded to contain the old URI as well, like:
I also want to point out that in 1.79.2, the CDN URLs are http, not https. I don't know whether the URL matching cares about differences in protocol. If it does, then http CDN backward compatibility URLs are needed as well, now that the CDN URLs were changed to https.
In docbook-xsl 1.79.2, the system identifier was changed from
to
However, this was done in a backward-incompatible way. So now, in your customization layer or build system, you have to pick one of these URLs, and users who have a different docbook-xsl version installed locally will suffer, either because the stylesheets have to be fetched from a remote server, or the build will fail entirely.
This didn't use to be a real problem in practice because 1.79.2 saw very little adoption, but it's now trickling into various distributions and packagings, and it's becoming a real source of frequent build problems.
This should be fixed by making the supplied catalog files include backward-compatible mappings. For example, the currently built catalog file
could be expanded to contain the old URI as well, like:
The text was updated successfully, but these errors were encountered: