Home > Archive > PHP Documentation > May 2006 > Re: [PHP-DOC] Re: [PHP-DEV] Summer of Code
You are viewing an archived Text-only version of the thread.
To view this thread in it's original format and/or if you want to reply to
this thread please [click here]
| Author |
Re: [PHP-DOC] Re: [PHP-DEV] Summer of Code
|
|
| Nuno Lopes 2006-05-04, 4:00 am |
| > On Wed, 3 May 2006, Philip Olson wrote:
>
> Yay! Basically we need anything to make livedocs able to replace the
> pregenerated php.net manuals entirely. That is the first target. Important
> to keep PHP 4 compatibilty, and rely on sqlite being available for the
> entities and other metadata. The search engine (Nuno's proposal to improve
> indexing) is not interesting for php.net, since it is going to use yahoo
> search as it is now (unless it is possible to make livedocs' search engine
> better, which should not be the first focus). Of course the search engine
> is vital if we aim to replace the CHM version with an easy to set up
> livedocs (which is another target, but one further away :).
>
> Goba
My proposal had nothing to do with the search engine. I still think that the
off-line tools of livedocs could use some help. They are magical and
shouldn't be (and way too phpdoc specific). My proposal was to make them
docbook generic (and probably porting them to one of the new xml extensions
of PHP 5).
BTW, we haven't received any livedocs proposal yet.
Nuno
| |
| Jared Williams 2006-05-04, 7:58 am |
|
> My proposal had nothing to do with the search engine. I still
> think that the off-line tools of livedocs could use some
> help. They are magical and shouldn't be (and way too phpdoc
> specific). My proposal was to make them docbook generic (and
> probably porting them to one of the new xml extensions of PHP 5).
> BTW, we haven't received any livedocs proposal yet.
Doesn't that require alterations to the docbook too. For instance <function> element is magical (and specific to phpdoc) in that it
also creates a link to the relevant functions' page, I believe?
Jared
| |
| Nuno Lopes 2006-05-07, 7:03 pm |
| >> My proposal had nothing to do with the search engine. I still
>
> Doesn't that require alterations to the docbook too. For instance
> <function> element is magical (and specific to phpdoc) in that it
> also creates a link to the relevant functions' page, I believe?
>
> Jared
Yep, of course we have done some customizations to the DSSSL/XSL sheets, but
as those languages allow a somewhat easy way to modify how things are
presented, livedocs should be extensible as well.
Nuno
|
|
|
|
|