Re: [PHP-DOC] XML-Version of FAQ From: Stefan Livieratos (stefan <email protected>)
Date: 06/29/00

----- Original Message -----
From: Hartmut Holzgraefe <hartmut <email protected>>
To: Stefan Livieratos <stefan <email protected>>
Cc: <phpdoc <email protected>>
Sent: Thursday, June 29, 2000 11:28 AM
Subject: Re: [PHP-DOC] XML-Version of FAQ

> Stefan Livieratos wrote:
> > I converted the HTML version of the FAQ page into well-formed
> > XML and wrote an XSLT stylesheet for automatically numbering the
> > sections and the questions. I converted the XML version into HTML
> > with Xalan-J (http://xml.apache.org/xalan).
>
> > I have attached the XML document, the XSLT stylesheet and the
> > resulting HTML page for you to look through. If nobody objects
> > I would like to commit the files to phpweb.
>
> two things about this:
>
> 1) i think this deserves a 'phpfaq' CVS repository of its own
>
> 2) what about using docbook xml and dsssl as in phpdoc project
> instead of introducing another bunch of tools and concepts?

Well, I did this primarily as an exercise for building XSLT stylesheets.
What I like about XSLT is that I can browse the result of the
transformation with IE 5.0 and check it immediately.
I also thought that a simple XML structure of the FAQ XML document
(which I borrowed from the Cocoon project) is better because people
would rather contribute.
I don't mind if you want to convert the FAQ to docbook but quite
frankly I think it's an overkill.

Regards,
Stefan