Re: DocBook 5.2

From: Peter Eisentraut <peter(at)eisentraut(dot)org>
To: Jürgen Purtz <juergen(at)purtz(dot)de>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Cc: Thomas Schraitle <tom_schr(at)web(dot)de>
Subject: Re: DocBook 5.2
Date: 2024-09-11 09:47:58
Message-ID: e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 06.09.24 10:50, Jürgen Purtz wrote:
> For the PG community I would like to raise the question: Do we need
> DocBook in the distro of any operating system? In the past we developed
> some stylesheets to adopt DocBook to our needs. They are part of PG's
> distro and refer to the standard with statements like <xsl:import
> href="http://docbook.sourceforge.net/release/xsl/current/xxxx/docbook.xsl"/>. With the migration to db5.x the links change to <xsl:import href="http://cdn.docbook.org/release/xsl/1.79.2/xxxx/docbook.xsl"/>. Hence we don't need any additional local stylesheet outside of our own distro. Concerning DTD/schema/relax-ng: In db5.2 there is no DTD nor a XML-schema, for validation we need only the Relax-NG file 'docbook.rng'. This file is available at https://docs.oasis-open.org/docbook/docbook/v5.2/os/rng/docbook.rng (during the conversion-process I used a local copy).
>
> I assume we don't need any operating system distro of DocBook. Please
> correct me, if I'm wrong.

Note that we run xsltproc with the --nonet option. So stylesheet and
schema need to be available as local files. Downloading these
on-the-fly during the build process has been found to be unreliable, and
it's also not sound software supply chain hygiene.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2024-09-11 09:53:13 Re: Documentation improvement patch
Previous Message Michael Paquier 2024-09-11 06:37:17 Re: Undocumented optionality of handler_statements