Skip site navigation (1) Skip section navigation (2)

Re: DocBook V4.2

From: Rod Taylor <rbt(at)rbt(dot)ca>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: PostgreSQL Docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: DocBook V4.2
Date: 2003-06-16 15:16:44
Message-ID: 1055776603.92447.20.camel@jester (view raw or flat)
Thread:
Lists: pgsql-docs
> 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(at)rbt(dot)ca>

PGP Key: http://www.rbt.ca/rbtpub.asc

In response to

Responses

pgsql-docs by date

Next:From: Tom LaneDate: 2003-06-16 15:35:00
Subject: Re: DocBook V4.2
Previous:From: Peter EisentrautDate: 2003-06-16 14:51:29
Subject: DocBook V4.2

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group