Re: JonAS project would like to emulate our interactive docs

From: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>
To: "Dave Page" <dpage(at)vale-housing(dot)co(dot)uk>
Cc: "Tom Lane" <tgl(at)sss(dot)pgh(dot)pa(dot)us>, <pgsql-www(at)postgresql(dot)org>, <Gerard(dot)Vandome(at)objectweb(dot)org>, <fnasser(at)redhat(dot)com>
Subject: Re: JonAS project would like to emulate our interactive docs
Date: 2005-02-14 19:00:33
Message-ID: 200502141400.34018.xzilla@users.sourceforge.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

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

In response to

Browse pgsql-www by date

  From Date Subject
Next Message Josh Berkus 2005-02-14 23:13:30 Two PWN Files
Previous Message Dave Page 2005-02-14 16:24:12 Re: JonAS project would like to emulate our interactive docs