Re: JonAS project would like to emulate our interactive docs

On Monday 14 February 2005 11:24, Dave Page wrote:
> > -----Original Message-----
> > From: pgsql-www-owner(at)postgresql(dot)org
> > [mailto:pgsql-www-owner(at)postgresql(dot)org] On Behalf Of Tom Lane
> > Sent: 14 February 2005 16:09
> > To: pgsql-www(at)postgresql(dot)org
> > Subject: [pgsql-www] JonAS project would like to emulate our
> > interactive docs
> >
> > So ... they'd like to know what software are we using to drive that?
> >
> > regards, tom lane
> >
> > ------- Forwarded Message
> >
> > Subject: Re: [jonas-redhat] PostgreSQL: Documentation: Manuals:
> > PostgreSQL 7.4: PostgreSQL 7.4.6 Documentation
> > Date: Mon, 14 Feb 2005 10:11:07 +0100
> > From: Gérard Vandome <Gerard(dot)Vandome(at)objectweb(dot)org>
> > To: Fernando Nasser <fnasser(at)redhat(dot)com>
> > CC: FRANCOIS EXERTIER <Francois(dot)Exertier(at)bull(dot)net>
> > References: <420B774E(dot)5080003(at)redhat(dot)com>
> >
> > Fernando Nasser wrote:
> > > As promised, here is an example of the interactive
> >
> > documentation used
> >
> > > by the PostgreSQL community.
> > >
> > >
> > > <http://www.postgresql.org/docs/7.4/interactive/index.html>
> >
> > The comment part is nice. Do you know which tool they are using?
> > Do you think we can provide such interactive documentation
> > with docbook?
>
> It's all homegrown and very site specific I'm afraid, but the code is
> available in CVS if you want to take a look:
>
> Script and program to cleanup the HTML and load it into the database:
> http://gborg.postgresql.org/project/pgweb/cvs/cvs.php/portal/tools/docs
>
> Page generation:
> http://gborg.postgresql.org/project/pgweb/cvs/co.php/portal/system/docs.php
>?r=1.11
>
> Submission handling (for various forms):
> http://gborg.postgresql.org/project/pgweb/cvs/co.php/portal/system/handlefo
>rm.php?r=1.16
>
> Note that the latter 2 rely heavily on the Pear template code we use.
>

You can take a look in the old www module for some non-pear ways to do this as
well. PHP.net aslo does something similar too although theres uses a more
xml oriented approach though it only handles one version of docs at a time
iirc. hth.

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL