| 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: | Whole Thread | Raw Message | 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 |