Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Karl O. Pinc <kop@karlpinc.com>
From: "Karl O. Pinc" <kop@karlpinc.com>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Greg Stark <stark@mit.edu>, "Gregory Stark (as CFM)"
<stark.cfm@gmail.com>, "Jonathan S. Katz" <jkatz@postgresql.org>, Daniel
Gustafsson <daniel@yesql.se>, w^3 <pgsql-www@lists.postgresql.org>
Date: 2023-03-20T20:20:38Z
Lists: pgsql-hackers
Hi,
There seems to be a problem with the html generated
for the public-facing Postgresql docs.
I'm looking at the contrib page in the devel docs,
on the pg website:
https://www.postgresql.org/docs/devel/contrib.html
The simplelist holding the list of trusted extensions,
in doc/src/sgml/contrib.sgml, is inside the paragraph.
But when I look at the delivered html, I see the table
outside of the paragraph. And the vertical spacing
looks poor as a result.
Alvaro moved the simplelist into the paragraph to
fix just this problem.
Building HEAD (of master) on my computer (Debian 11.6)
what I see is the generation of two paragraphs,
one with the leading text and a second that contains
the simplelist table. (Er, why 2 paragraphs instead
of just one paragraph with both text and table in
it I can't say.)
The html built on my computer has vertical spacing
that looks good.
Could it be that the build system has out-of-date
docbook xslt? In any case, it looks like what's
produced for the world to see is different from what
Alvaro and I are seeing.
Regards,
Karl <kop@karlpinc.com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein
P.S. I don't know what html Alvero is generating,
but his looks good and what's on postgresql.org does
not look good. So I assume that he's getting something
different from what the public sees now.
Commits
-
Remove new <para id="contrib-obsolete">.
- 244ab8c00c42 16.0 landed
-
doc/PDF: Add page breaks for <sect1> in contrib appendix
- 30e9f2608adf 16.0 landed
-
doc: Add lists of modules trusted/obsolete
- a0137388cb64 16.0 landed
-
HTML docs: Add padding to table.simplelist for more readable output
- a7e584a7d68a 16.0 landed
-
Describe each contrib module in its SGML section title
- e86c8b728f3c 16.0 landed