[MASSMAIL]nested tags in glossary entries in html docs
От | Anton Voloshin |
---|---|
Тема | [MASSMAIL]nested tags in glossary entries in html docs |
Дата | |
Msg-id | 03ac3556-d47a-4022-9ea8-a9219272ea43@postgrespro.ru обсуждение исходный текст |
Ответы |
Re: nested tags in glossary entries in html docs
|
Список | pgsql-docs |
Hello, In REL_13_STABLE and above, generated HTML have a broken HTML: nested <a href="..."> tags for all links to glossary. Somehow, this results in duplicated <a> tags on the https://www.postgresql.org/docs/ Found by tab-navigating https://www.postgresql.org/docs/16/rowtypes.html where we see (spacing added to avoid line wraps): ... create a <a class="glossterm" href="glossary.html#GLOSSARY-DOMAIN"</a><a class="glossterm" href="glossary.html#GLOSSARY-DOMAIN" title="Domain">domain</a> over the composite type ... So, empty <a>, and then the real <a>. This resulted in stopping twice on the "domain" link (right before, and then on the "domain" word itself) while tab-navigating. If I am to "make html" docs from the source (in REL_13_STABLE..master), I see nested <a>'s instead: create a <a class="glossterm" href="glossary.html#GLOSSARY-DOMAIN"><em class="glossterm"><a class="glossterm" href="glossary.html#GLOSSARY-DOMAIN" title="Domain">domain</a></em></a> over the composite type I guess docs are processed additionally before getting to https://www.postgresql.org/docs/ (html sanitizer/beautifier?), in passing fixing nested <a>'s, but producing duplicated <a>'s instead. It seems to affect all glossary links: after "make html", grep '</a></em></a>' doc/src/sgml/html/*.html results in 254 to 329 matches (in versions 13 to master). REL_12_STABLE is not affected: glossary was only introduced in 13. It seems to have been introduced in commit 347d2b07fcc250680f75b5f89ba49d4805782c6b Author: Alvaro Herrera <alvherre@alvh.no-ip.org> Date: Fri Apr 3 19:23:20 2020 Add a glossary to the documentation Not sure about how to fix this (don't really know docbook). -- Anton Voloshin Postgres Professional, The Russian Postgres Company https://postgrespro.ru
В списке pgsql-docs по дате отправления: