From: Rod Taylor <rbt@rbt.ca>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: PostgreSQL Docs <pgsql-docs@postgresql.org>
Subject: Re: DocBook V4.2
Date: 16 Jun 2003 15:16:44 +0000
Message-ID: <1055776603.92447.20.camel@jester> (raw)
In-Reply-To: <Pine.LNX.4.44.0306161608450.2751-100000@peter.localdomain>
References: <Pine.LNX.4.44.0306161608450.2751-100000@peter.localdomain>
> We are now beginning to run into trouble with the established toolchain
> (particularly for print output), and there isn't much new development
> happening, so I'd like to start trying out XML-based toolchains. To do
> that, we need to move to a DocBook version that is available as both SGML
> (processed by OpenJade) and XML, which is the case for 4.x. We can
> convert SGML to XML automatically, so there are no syntax implications.
I've had good luck processing XML through both toolchains, and would
find it VERY useful if there was the ability to quickly pull in
PostgreSQL content into other in-house documents via an XMLInclude
rather than a hacked checkout, file munge, etc.
I vote for having valid XML in the system itself with each file having a
valid DTD specification.
This has the added benefit of allowing an XSL transform to function on a
single document fairly easily which enables people such as Josh who
don't normally write documentation to quickly validate their changes
with nothing but a webbrowser, a very short set of instructions, and the
URL to the docbook XSLs.
--
Rod Taylor <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.ascAttachments:
signature.asc (application/pgp-signature, 186B) download
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: rbt@rbt.ca, peter_e@gmx.net
Subject: Re: DocBook V4.2
In-Reply-To: <1055776603.92447.20.camel@jester>
* 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