Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences - Mailing list pgsql-www

From Karl O. Pinc
Subject Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Date
Msg-id 20230320152038.3f68faaa@slate.karlpinc.com
Whole thread Raw
In response to Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences  ("Karl O. Pinc" <kop@karlpinc.com>)
Responses Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences  ("Karl O. Pinc" <kop@karlpinc.com>)
List pgsql-www
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.



pgsql-www by date:

Previous
From: "Karl O. Pinc"
Date:
Subject: Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Next
From: Célestin Matte
Date:
Subject: Re: [PATCHES] pgarchives: merge schema.sql into Django's model