From: | "Karl O(dot) Pinc" <kop(at)karlpinc(dot)com> |
---|---|
To: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> |
Cc: | Greg Stark <stark(at)mit(dot)edu>, "Gregory Stark (as CFM)" <stark(dot)cfm(at)gmail(dot)com>, "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>, Daniel Gustafsson <daniel(at)yesql(dot)se>, w^3 <pgsql-www(at)lists(dot)postgresql(dot)org> |
Subject: | Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences |
Date: | 2023-03-20 20:20:38 |
Message-ID: | 20230320152038.3f68faaa@slate.karlpinc.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers 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(at)karlpinc(dot)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.
From | Date | Subject | |
---|---|---|---|
Next Message | Greg Stark | 2023-03-20 20:22:18 | Re: Commitfest 2023-03 starting tomorrow! |
Previous Message | Corey Huinker | 2023-03-20 20:19:04 | Re: Add SHELL_EXIT_CODE to psql |
From | Date | Subject | |
---|---|---|---|
Next Message | Célestin Matte | 2023-03-22 09:32:00 | Re: [PATCHES] pgarchives: merge schema.sql into Django's model |
Previous Message | Karl O. Pinc | 2023-03-20 17:32:19 | Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences |