Content-Type: multipart/mixed; boundary="------------DLyM2qkXjiyLI5MoZrGAWgP0"
Message-ID: <672a27ae-0d77-2b28-62ea-83c9ccf2b424@gmail.com>
Date: Thu, 25 Apr 2024 23:00:00 +0300
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.4.2
Subject: Re: nested <a> tags in glossary entries in html docs
To: Alvaro Herrera <alvherre@alvh.no-ip.org>, Erik Wienhold <ewie@ewie.name>
Cc: Anton Voloshin <a.voloshin@postgrespro.ru>,
 pgsql-docs <pgsql-docs@lists.postgresql.org>
References: <202404250924.wg5n655fdbar@alvherre.pgsql>
From: Alexander Lakhin <exclusion@gmail.com>
Content-Language: en-US
In-Reply-To: <202404250924.wg5n655fdbar@alvherre.pgsql>
Archived-At: 
 <https://www.postgresql.org/message-id/672a27ae-0d77-2b28-62ea-83c9ccf2b424%40gmail.com>
Precedence: bulk

This is a multi-part message in MIME format.
--------------DLyM2qkXjiyLI5MoZrGAWgP0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

Hello,

25.04.2024 12:24, Alvaro Herrera wrote:
> On 2024-Apr-12, Erik Wienhold wrote:
>
>> There's this bug[1] in the DocBook XSLT stylesheets.  Looks like the
>> fix[2] landed in 1.79.2 (latest version on Arch,
> Maybe one of these days we should get going with the migration to
> Docbook 5.x that Jürgen Purtz proposed.
>
> https://postgr.es/m/21ed3fd9-9020-4b53-b04f-a08a831b6085@purtz.de
>
> In the meantime, if anyone wants to suggest a XSLT patch to carry in our
> local definition, we could try that.

Please try the attached patch, which adds <xsl:template match="glossterm"
name="glossterm">, borrowed from /usr/share/xml/docbook/stylesheet/
docbook-xsl/xhtml/inline.xsl (I have docbook-xsl 1.79.2 installed), to our
local stylesheet-html-common.xsl.

I applied the modification from [1] (in two places) and it looks like the
nested <a> issue is gone.

[1] https://github.com/docbook/xslt10-stylesheets/pull/72/commits/62144252364492aecd71a3c8d5e6e1624af84785

Best regards,
Alexander
--------------DLyM2qkXjiyLI5MoZrGAWgP0
Content-Type: text/x-patch; charset=UTF-8;
 name="fix-bad-nested-anchor-elements-for-glossterm.patch"
Content-Disposition: attachment;
 filename="fix-bad-nested-anchor-elements-for-glossterm.patch"
Content-Transfer-Encoding: base64

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9zdHlsZXNoZWV0LWh0bWwtY29tbW9uLnhzbCBi
L2RvYy9zcmMvc2dtbC9zdHlsZXNoZWV0LWh0bWwtY29tbW9uLnhzbAppbmRleCA5ZGNmOTZj
MDJlLi42NDFhMzg0ODEyIDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvc3R5bGVzaGVldC1o
dG1sLWNvbW1vbi54c2wKKysrIGIvZG9jL3NyYy9zZ21sL3N0eWxlc2hlZXQtaHRtbC1jb21t
b24ueHNsCkBAIC02NzQsNCArNjc0LDE2MyBAQCBzZXQgICAgICAgdG9jLHRpdGxlCiAgIDwv
eHNsOmZvci1lYWNoPgogPC94c2w6dGVtcGxhdGU+CiAKKzx4c2w6dGVtcGxhdGUgbWF0Y2g9
Imdsb3NzdGVybSIgbmFtZT0iZ2xvc3N0ZXJtIj4KKyAgPHhzbDpwYXJhbSBuYW1lPSJmaXJz
dHRlcm0iIHNlbGVjdD0iMCIvPgorCisgIDwhLS0gVG8gYXZvaWQgZXh0cmEgPGEgbmFtZT0i
Ij4gYW5jaG9yIGZyb20gaW5saW5lLml0YWxpY3NlcSAtLT4KKyAgPHhzbDp2YXJpYWJsZSBu
YW1lPSJjb250ZW50Ij4KKyAgICA8eHNsOmFwcGx5LXRlbXBsYXRlcy8+CisgIDwveHNsOnZh
cmlhYmxlPgorCisgIDx4c2w6Y2hvb3NlPgorICAgIDx4c2w6d2hlbiB0ZXN0PSIoJGZpcnN0
dGVybS5vbmx5LmxpbmsgPSAwIG9yICRmaXJzdHRlcm0gPSAxKSBhbmQgQGxpbmtlbmQiPgor
ICAgICAgPHhzbDp2YXJpYWJsZSBuYW1lPSJ0YXJnZXRzIiBzZWxlY3Q9ImtleSgnaWQnLEBs
aW5rZW5kKSIvPgorICAgICAgPHhzbDp2YXJpYWJsZSBuYW1lPSJ0YXJnZXQiIHNlbGVjdD0i
JHRhcmdldHNbMV0iLz4KKworICAgICAgPHhzbDpjYWxsLXRlbXBsYXRlIG5hbWU9ImNoZWNr
LmlkLnVuaXF1ZSI+CisgICAgICAgIDx4c2w6d2l0aC1wYXJhbSBuYW1lPSJsaW5rZW5kIiBz
ZWxlY3Q9IkBsaW5rZW5kIi8+CisgICAgICA8L3hzbDpjYWxsLXRlbXBsYXRlPgorCisgICAg
ICA8eHNsOmNob29zZT4KKyAgICAgICAgPHhzbDp3aGVuIHRlc3Q9IiR0YXJnZXQiPgorICAg
ICAgICAgIDxhPgorICAgICAgICAgICAgPHhzbDphcHBseS10ZW1wbGF0ZXMgc2VsZWN0PSIu
IiBtb2RlPSJjb21tb24uaHRtbC5hdHRyaWJ1dGVzIi8+CisKKyAgICAgICAgICAgIDx4c2w6
YXR0cmlidXRlIG5hbWU9ImhyZWYiPgorICAgICAgICAgICAgICA8eHNsOmNhbGwtdGVtcGxh
dGUgbmFtZT0iaHJlZi50YXJnZXQiPgorICAgICAgICAgICAgICAgIDx4c2w6d2l0aC1wYXJh
bSBuYW1lPSJvYmplY3QiIHNlbGVjdD0iJHRhcmdldCIvPgorICAgICAgICAgICAgICA8L3hz
bDpjYWxsLXRlbXBsYXRlPgorICAgICAgICAgICAgPC94c2w6YXR0cmlidXRlPgorCisgICAg
ICAgICAgICA8eHNsOmNhbGwtdGVtcGxhdGUgbmFtZT0iaW5saW5lLml0YWxpY3NlcSI+Cisg
ICAgICAgICAgICAgIDx4c2w6d2l0aC1wYXJhbSBuYW1lPSJjb250ZW50d2l0aGxpbmsiIHNl
bGVjdD0iJGNvbnRlbnQiLz4KKyAgICAgICAgICAgIDwveHNsOmNhbGwtdGVtcGxhdGU+Cisg
ICAgICAgICAgPC9hPgorICAgICAgICA8L3hzbDp3aGVuPgorICAgICAgICA8eHNsOm90aGVy
d2lzZT4KKyAgICAgICAgICA8eHNsOmNhbGwtdGVtcGxhdGUgbmFtZT0iaW5saW5lLml0YWxp
Y3NlcSI+CisgICAgICAgICAgICA8eHNsOndpdGgtcGFyYW0gbmFtZT0iY29udGVudCIgc2Vs
ZWN0PSIkY29udGVudCIvPgorICAgICAgICAgIDwveHNsOmNhbGwtdGVtcGxhdGU+CisgICAg
ICAgIDwveHNsOm90aGVyd2lzZT4KKyAgICAgIDwveHNsOmNob29zZT4KKyAgICA8L3hzbDp3
aGVuPgorCisgICAgPHhzbDp3aGVuIHRlc3Q9Im5vdChAbGlua2VuZCkgICAgICAgICAgICAg
ICAgICAgICBhbmQgKCRmaXJzdHRlcm0ub25seS5saW5rID0gMCBvciAkZmlyc3R0ZXJtID0g
MSkgICAgICAgICAgICAgICAgICAgICBhbmQgKCRnbG9zc3Rlcm0uYXV0by5saW5rICE9IDAp
ICAgICAgICAgICAgICAgICAgICAgYW5kICRnbG9zc2FyeS5jb2xsZWN0aW9uICE9ICcnIj4K
KyAgICAgIDx4c2w6dmFyaWFibGUgbmFtZT0idGVybSI+CisgICAgICAgIDx4c2w6Y2hvb3Nl
PgorICAgICAgICAgIDx4c2w6d2hlbiB0ZXN0PSJAYmFzZWZvcm0iPjx4c2w6dmFsdWUtb2Yg
c2VsZWN0PSJAYmFzZWZvcm0iLz48L3hzbDp3aGVuPgorICAgICAgICAgIDx4c2w6b3RoZXJ3
aXNlPjx4c2w6dmFsdWUtb2Ygc2VsZWN0PSIuIi8+PC94c2w6b3RoZXJ3aXNlPgorICAgICAg
ICA8L3hzbDpjaG9vc2U+CisgICAgICA8L3hzbDp2YXJpYWJsZT4KKworICAgICAgPHhzbDp2
YXJpYWJsZSBuYW1lPSJjdGVybSIgc2VsZWN0PSIoZG9jdW1lbnQoJGdsb3NzYXJ5LmNvbGxl
Y3Rpb24sLikvL2dsb3NzZW50cnlbZ2xvc3N0ZXJtPSR0ZXJtXSlbMV0iLz4KKworICAgICAg
PCEtLSBIQUNLIEhBQ0sgSEFDSyEgQnV0IGl0IHdvcmtzLi4uIC0tPgorICAgICAgPCEtLSBZ
b3UnZCBuZWVkIHRvIGRvIG1vcmUgd29yayBpZiB5b3Ugd2FudGVkIHRvIGNodW5rIG9uIGds
b3NzZGl2LCB0aG91Z2ggLS0+CisKKyAgICAgIDx4c2w6dmFyaWFibGUgbmFtZT0iZ2xvc3Nh
cnkiIHNlbGVjdD0iLy9nbG9zc2FyeVtAcm9sZT0nYXV0byddIi8+CisKKyAgICAgIDx4c2w6
aWYgdGVzdD0iY291bnQoJGdsb3NzYXJ5KSAhPSAxIj4KKyAgICAgICAgPHhzbDptZXNzYWdl
PgorICAgICAgICAgIDx4c2w6dGV4dD5XYXJuaW5nOiBnbG9zc2FyeS5jb2xsZWN0aW9uIHNw
ZWNpZmllZCwgYnV0IHRoZXJlIGFyZSA8L3hzbDp0ZXh0PgorICAgICAgICAgIDx4c2w6dmFs
dWUtb2Ygc2VsZWN0PSJjb3VudCgkZ2xvc3NhcnkpIi8+CisgICAgICAgICAgPHhzbDp0ZXh0
PiBhdXRvbWF0aWMgZ2xvc3NhcmllczwveHNsOnRleHQ+CisgICAgICAgIDwveHNsOm1lc3Nh
Z2U+CisgICAgICA8L3hzbDppZj4KKworICAgICAgPHhzbDp2YXJpYWJsZSBuYW1lPSJnbG9z
c2NodW5rIj4KKyAgICAgICAgPHhzbDpjYWxsLXRlbXBsYXRlIG5hbWU9ImhyZWYudGFyZ2V0
Ij4KKyAgICAgICAgICA8eHNsOndpdGgtcGFyYW0gbmFtZT0ib2JqZWN0IiBzZWxlY3Q9IiRn
bG9zc2FyeSIvPgorICAgICAgICA8L3hzbDpjYWxsLXRlbXBsYXRlPgorICAgICAgPC94c2w6
dmFyaWFibGU+CisKKyAgICAgIDx4c2w6dmFyaWFibGUgbmFtZT0iY2h1bmtiYXNlIj4KKyAg
ICAgICAgPHhzbDpjaG9vc2U+CisgICAgICAgICAgPHhzbDp3aGVuIHRlc3Q9ImNvbnRhaW5z
KCRnbG9zc2NodW5rLCAnIycpIj4KKyAgICAgICAgICAgIDx4c2w6dmFsdWUtb2Ygc2VsZWN0
PSJzdWJzdHJpbmctYmVmb3JlKCRnbG9zc2NodW5rLCAnIycpIi8+CisgICAgICAgICAgPC94
c2w6d2hlbj4KKyAgICAgICAgICA8eHNsOm90aGVyd2lzZT4KKyAgICAgICAgICAgIDx4c2w6
dmFsdWUtb2Ygc2VsZWN0PSIkZ2xvc3NjaHVuayIvPgorICAgICAgICAgIDwveHNsOm90aGVy
d2lzZT4KKyAgICAgICAgPC94c2w6Y2hvb3NlPgorICAgICAgPC94c2w6dmFyaWFibGU+CisK
KyAgICAgIDx4c2w6Y2hvb3NlPgorICAgICAgICA8eHNsOndoZW4gdGVzdD0ibm90KCRjdGVy
bSkiPgorICAgICAgICAgIDx4c2w6bWVzc2FnZT4KKyAgICAgICAgICAgIDx4c2w6dGV4dD5U
aGVyZSdzIG5vIGVudHJ5IGZvciA8L3hzbDp0ZXh0PgorICAgICAgICAgICAgPHhzbDp2YWx1
ZS1vZiBzZWxlY3Q9IiR0ZXJtIi8+CisgICAgICAgICAgICA8eHNsOnRleHQ+IGluIDwveHNs
OnRleHQ+CisgICAgICAgICAgICA8eHNsOnZhbHVlLW9mIHNlbGVjdD0iJGdsb3NzYXJ5LmNv
bGxlY3Rpb24iLz4KKyAgICAgICAgICA8L3hzbDptZXNzYWdlPgorICAgICAgICAgIDx4c2w6
Y2FsbC10ZW1wbGF0ZSBuYW1lPSJpbmxpbmUuaXRhbGljc2VxIi8+CisgICAgICAgIDwveHNs
OndoZW4+CisgICAgICAgIDx4c2w6b3RoZXJ3aXNlPgorICAgICAgICAgIDx4c2w6dmFyaWFi
bGUgbmFtZT0iaWQiPgorICAgICAgICAgICAgPHhzbDpjYWxsLXRlbXBsYXRlIG5hbWU9Im9i
amVjdC5pZCI+CisgICAgICAgICAgICAgIDx4c2w6d2l0aC1wYXJhbSBuYW1lPSJvYmplY3Qi
IHNlbGVjdD0iJGN0ZXJtIi8+CisgICAgICAgICAgICA8L3hzbDpjYWxsLXRlbXBsYXRlPgor
ICAgICAgICAgIDwveHNsOnZhcmlhYmxlPgorICAgICAgICAgIDxhIGhyZWY9InskY2h1bmti
YXNlfSN7JGlkfSI+CisgICAgICAgICAgICA8eHNsOmFwcGx5LXRlbXBsYXRlcyBzZWxlY3Q9
Ii4iIG1vZGU9ImNvbW1vbi5odG1sLmF0dHJpYnV0ZXMiLz4KKyAgICAgICAgICAgIDx4c2w6
Y2FsbC10ZW1wbGF0ZSBuYW1lPSJpbmxpbmUuaXRhbGljc2VxIj4KKyAgICAgICAgICAgICAg
PHhzbDp3aXRoLXBhcmFtIG5hbWU9ImNvbnRlbnQiIHNlbGVjdD0iJGNvbnRlbnQiLz4KKyAg
ICAgICAgICAgIDwveHNsOmNhbGwtdGVtcGxhdGU+CisgICAgICAgICAgPC9hPgorICAgICAg
ICA8L3hzbDpvdGhlcndpc2U+CisgICAgICA8L3hzbDpjaG9vc2U+CisgICAgPC94c2w6d2hl
bj4KKworICAgIDx4c2w6d2hlbiB0ZXN0PSJub3QoQGxpbmtlbmQpICAgICAgICAgICAgICAg
ICAgICAgYW5kICgkZmlyc3R0ZXJtLm9ubHkubGluayA9IDAgb3IgJGZpcnN0dGVybSA9IDEp
ICAgICAgICAgICAgICAgICAgICAgYW5kICRnbG9zc3Rlcm0uYXV0by5saW5rICE9IDAiPgor
ICAgICAgPHhzbDp2YXJpYWJsZSBuYW1lPSJ0ZXJtIj4KKyAgICAgICAgPHhzbDpjaG9vc2U+
CisgICAgICAgICAgPHhzbDp3aGVuIHRlc3Q9IkBiYXNlZm9ybSI+CisgICAgICAgICAgICA8
eHNsOnZhbHVlLW9mIHNlbGVjdD0ibm9ybWFsaXplLXNwYWNlKEBiYXNlZm9ybSkiLz4KKyAg
ICAgICAgICA8L3hzbDp3aGVuPgorICAgICAgICAgIDx4c2w6b3RoZXJ3aXNlPgorICAgICAg
ICAgICAgPHhzbDp2YWx1ZS1vZiBzZWxlY3Q9Im5vcm1hbGl6ZS1zcGFjZSguKSIvPgorICAg
ICAgICAgIDwveHNsOm90aGVyd2lzZT4KKyAgICAgICAgPC94c2w6Y2hvb3NlPgorICAgICAg
PC94c2w6dmFyaWFibGU+CisgICAgICA8eHNsOnZhcmlhYmxlIG5hbWU9InRhcmdldHMiIHNl
bGVjdD0ia2V5KCdnbG9zc2VudHJpZXMnLCAkdGVybSkiLz4KKyAgICAgIDx4c2w6dmFyaWFi
bGUgbmFtZT0idGFyZ2V0IiBzZWxlY3Q9IiR0YXJnZXRzWzFdIi8+CisKKyAgICAgIDx4c2w6
Y2hvb3NlPgorICAgICAgICA8eHNsOndoZW4gdGVzdD0iY291bnQoJHRhcmdldHMpPTAiPgor
ICAgICAgICAgIDx4c2w6bWVzc2FnZT4KKyAgICAgICAgICAgIDx4c2w6dGV4dD5FcnJvcjog
bm8gZ2xvc3NlbnRyeSBmb3IgZ2xvc3N0ZXJtOiA8L3hzbDp0ZXh0PgorICAgICAgICAgICAg
PHhzbDp2YWx1ZS1vZiBzZWxlY3Q9Ii4iLz4KKyAgICAgICAgICAgIDx4c2w6dGV4dD4uPC94
c2w6dGV4dD4KKyAgICAgICAgICA8L3hzbDptZXNzYWdlPgorICAgICAgICAgIDx4c2w6Y2Fs
bC10ZW1wbGF0ZSBuYW1lPSJpbmxpbmUuaXRhbGljc2VxIi8+CisgICAgICAgIDwveHNsOndo
ZW4+CisgICAgICAgIDx4c2w6b3RoZXJ3aXNlPgorICAgICAgICAgIDxhPgorICAgICAgICAg
ICAgPHhzbDphcHBseS10ZW1wbGF0ZXMgc2VsZWN0PSIuIiBtb2RlPSJjb21tb24uaHRtbC5h
dHRyaWJ1dGVzIi8+CisgICAgICAgICAgICA8eHNsOmlmIHRlc3Q9IkBpZCBvciBAeG1sOmlk
Ij4KKyAgICAgICAgICAgICAgPHhzbDphdHRyaWJ1dGUgbmFtZT0iaWQiPgorICAgICAgICAg
ICAgICAgIDx4c2w6dmFsdWUtb2Ygc2VsZWN0PSIoQGlkfEB4bWw6aWQpWzFdIi8+CisgICAg
ICAgICAgICAgIDwveHNsOmF0dHJpYnV0ZT4KKyAgICAgICAgICAgIDwveHNsOmlmPgorCisg
ICAgICAgICAgICA8eHNsOmF0dHJpYnV0ZSBuYW1lPSJocmVmIj4KKyAgICAgICAgICAgICAg
PHhzbDpjYWxsLXRlbXBsYXRlIG5hbWU9ImhyZWYudGFyZ2V0Ij4KKyAgICAgICAgICAgICAg
ICA8eHNsOndpdGgtcGFyYW0gbmFtZT0ib2JqZWN0IiBzZWxlY3Q9IiR0YXJnZXQiLz4KKyAg
ICAgICAgICAgICAgPC94c2w6Y2FsbC10ZW1wbGF0ZT4KKyAgICAgICAgICAgIDwveHNsOmF0
dHJpYnV0ZT4KKworICAgICAgICAgICAgPHhzbDpjYWxsLXRlbXBsYXRlIG5hbWU9ImlubGlu
ZS5pdGFsaWNzZXEiPgorICAgICAgICAgICAgICA8eHNsOndpdGgtcGFyYW0gbmFtZT0iY29u
dGVudHdpdGhsaW5rIiBzZWxlY3Q9IiRjb250ZW50Ii8+CisgICAgICAgICAgICA8L3hzbDpj
YWxsLXRlbXBsYXRlPgorICAgICAgICAgIDwvYT4KKyAgICAgICAgPC94c2w6b3RoZXJ3aXNl
PgorICAgICAgPC94c2w6Y2hvb3NlPgorICAgIDwveHNsOndoZW4+CisKKyAgICA8eHNsOm90
aGVyd2lzZT4KKyAgICAgIDx4c2w6Y2FsbC10ZW1wbGF0ZSBuYW1lPSJpbmxpbmUuaXRhbGlj
c2VxIi8+CisgICAgPC94c2w6b3RoZXJ3aXNlPgorICA8L3hzbDpjaG9vc2U+Cis8L3hzbDp0
ZW1wbGF0ZT4KKwogPC94c2w6c3R5bGVzaGVldD4K

--------------DLyM2qkXjiyLI5MoZrGAWgP0--