pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedDocBook V4.2
10+ messages / 6 participants
[nested] [flat]
* DocBook V4.2
@ 2003-06-16 14:51 Peter Eisentraut <peter_e@gmx.net>
0 siblings, 4 replies; 10+ messages in thread
From: Peter Eisentraut @ 2003-06-16 14:51 UTC (permalink / raw)
To: pgsql-docs
We have planned several times to move to a new DocBook version, but always
postponed it. I'd like to get it done this time.
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.
Comments?
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-16 15:16 Rod Taylor <rbt@rbt.ca>
parent: Peter Eisentraut <peter_e@gmx.net>
3 siblings, 1 reply; 10+ messages in thread
From: Rod Taylor @ 2003-06-16 15:16 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: 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@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
signature.asc (application/pgp-signature, 186B) download
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-16 15:35 Tom Lane <tgl@sss.pgh.pa.us>
parent: Peter Eisentraut <peter_e@gmx.net>
3 siblings, 1 reply; 10+ messages in thread
From: Tom Lane @ 2003-06-16 15:35 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
Peter Eisentraut <peter_e@gmx.net> writes:
> We have planned several times to move to a new DocBook version, but always
> postponed it. I'd like to get it done this time.
> Comments?
What are the implications (ie, how much work will this take)?
regards, tom lane
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-16 21:24 The Hermit Hacker <scrappy@postgresql.org>
parent: Peter Eisentraut <peter_e@gmx.net>
3 siblings, 0 replies; 10+ messages in thread
From: The Hermit Hacker @ 2003-06-16 21:24 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
What do I need to install?
On Mon, 16 Jun 2003, Peter Eisentraut wrote:
> We have planned several times to move to a new DocBook version, but always
> postponed it. I'd like to get it done this time.
>
> 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.
>
> Comments?
>
> --
> Peter Eisentraut peter_e@gmx.net
>
>
> ---------------------------(end of broadcast)---------------------------
> TIP 5: Have you checked our extensive FAQ?
>
> http://www.postgresql.org/docs/faqs/FAQ.html
>
Marc G. Fournier ICQ#7615664 IRC Nick: Scrappy
Systems Administrator @ hub.org
primary: scrappy@hub.org secondary: scrappy@{freebsd|postgresql}.org
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-16 23:38 Bruce Momjian <pgman@candle.pha.pa.us>
parent: Guillaume LELARGE <gleu@wanadoo.fr>
0 siblings, 1 reply; 10+ messages in thread
From: Bruce Momjian @ 2003-06-16 23:38 UTC (permalink / raw)
To: Guillaume LELARGE <gleu@wanadoo.fr>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
Can we still do <tag>text</> or do we need to spell out the full close
tag with </tag>?
---------------------------------------------------------------------------
Guillaume LELARGE wrote:
> Le Lundi 16 Juin 2003 14:51, vous avez ?crit :
> > We have planned several times to move to a new DocBook version, but always
> > postponed it. I'd like to get it done this time.
> >
> > 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.
> >
> > Comments?
> I think it would be great news. XML Docbook is much easier to "read" and
> understand. For example, it is of great value to a translator. I've
> translated many howtos from the LDP and some guides. SGML Docbook is a good
> wey to format a document, but XML is a much better one. And it allows anyone
> to apply really simple xslt stylesheets with xsltproc (or saboltron or
> something else). Doing it with DSSSL stylesheets is really hard.
>
> I'm in the process to create a french translation team and would be really
> interested if all documents could be move to an XML docbook format. And I
> could help you, if you need, to speed up the move.
>
> By the way, if any french people here are interested in translating postgresql
> documents (manuals, faqs and techdocs) in french, please get in touch with
> me.
>
> Thanks.
>
>
> --
> Guillaume <!-- http://absfr.tuxfamily.org/ -->.
>
> ---------------------------(end of broadcast)---------------------------
> TIP 6: Have you searched our list archives?
>
> http://archives.postgresql.org
>
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-17 00:37 Guillaume LELARGE <gleu@wanadoo.fr>
parent: Peter Eisentraut <peter_e@gmx.net>
3 siblings, 1 reply; 10+ messages in thread
From: Guillaume LELARGE @ 2003-06-17 00:37 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
Le Lundi 16 Juin 2003 14:51, vous avez écrit :
> We have planned several times to move to a new DocBook version, but always
> postponed it. I'd like to get it done this time.
>
> 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.
>
> Comments?
I think it would be great news. XML Docbook is much easier to "read" and
understand. For example, it is of great value to a translator. I've
translated many howtos from the LDP and some guides. SGML Docbook is a good
wey to format a document, but XML is a much better one. And it allows anyone
to apply really simple xslt stylesheets with xsltproc (or saboltron or
something else). Doing it with DSSSL stylesheets is really hard.
I'm in the process to create a french translation team and would be really
interested if all documents could be move to an XML docbook format. And I
could help you, if you need, to speed up the move.
By the way, if any french people here are interested in translating postgresql
documents (manuals, faqs and techdocs) in french, please get in touch with
me.
Thanks.
--
Guillaume <!-- http://absfr.tuxfamily.org/ -->.
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-17 12:36 Peter Eisentraut <peter_e@gmx.net>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 10+ messages in thread
From: Peter Eisentraut @ 2003-06-17 12:36 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-docs
Tom Lane writes:
> What are the implications (ie, how much work will this take)?
The work (various markup adjustments) has already been posted as a patch
by someone else many moons ago, so I assume the work will be minimal.
Users will have to install a new DocBook package, which won't be too hard
if you already have 3.1 working.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-17 18:07 Peter Eisentraut <peter_e@gmx.net>
parent: Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 0 replies; 10+ messages in thread
From: Peter Eisentraut @ 2003-06-17 18:07 UTC (permalink / raw)
To: Bruce Momjian <pgman@candle.pha.pa.us>; +Cc: Guillaume LELARGE <gleu@wanadoo.fr>; pgsql-docs
Bruce Momjian writes:
> Can we still do <tag>text</> or do we need to spell out the full close
> tag with </tag>?
We're not converting the sources to XML (in which which case you would
need to spell out the tags), only allowing for automatic conversion from
SGML to XML.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-17 18:08 Peter Eisentraut <peter_e@gmx.net>
parent: Rod Taylor <rbt@rbt.ca>
0 siblings, 1 reply; 10+ messages in thread
From: Peter Eisentraut @ 2003-06-17 18:08 UTC (permalink / raw)
To: Rod Taylor <rbt@rbt.ca>; +Cc: pgsql-docs
Rod Taylor writes:
> I vote for having valid XML in the system itself with each file having a
> valid DTD specification.
This is impossible, unless you want to give up on linking.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: DocBook V4.2
@ 2003-06-17 19:13 Rod Taylor <rbt@rbt.ca>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 10+ messages in thread
From: Rod Taylor @ 2003-06-17 19:13 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On Tue, 2003-06-17 at 18:08, Peter Eisentraut wrote:
> Rod Taylor writes:
>
> > I vote for having valid XML in the system itself with each file having a
> > valid DTD specification.
>
> This is impossible, unless you want to give up on linking.
No, not give up on linking, but change the inclusions to be based on an
XML include format rather than ENTITY based inclusions.
Since XML includes are node based, you can include all content between
and including the top node or some sub-structure within the XML, DTDs
may be present within each file.
--
Rod Taylor <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
signature.asc (application/pgp-signature, 186B) download
^ permalink raw reply [nested|flat] 10+ messages in thread
end of thread, other threads:[~2003-06-17 19:13 UTC | newest]
Thread overview: 10+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2003-06-16 14:51 DocBook V4.2 Peter Eisentraut <peter_e@gmx.net>
2003-06-16 15:16 ` Rod Taylor <rbt@rbt.ca>
2003-06-17 18:08 ` Peter Eisentraut <peter_e@gmx.net>
2003-06-17 19:13 ` Rod Taylor <rbt@rbt.ca>
2003-06-16 15:35 ` Tom Lane <tgl@sss.pgh.pa.us>
2003-06-17 12:36 ` Peter Eisentraut <peter_e@gmx.net>
2003-06-16 21:24 ` The Hermit Hacker <scrappy@postgresql.org>
2003-06-17 00:37 ` Guillaume LELARGE <gleu@wanadoo.fr>
2003-06-16 23:38 ` Bruce Momjian <pgman@candle.pha.pa.us>
2003-06-17 18:07 ` Peter Eisentraut <peter_e@gmx.net>
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