Обсуждение: JonAS project would like to emulate our interactive docs

Поиск
Список
Период
Сортировка

JonAS project would like to emulate our interactive docs

От
Tom Lane
Дата:
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.Vandome@objectweb.org>
To: Fernando Nasser <fnasser@redhat.com>
CC: FRANCOIS EXERTIER <Francois.Exertier@bull.net>
References: <420B774E.5080003@redhat.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?

--
G�rard Vand�me                JOnAS Project Manager
Gerard.Vandome@objectweb.org        http://jonas.objectweb.org
Take action against software patents       http://swpat.ffii.org

------- End of Forwarded Message


Re: JonAS project would like to emulate our interactive docs

От
"Dave Page"
Дата:

> -----Original Message-----
> From: pgsql-www-owner@postgresql.org
> [mailto:pgsql-www-owner@postgresql.org] On Behalf Of Tom Lane
> Sent: 14 February 2005 16:09
> To: pgsql-www@postgresql.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.Vandome@objectweb.org>
> To: Fernando Nasser <fnasser@redhat.com>
> CC: FRANCOIS EXERTIER <Francois.Exertier@bull.net>
> References: <420B774E.5080003@redhat.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/handleform.php?r=1.16

Note that the latter 2 rely heavily on the Pear template code we use.

Regards, dave.

Re: JonAS project would like to emulate our interactive docs

От
Robert Treat
Дата:
On Monday 14 February 2005 11:24, Dave Page wrote:
> > -----Original Message-----
> > From: pgsql-www-owner@postgresql.org
> > [mailto:pgsql-www-owner@postgresql.org] On Behalf Of Tom Lane
> > Sent: 14 February 2005 16:09
> > To: pgsql-www@postgresql.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.Vandome@objectweb.org>
> > To: Fernando Nasser <fnasser@redhat.com>
> > CC: FRANCOIS EXERTIER <Francois.Exertier@bull.net>
> > References: <420B774E.5080003@redhat.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