pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedFrom: Peter Eisentraut <peter@eisentraut.org>
To: Jürgen Purtz <juergen@purtz.de>
To: Pg Docs <pgsql-docs@lists.postgresql.org>
Cc: Thomas Schraitle <tom_schr@web.de>
Subject: Re: DocBook 5.2
Date: Wed, 11 Sep 2024 11:47:58 +0200
Message-ID: <e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org> (raw)
In-Reply-To: <2595a346-1dc3-486a-8eab-04be064fe9c0@purtz.de>
References: <ae14eca5-f57c-2db2-42ce-258bab3c6806@purtz.de>
<20220905111508.wzgmpbcarxizdnin@alvherre.pgsql>
<YzIY/OCgljTdqOgX@momjian.us>
<3524032.1664228552@sss.pgh.pa.us>
<YzJfBb+79/gW0d5y@momjian.us>
<3d846208-ff49-5a23-1684-a2e00a14496b@purtz.de>
<88e50ac0-4097-42cb-a04c-ff91270b263a@purtz.de>
<79ff1cda-df66-456a-a125-c2a6ed3ba356@purtz.de>
<2019879.1725566465@sss.pgh.pa.us>
<2595a346-1dc3-486a-8eab-04be064fe9c0@purtz.de>
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.
view thread (19+ messages)
Message-ID: <e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org>
Permalink: ../e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org/
Also on: postgresql.org/message-id/e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org
reply
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-docs@postgresql.org
Cc: peter@eisentraut.org, juergen@purtz.de, pgsql-docs@lists.postgresql.org, tom_schr@web.de
Subject: Re: DocBook 5.2
In-Reply-To: <e537eb95-752e-4e23-bf07-598a2858b85a@eisentraut.org>
* 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