Subject: Re: Need help with SGML again
From: Rod Taylor <rbt@rbt.ca>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: Josh Berkus <josh@agliodbs.com>,
	PostgreSQL Docs <pgsql-docs@postgresql.org>
In-Reply-To: <Pine.LNX.4.44.0310150914440.20107-100000@peter.localdomain>
References: <Pine.LNX.4.44.0310150914440.20107-100000@peter.localdomain>
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature";
	boundary="=-bx8Y4IsfCmCWfdp60J1t"
Message-Id: <1066225904.47010.14.camel@jester>
Mime-Version: 1.0
Date: Wed, 15 Oct 2003 09:51:45 -0400

--=-bx8Y4IsfCmCWfdp60J1t
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

> > Any thoughts on replacing Docbook with something else, someday?
>=20
> I don't see anything better arising.

Neither do I, but our particular use of docbook is far from the easiest
to work with.

There are many tools which can give a nicer working environment for
editing docbook based documents, but I've yet to find one which fits in
with the PostgreSQL configuration.

Perhaps you could suggest a toolset which can work with our docs and
hide the syntax from the user and give a 1st approximation of what the
final document would look like (without installing tons of tools -- many
of which are difficult to find in non-unix environments).  This would be
much appreciated.

Recently, I've been using Openoffice for a first cut and Conglomerate to
clean the document up. Of course, that uses a strict XML version and I
normally prefer xincludes to entity based includes.

With xincludes, each document is valid individually, as such can be
rendered individually.  You don't need to process the full book to see
what the 2 new paragraphs in section N.n will look like.  Throw an XML
transform at the top for Internet Explorer and you don't need any tools=20
outside the text editor, webbrowser, and diff.

--=-bx8Y4IsfCmCWfdp60J1t
Content-Type: application/pgp-signature; name=signature.asc
Content-Description: This is a digitally signed message part

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (FreeBSD)

iD8DBQA/jVDw6DETLow6vwwRAlW9AJwLijMelbhgNf3byzeqoY1qpk9r/QCdHZPd
ggCZmEDyq+SWFkoD16kS5xo=
=LMMT
-----END PGP SIGNATURE-----

--=-bx8Y4IsfCmCWfdp60J1t--