From: Karl O. Pinc <kop@karlpinc.com>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Greg Stark <stark@mit.edu>
Cc: Gregory Stark (as CFM) <stark.cfm@gmail.com>
Cc: Jonathan S. Katz <jkatz@postgresql.org>
Cc: Daniel Gustafsson <daniel@yesql.se>
Cc: w^3 <pgsql-www@lists.postgresql.org>
Subject: Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Date: Mon, 20 Mar 2023 15:20:38 -0500
Message-ID: <20230320152038.3f68faaa@slate.karlpinc.com> (raw)
In-Reply-To: <20230320123219.780608bd@slate.karlpinc.com>
References: <20230315085521.1455aeb1@slate.karlpinc.com>
<20230320131645.inollxuj6zc7pqsq@alvherre.pgsql>
<20230320123219.780608bd@slate.karlpinc.com>
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.
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-hackers@postgresql.org
Cc: kop@karlpinc.com, alvherre@alvh.no-ip.org, stark@mit.edu, stark.cfm@gmail.com, jkatz@postgresql.org, daniel@yesql.se, pgsql-www@lists.postgresql.org
Subject: Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
In-Reply-To: <20230320152038.3f68faaa@slate.karlpinc.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox