public inbox for [email protected]
help / color / mirror / Atom feedFrom: Rod Taylor <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: Josh Berkus <[email protected]>
Cc: PostgreSQL Docs <[email protected]>
Subject: Re: Need help with SGML again
Date: Wed, 15 Oct 2003 09:51:45 -0400
Message-ID: <1066225904.47010.14.camel@jester> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
> > Any thoughts on replacing Docbook with something else, someday?
>
> 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
outside the text editor, webbrowser, and diff.
Attachments:
[application/pgp-signature] signature.asc (187B, 2-signature.asc)
download
view thread (17+ messages) latest in thread
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: [email protected]
Cc: [email protected], [email protected], [email protected]
Subject: Re: Need help with SGML again
In-Reply-To: <1066225904.47010.14.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 agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox